ó ÐH/\c@`sždZddlmZddlmZddlmZddlZddlmZddlmZdd gZ defd „ƒYZ d efd „ƒYZ dS( så Interfaces gevent uses that don't belong any one place. This is not a public module, these interfaces are not currently exposed to the public, they mostly exist for documentation and testing purposes. .. versionadded:: 1.3b2 i(tabsolute_import(tdivision(tprint_functionN(t Interface(t AttributetILooptIWatchercB`seZdZedƒZedƒZeed„Zd„Zd„Z d„Z e dd„Z de dd „Ze dd „Ze dd „Ze dd „Ze dd „Ze dd„Ze dd„Zejdkrêde d„Znde dd„Zd„ZRS(sl The common interface expected for all event loops. .. caution:: This is an internal, low-level interface. It may change between minor versions of gevent. .. rubric:: Watchers The methods that create event loop watchers are `io`, `timer`, `signal`, `idle`, `prepare`, `check`, `fork`, `async_`, `child`, `stat`. These all return various types of :class:`IWatcher`. All of those methods have one or two common arguments. *ref* is a boolean saying whether the event loop is allowed to exit even if this watcher is still started. *priority* is event loop specific. s3Boolean indicating whether this is the default loopsFloating point number of seconds giving (approximately) the minimum resolution of a timer (and hence the minimun value the sleep can sleep for). On libuv, this is fixed by the library, but on libev it is just a guess and the actual value is system dependent.cC`sdS(s! Run the event loop. This is usually called automatically by the hub greenlet, but in special cases (when the hub is *not* running) you can use this to control how the event loop runs (for example, to integrate it with another event loop). N((tnowaittonce((s1lib/python2.7/site-packages/gevent/_interfaces.pytrun9scC`sdS(s0 now() -> float Return the loop's notion of the current time. This may not necessarily be related to :func:`time.time` (it may have a different starting point), but it must be expressed in fractional seconds (the same *units* used by :func:`time.time`). N((((s1lib/python2.7/site-packages/gevent/_interfaces.pytnowCscC`sdS(sæ Update the loop's notion of the current time. .. versionadded:: 1.3 In the past, this available as ``update``. This is still available as an alias but will be removed in the future. N((((s1lib/python2.7/site-packages/gevent/_interfaces.pyt update_nowNscC`sdS(sÔ Clean up resources used by this loop. If you create loops (especially loops that are not the default) you *should* call this method when you are done with the loop. .. caution:: As an implementation note, the libev C loop implementation has a finalizer (``__del__``) that destroys the object, but the libuv and libev CFFI implementations do not. The C implementation may change. N((((s1lib/python2.7/site-packages/gevent/_interfaces.pytdestroyWscC`sdS(s¶ Create and return a new IO watcher for the given *fd*. *events* is a bitmask specifying which events to watch for. 1 means read, and 2 means write. N((tfdteventstreftpriority((s1lib/python2.7/site-packages/gevent/_interfaces.pytiogsgcC`sdS(s° Create and return a timer watcher that will fire after *after* seconds. If *repeat* is given, the timer will continue to fire every *repeat* seconds. N((taftertrepeatRR((s1lib/python2.7/site-packages/gevent/_interfaces.pyttimeroscC`sdS(s· Create and return a signal watcher for the signal *signum*, one of the constants defined in :mod:`signal`. This is platform and event loop specific. N((tsignumRR((s1lib/python2.7/site-packages/gevent/_interfaces.pytsignalvscC`sdS(sU Create and return a watcher that fires when the event loop is idle. N((RR((s1lib/python2.7/site-packages/gevent/_interfaces.pytidle~scC`sdS(s¡ Create and return a watcher that fires before the event loop polls for IO. .. caution:: This method is not supported by libuv. N((RR((s1lib/python2.7/site-packages/gevent/_interfaces.pytprepareƒscC`sdS(sc Create and return a watcher that fires after the event loop polls for IO. N((RR((s1lib/python2.7/site-packages/gevent/_interfaces.pytcheck‹scC`sdS(sb Create a watcher that fires when the process forks. Availability: POSIX N((RR((s1lib/python2.7/site-packages/gevent/_interfaces.pytfork‘scC`sdS(s‰ Create a watcher that fires when triggered, possibly from another thread. .. versionchanged:: 1.3 This was previously just named ``async``; for compatibility with Python 3.7 where ``async`` is a keyword it was renamed. On older versions of Python the old name is still around, but it will be removed in the future. N((RR((s1lib/python2.7/site-packages/gevent/_interfaces.pytasync_˜stwin32icC`sdS(s© Create a watcher that fires for events on the child with process ID *pid*. This is platform specific and not available on Windows. N((tpidttraceR((s1lib/python2.7/site-packages/gevent/_interfaces.pytchild¦scC`sdS(sÜ Create a watcher that monitors the filesystem item at *path*. If the operating system doesn't support event notifications from the filesystem, poll for changes every *interval* seconds. N((tpathtintervalRR((s1lib/python2.7/site-packages/gevent/_interfaces.pytstat­scG`sdS(s­ Run the *func* passing it *args* at the next opportune moment. This is a way of handing control to the event loop and deferring an action. N((tfunctargs((s1lib/python2.7/site-packages/gevent/_interfaces.pyt run_callbackµsN(t__name__t __module__t__doc__Rtdefaulttapprox_timer_resolutiontFalseR R R R tTruetNoneRRRRRRRRtsystplatformRR"R%(((s1lib/python2.7/site-packages/gevent/_interfaces.pyRs(    cB`s)eZdZd„Zd„Zd„ZRS(s  An event loop watcher. These objects call their *callback* function when the event loop detects the event has happened. .. important:: You *must* call :meth:`close` when you are done with this object to avoid leaking native resources. cO`sdS(s1 Have the event loop begin watching for this event. When the event is detected, *callback* will be called with *args*. .. caution:: Not all watchers accept ``**kwargs``, and some watchers define special meanings for certain keyword args. N((tcallbackR$tkwargs((s1lib/python2.7/site-packages/gevent/_interfaces.pytstartÈscC`sdS(s’ Have the event loop stop watching this event. In the future you may call :meth:`start` to begin watching again. N((((s1lib/python2.7/site-packages/gevent/_interfaces.pytstopÕscC`sdS(s Dispose of any native resources associated with the watcher. If we were active, stop. Attempting to operate on this object after calling close is undefined. You should dispose of any references you have to it after calling this method. N((((s1lib/python2.7/site-packages/gevent/_interfaces.pytcloseÝs(R&R'R(R2R3R4(((s1lib/python2.7/site-packages/gevent/_interfaces.pyR½s  ( R(t __future__RRRR.t gevent._utilRRt__all__RR(((s1lib/python2.7/site-packages/gevent/_interfaces.pyt s