Skip to content

Latest commit

 

History

History
1265 lines (1011 loc) · 71.6 KB

changelog.rst

File metadata and controls

1265 lines (1011 loc) · 71.6 KB
Raw

Changelog

.. currentmodule:: gevent

Unreleased

  • Enable the c-ares resolver extension for PyPy.
  • On some versions of PyPy on some platforms (notably 2.6.0 on 64-bit Linux), enabling gevent.monkey.patch_builtins could cause PyPy to crash. Reported in :issue:`618` by Jay Oster.
  • gevent.kill raises the correct exception in the target greenlet. Reported in :issue:`623` by Jonathan Kamens.

1.1b1 (Jul 17, 2015)

  • setup.py can be run from a directory containing spaces. Reported in :issue:`319` by Ivan Smirnov.
  • setup.py can build with newer versions of clang on OS X. They enforce the distinction between CFLAGS and CPPFLAGS.
  • gevent.lock.Semaphore is atomic on PyPy, just like it is on CPython. This comes at a small performance cost.
  • Fixed regression that failed to set the successful value to False when killing a greenlet before it ran with a non-default exception. Fixed in :pr:`608` by Heungsub Lee.
  • libev's child watchers caused os.waitpid to become unreliable due to the use of signals on POSIX platforms. This was especially noticeable when using gevent.subprocess in combination with multiprocessing. Now, the monkey-patched os module provides a waitpid function that seeks to ameliorate this. Reported in :issue:`600` by champax and :issue:`452` by Łukasz Kawczyński.
  • On platforms that implement select.poll, provide a gevent-friendly gevent.select.poll and corresponding monkey-patch. Implemented in :pr:`604` by Eddi Linder.
  • Allow passing of events to the io callback under PyPy. Reported in :issue:`531` by M. Nunberg and implemented in :pr:`604`.
  • gevent.thread.allocate_lock (and so a monkey-patched standard library allocate_lock) more closely matches the behaviour of the builtin: an unlocked lock cannot be released, and attempting to do so throws the correct exception (thread.error on Python 2, RuntimeError on Python 3). Previously, over-releasing a lock was silently ignored. Reported in :issue:`308` by Jędrzej Nowak.
  • gevent.fileobject.FileObjectThread uses the threadpool to close the underling file-like object. Reported in :issue:`201` by vitaly-krugl.
  • Malicious or malformed HTTP chunked transfer encoding data sent to the gevent.pywsgi handler is handled more robustly, resulting in "HTTP 400 bad request" responses instead of a 500 error or, in the worst case, a server-side hang. Reported in :issue:`229` by Björn Lindqvist.
  • Importing the standard library threading module before using gevent.monkey.patch_all() no longer causes Python 3.4 to fail to get the repr of the main thread, and other CPython platforms to return an unjoinable DummyThread. (Note that this is not recommended.) Reported in :issue:`153`.
  • Under Python 2, use the io package to implement FileObjectPosix. This unifies the code with the Python 3 implementation, and fixes problems with using seek(). See :issue:`151`.
  • Under Python 2, importing a module that uses gevent blocking functions at its top level from multiple greenlets no longer produces import errors (Python 3 handles this case natively). Reported in :issue:`108` by shaun and initial fix based on code by Sylvain Zimmer.
  • gevent.spawn, spawn_raw and spawn_later, as well as the Greenlet constructor, immediately produce useful TypeError``s if asked to run something that cannot be run. Previously, the spawned greenlet would die with an uncaught ``TypeError the first time it was switched to. Reported in :issue:`119` by stephan.
  • Recursive use of gevent.threadpool.ThreadPool.apply no longer raises a LoopExit error (using ThreadPool.spawn and then get on the result still could; you must be careful to use the correct hub). Reported in :issue:`131` by 8mayday.
  • When the threading module is monkey-patched, the module-level lock in the logging module is made greenlet-aware, as are the instance locks of any configured handlers. This makes it safer to import modules that use the standard pattern of creating a module-level Logger instance before monkey-patching. Configuring logging with a basic configuration and then monkey-patching is also safer (but not configurations that involve such things as the SocketHandler).
  • Fix monkey-patching of threading.RLock under Python 3.
  • Under Python 3, monkey-patching at the top-level of a module that was imported by another module could result in a RuntimeError from importlib. Reported in :issue:`615` by Daniel Mizyrycki. (The same thing could happen under Python 2 if a threading.RLock was held around the monkey-patching call; this is less likely but not impossible with import hooks.)
  • Fix configuring c-ares for a 32-bit Python when running on a 64-bit platform. Reported in :issue:`381` and fixed in :pr:`616` by Chris Lane.
  • (Experimental) Let the pywsgi.WSGIServer accept a logging.Logger instance for its log and (new) error_log parameters. Take care that the system is fully monkey-patched very early in the process's lifetime if attempting this, and note that non-file handlers have not been tested. Fixes :issue:`106`.

1.1a2 (Jul 8, 2015)

  • gevent.threadpool.ThreadPool.imap and imap_unordered now accept multiple iterables.
  • (Experimental) Exceptions raised from iterating using the ThreadPool or Group mapping/application functions should now have the original traceback.
  • gevent.threadpool.ThreadPool.apply now raises any exception raised by the called function, the same as gevent.pool.Group/Pool and the builtin apply function. This obsoletes the undocumented apply_e function. Original PR :issue:`556` by Robert Estelle.
  • Monkey-patch the selectors module from patch_all and patch_select on Python 3.4. See :issue:`591`.
  • Additional query functions for the :mod:`gevent.monkey` module allow knowing what was patched. Discussed in :issue:`135` and implemented in :pr:`325` by Nathan Hoad.
  • In non-monkey-patched environments under Python 2.7.9 or above or Python 3, using a gevent SSL socket could cause the greenlet to block. See :issue:`597` by David Ford.
  • gevent.socket.socket.sendall supports arbitrary objects that implement the buffer protocol (such as ctypes structures), just like native sockets. Reported in :issue:`466` by tzickel.
  • Added support for the onerror attribute present in CFFI 1.2.0 for better signal handling under PyPy. Thanks to Armin Rigo and Omer Katz. (See https://bitbucket.org/cffi/cffi/issue/152/handling-errors-from-signal-handlers-in)
  • The gevent.subprocess module is closer in behaviour to the standard library under Python 3, at least on POSIX. The pass_fds, restore_signals, and start_new_session arguments are now unimplemented, as are the timeout parameters to various functions. Under Python 2, the previously undocumented timeout parameter to Popen.communicate raises an exception like its Python 3 counterpart.
  • An exception starting a child process with the gevent.subprocess module no longer leaks file descriptors. Reported in :pr:`374` by 陈小玉.
  • The example echoserver.py no longer binds to the standard X11 TCP port. Reported in :issue:`485` by minusf.
  • gevent.iwait no longer throws LoopExit if the caller switches greenlets between return values. Reported and initial patch in :pr:`467` by Alexey Borzenkov.
  • The default threadpool and default threaded resolver work in a forked child process, such as with multiprocessing.Process. Previously the child process would hang indefinitely. Reported in :issue:`230` by Lx Yu.
  • Fork watchers are more likely to (eventually) get called in a multi-threaded program. See :issue:`154`.
  • gevent.killall accepts an arbitrary iterable for the greenlets to kill. Reported in :issue:`404` by Martin Bachwerk; seen in combination with older versions of simple-requests.
  • gevent.local.local objects are now eligible for garbage collection as soon as the greenlet finishes running, matching the behaviour of the built-in threading.local (when implemented natively). Reported in :issue:`387` by AusIV.
  • Killing a greenlet (with gevent.kill or gevent.greenlet.Greenlet.kill) before it is actually started and switched to now prevents the greenlet from ever running, instead of raising an exception when it is later switched to. See :issue:`330` reported by Jonathan Kamens.

1.1a1 (Jun 29, 2015)

  • Add support for Python 3.3 and 3.4. Many people have contributed to this effort, including but not limited to Fantix King, hashstat, Elizabeth Myers, jander, Luke Woydziak, and others. See :issue:`38`.
  • Add support for PyPy. See :issue:`248`. Note that for best results, you'll need a very recent PyPy build including CFFI 1.2.0.
  • Drop support for Python 2.5. Python 2.5 users can continue to use gevent 1.0.x.
  • Fix gevent.greenlet.joinall to not ignore count when raise_error is False. See :pr:`512` by Ivan Diao.
  • Fix subprocess.Popen to not ignore the bufsize argument. Note that this changes the (platform dependent) default, typically from buffered to unbuffered. See :pr:`542` by Romuald Brunet.
  • Upgraded c-ares to 1.10.0. See :pr:`579` by Omer Katz.
  • Add a count argument to gevent.greenlet.wait. See :pr:`482` by wiggin15.
  • Add a timeout argument to gevent.queue.JoinableQueue.wait which now returns whether all items were waited for or not.
  • gevent.queue.JoinableQueue treats items passed to __init__ as unfinished tasks, the same as if they were put. Initial :pr:`554` by DuLLSoN.
  • gevent.pywsgi no longer prints debugging information for the normal conditions of a premature client disconnect. See :issue:`136`, fixed in :pr:`377` by Paul Collier.
  • (Experimental.) Waiting on or getting results from greenlets that raised exceptions now usually raises the original traceback. This should assist things like Sentry to track the original problem. See :issue:`450` and :issue:`528` by Rodolfo and Eddi Linder and :issue:`240` by Erik Allik.
  • Upgrade to libev 4.20. See :pr:`590` by Peter Renström.
  • Fix gevent.baseserver.BaseServer to be printable when its handle function is an instancemethod of itself. See :pr:`501` by Joe Jevnik.
  • Make the acquire method of gevent.lock.DummySemaphore always return True, supporting its use-case as an "infinite" or unbounded semaphore providing no exclusing, and allowing the idiom if sem.acquire(): .... See :pr:`544` by Mouad Benchchaoui.
  • Patch subprocess by default in gevent.monkey.patch_all. See :issue:`446`.
  • gevent.pool.Group.imap and imap_unordered now accept multiple iterables like itertools.imap. :issue:`565` reported by Thomas Steinacher.
  • Compatibility note: gevent.baseserver.BaseServer and its subclass gevent.server.StreamServer now deterministically close the client socket when the request handler returns. Previously, the socket was left at the mercies of the garbage collector; under CPython 2.x this meant when the last reference went away, which was usually, but not necessarily, when the request handler returned, but under PyPy it was some arbitrary point in the future and under CPython 3.x a ResourceWarning could be generated. This was undocumented behaviour, and the client socket could be kept open after the request handler returned either accidentally or intentionally.
  • Compatibility note: pywsgi now ensures that headers can be encoded in latin-1 (ISO-8859-1). This improves adherence to the HTTP standard (and is necessary under Python 3). Under certain conditions, previous versions could have allowed non-ISO-8859-1 headers to be sent, but their interpretation by a conforming recipient is unknown; now, a UnicodeError will be raised. See :issue:`614`.

Release 1.0.2

  • Fix LifoQueue.peek() to return correct element. :pr:`456`. Patch by Christine Spang.
  • Upgrade to libev 4.19
  • Remove SSL3 entirely as default TLS protocol
  • Import socket on Windows (closes :issue:`459`)
  • Fix C90 syntax error (:pr:`449`)
  • Add compatibility with Python 2.7.9's SSL changes. :issue:`477`.

Release 1.0.1

  • Fix :issue:`423`: Pool's imap/imap_unordered could hang forever. Based on patch and test by Jianfei Wang.

Release 1.0 (Nov 26, 2013)

  • pywsgi: Pass copy of error list instead of direct reference. Thanks to Jonathan Kamens, Matt Iversen.
  • Ignore the autogenerated doc/gevent.*.rst files. Patch by Matthias Urlichs.
  • Fix cythonpp.py on Windows. Patch by Jeryn Mathew.
  • Remove gevent.run (use gevent.wait).

Release 1.0rc3 (Sep 14, 2013)

  • Fix :issue:`251`: crash in gevent.core when accessing destroyed loop.
  • Fix :issue:`235`: Replace self._threadpool.close() with self._threadpool.kill() in hub.py. Patch by Jan-Philip Gehrcke.
  • Remove unused timeout from select.py (:issue:`254`). Patch by Saúl Ibarra Corretgé.
  • Rename Greenlet.link()'s argument to 'callback' (closes :issue:`244`).
  • Fix parallel build (:issue:`193`). Patch by Yichao Yu.
  • Fix :issue:`263`: potential UnboundLocalError: 'length' in gevent.pywsgi.
  • Simplify psycopg2_pool.py (:issue:`239`). Patch by Alex Gaynor.
  • pywsgi: allow Content-Length in GET requests (:issue:`264`). Patch by 陈小玉.
  • documentation fixes (:issue:`281`) [philipaconrad].
  • Fix old documentation about default blocking behavior of kill, killall (:issue:`306`). Patch by Daniel Farina.
  • Fix :issue:`6`: patch sys after thread. Patch by Anton Patrushev.
  • subprocess: fix check_output on Py2.6 and older (:issue:`265`). Thanks to Marc Sibson for test.
  • Fix :issue:`302`: "python -m gevent.monkey" now sets __file__ properly.
  • pywsgi: fix logging when bound on unix socket (:issue:`295`). Thanks to Chris Meyers, Eugene Pankov.
  • pywsgi: readout request data to prevent ECONNRESET
  • Fix :issue:`303`: 'requestline' AttributeError in pywsgi. Thanks to Neil Chintomby.
  • Fix :issue:`79`: Properly handle HTTP versions. Patch by Luca Wehrstedt.
  • Fix :issue:`216`: propagate errors raised by Pool.map/imap

Release 1.0rc2 (Dec 10, 2012)

  • Fixed :issue:`210`: callbacks were not run for non-default loop (bug introduced in 1.0rc1).
  • patch_all() no longer patches subprocess unless subprocess=True is passed.
  • Fixed AttributeError in hub.Waiter.
  • Fixed :issue:`181`: make hidden imports visible to freezing tools like py2exe. Patch by Ralf Schmitt.
  • Fixed :issue:`202`: periodically yield when running callbacks (sleep(0) cannot block the event loop now).
  • Fixed :issue:`204`: os.tp_read/tp_write did not propogate errors to the caller.
  • Fixed :issue:`217`: do not set SO_REUSEADDR on Windows.
  • Fixed bug in --module argument for gevent.monkey. Patch by Örjan Persson.
  • Remove warning from threadpool.py about mixing fork() and threads.
  • Cleaned up hub.py from code that was needed to support older greenlets. Patch by Saúl Ibarra Corretgé.
  • Allow for explicit default loop creation via get_hub(default=True). Patch by Jan-Philip Gehrcke.

Release 1.0rc1 (Oct 30, 2012)

  • Fixed hub.switch() not to touch stacktrace when switching. greenlet restores the exception information correctly since version 0.3.2. gevent now requires greenlet >= 0.3.2
  • Added gevent.wait() and gevent.iwait(). This is like gevent.joinall() but supports more objects, including Greenlet, Event, Semaphore, Popen. Without arguments it waits for the event loop to finish (previously gevent.run() did that). gevent.run will be removed before final release and gevent.joinall() might be deprecated.
  • Reimplemented loop.run_callback with a list and a single prepare watcher; this fixes the order of spawns and improves performance a little.
  • Fixes Semaphore/Lock not to init hub in __init__, so that it's possible to have module-global locks without initializing the hub. This fixes monkey.patch_all() not to init the hub.
  • New implementation of callbacks that executes them in the order they were added. core.loop.callback is removed.
  • Fixed 2.5 compatibility.
  • Fixed crash on Windows when request 'prev' and 'attr' attributes of 'stat' watcher. The attribute access still fails, but now with an exception.
  • Added known_failures.txt that lists all the tests that fail. It can be used by testrunner.py via expected option. It's used when running the test suite in travis.
  • Fixed socket, ssl and fileobject to not mask EBADF error - it is now propogated to the caller. Previously EBADF was converted to empty read/write. Thanks to Vitaly Kruglikov
  • Removed gevent.event.waitall()
  • Renamed FileObjectThreadPool -> FileObjectThread
  • Greenlet: Fixed :issue:`143`: greenlet links are now executed in the order they were added
  • Synchronize access to FileObjectThread with Semaphore
  • EINVAL is no longer handled in fileobject.

monkey:

  • Fixed :issue:`178`: disable monkey patch os.read/os.write
  • Fixed monkey.patch_thread() to patch threading._DummyThread to avoid leak in threading._active. Original patch by Wil Tan.
  • added Event=False argument to patch_all() and patch_thread
  • added patch_sys() which patches stdin, stdout, stderr with FileObjectThread wrappers. Experimental / buggy.
  • monkey patching everything no longer initializes the hub/event loop.

socket:

  • create_connection: do not lookup IPv6 address if IPv6 is unsupported. Patch by Ralf Schmitt.

pywsgi:

  • Fixed :issue:`86`: bytearray is now supported. Original patch by Aaron Westendorf.
  • Fixed :issue:`116`: Multiline HTTP headers are now handled properly. Patch by Ralf Schmitt.

subprocess:

  • Fixed Windows compatibility. The wait() method now also supports 'timeout' argument on Windows.
  • Popen: Added rawlink() method, which makes Popen objects supported by gevent.wait(). Updated examples/processes.py
  • Fixed :issue:`148`: read from errpipe_read in small chunks, to avoid trigger EINVAL issue on Mac OS X. Patch by Vitaly Kruglikov
  • Do os._exit() in "finally" section to avoid executing unrelated code. Patch by Vitaly Kruglikov.

resolver_ares:

  • improve getaddrinfo: For string ports (e.g. "http") resolver_ares/getaddrinfo previously only checked either getservbyname(port, "tcp") or getservbyname(port, "udp"), but never both. It now checks both of them.
  • gevent.ares.channel now accepts strings as arguments
  • upgraded c-ares to cares-1_9_1-12-g805c736
  • it is now possible to configure resolver_ares directly with environ, like GEVENTARES_SERVERS

os:

  • Renamed threadpool_read/write to tp_read/write.
  • Removed posix_read, posix_write.
  • Added nb_read, nb_write, make_nonblocking.

hub:

  • The system error is now raised immediatelly in main greenlet in all cases.
  • Dropped support for old greenlet versions (need >= 0.3.2 now)

core:

  • allow 'callback' property of watcher to be set to None. "del w.callback" no longer works.
  • added missing 'noinotify' flag

Misc:

  • gevent.thread: allocate_lock is now an alias for LockType/Semaphore. That way it does not fail when being used as class member.
  • Updated greentest.py to start timeouts with ref=False.
  • pool: remove unused get_values() function
  • setup.py now recognizes GEVENTSETUP_EV_VERIFY env var which sets EV_VERIFY macro when compiling
  • Added a few micro benchmarks
  • stdlib tests that we care about are now included in greentest/2.x directories, so we don't depend on them being installed system-wide
  • updated util/makedist.py
  • the testrunner was completely rewritten.

Release 1.0b4 (Sep 6, 2012)

  • Added gevent.os module with 'read' and 'write' functions. Patch by Geert Jansen.
  • Moved gevent.hub.fork to gevent.os module (it is still available as gevent.fork).
  • Fixed :issue:`148`: Made fileobject handle EINVAL, which is randomly raised by os.read/os.write on Mac OS X. Thanks to Mark Hingston.
  • Fixed :issue:`150`: gevent.fileobject.SocketAdapter.sendall() could needlessly wait for write event on the descriptor. Original patch by Mark Hingston.
  • Fixed AttributeError in baseserver. In case of error, start() would call kill() which was renamed to close(). Thanks to Vitaly Kruglikov.

Release 1.0b3 (Jul 27, 2012)

  • New gevent.subprocess module
  • New gevent.fileobject module
  • Fixed ThreadPool to discard references of the objects passed to it (function, arguments) asap. Previously they could be stored for unlimited time until the thread gets a new job.
  • Fixed :issue:`138`: gevent.pool.Pool().imap_unordered hangs with an empty iterator. Thanks to exproxus.
  • Fixed :issue:`127`: ssl.py could raise TypeError in certain cases. Thanks to Johan Mjones.
  • Fixed socket.makefile() to keep the timeout setting of the socket instance. Thanks to Colin Marc.
  • Added 'copy()' method to queues.
  • The 'nochild' event loop config option is removed. The install_sigchld offer more flexible way of enabling child watchers.
  • core: all watchers except for 'child' now accept new 'priority' keyword argument
  • gevent.Timeout accepts new arguments: 'ref' and 'priority'. The default priority for Timeout is -1.
  • Hub.wait() uses Waiter now instead of raw switching
  • Updated libev to the latest CVS version
  • Made pywsgi to raise an AssertionError if non-zero content-length is passed to start_response(204/304) or if non-empty body is attempted to be written for 304/204 response
  • Removed pywsgi feature to capitalize the passed headers.
  • Fixed util/cythonpp.py to work on python3.2 (:issue:`123`). Patch by Alexandre Kandalintsev.
  • Added 'closed' readonly property to socket.
  • Added 'ref' read/write property to socket.
  • setup.py now parses CARES_EMBED and LIBEV_EMBED parameters, in addition to EMBED.
  • gevent.reinit() and gevent.fork() only reinit hub if it was created and do not create it themselves
  • Fixed setup.py not to add libev and c-ares to include dirs in non-embed mode. Patch by Ralf Schmitt.
  • Renamed util/make_dist.py to util/makedist.py
  • testrunner.py now saves more information about the system; the stat printing functionality is moved to a separate util/stat.py script.

Release 1.0b2 (Apr 11, 2012)

Major and backward-incompatible changes:

  • Made the threadpool-based resolver the default. To enable the ares-based resolver, set GEVENT_RESOLVER=ares env var.
  • Added support for child watchers (not available on Windows). - Libev loop now reaps all children by default. - If NOCHILD flag is passed to the loop, child watchers and child reaping are disabled.
  • Renamed gevent.coros to gevent.lock. The gevent.coros is still available but deprecated.
  • Added 'stat' watchers to loop.
  • The setup.py now recognizes gevent_embed env var. When set to "no", bundled c-ares and libev are ignored.
  • Added optional 'ref' argument to sleep(). When ref=false, the watchers created by sleep() do not hold gevent.run() from exiting.
  • ThreadPool now calls Hub.handle_error for exceptions in worker threads.
  • ThreadPool got new method: apply_e.
  • Added new extension module gevent._util and moved gevent.core.set_exc_info function there.
  • Added new extension module gevent._semaphore. It contains Semaphore class which is imported by gevent.lock as gevent.lock.Semaphore. Providing Semaphore in extension module ensures that trace function set with settrace will not be called during __exit__. Thanks to Ralf Schmitt.
  • It is now possible to kill or pre-spawn threads in ThreadPool by setting its 'size' property.

core:

  • Make sure the default loop cannot be destroyed more than once, thus crashing the process.
  • Make Hub.destroy() method not to destroy the default loop, unless destroy_loop is True. Non-default loops are still destroyed by default.
  • loop: Removed properties from loop: fdchangecnt, timercnt, asynccnt.
  • loop: Added properties: sigfd, origflags, origflags_int
  • loop: The EVFLAG_NOENV is now always passed to libev. Thus LIBEV_FLAGS env variable is no longer checked. Use GEVENT_BACKEND.

Misc:

  • Check that the argument of link() is callable. Raise TypeError when it's not.
  • Fixed TypeError in baseserver when parsing an address.
  • Pool: made add() and discard() usable by external users. Thanks to Danil Eremeev.
  • When specifying a class to import, it is now possible to use format path/package.module.name
  • pywsgi: Made sure format_request() does not fail if 'status' attribute is not set yet
  • pywsgi: Added REMOTE_PORT variable to the environment.

Examples:

  • portforwarder.py now shows how to use gevent.run() to implement graceful shutdown of a server.
  • psycopg2_pool.py: Changed execute() to return rowcount.
  • psycopg2_pool.py: Added fetchall() and fetchiter() methods.

Developer utilities:

  • When building, CYTHON env variable can be used to specify Cython executable to use.
  • util/make_dist.py now recongizes --fast and --revert options. Previous --rsync option is removed.
  • Added util/winvbox.py which automates building/testing/making binaries on Windows VM.
  • Fixed typos in exception handling code in testrunner.py
  • Fixed patching unittest.runner on Python2.7. This caused the details of test cases run lost.
  • Made testrunner.py kill the whole process group after test is done.

Release 1.0b1 (Jan 10, 2012)

Backward-incompatible changes:

  • Removed "link to greenlet" feature of Greenlet.
  • If greenlet module older than 0.3.2 is used, then greenlet.GreenletExit.__bases__ is monkey patched to derive from BaseException and not Exception. That way gevent.GreenletExit is always derived from BaseException, regardless of installed greenlet version.
  • Some code supporting Python 2.4 has been removed.

Release highlights:

  • Added thread pool: gevent.threadpool.ThreadPool.
  • Added thread pool-based resolver. Enable with GEVENT_RESOLVER=thread.
  • Added UDP server: gevent.server.DatagramServer
  • A "configure" is now run on libev. This fixes a problem of 'kqueue' not being available on Mac OS X.
  • Gevent recognizes some environment variables now: - GEVENT_BACKEND allows passing argument to loop, e.g. "GEVENT_BACKEND=select" for force select backend - GEVENT_RESOLVER allows choosing resolver class. - GEVENT_THREADPOOL allows choosing thread pool class.
  • Added new examples: portforwarder, psycopg2_pool.py, threadpool.py, udp_server.py
  • Fixed non-embedding build. To build against system libev, remove or rename 'libev' directory. To build against system c-ares, remove or rename 'c-ares'. Thanks to Örjan Persson.

misc: - gevent.joinall() method now accepts optional 'count' keyword. - gevent.fork() only calls reinit() in the child process now. - gevent.run() now returns False when exiting because of timeout or event (previous None). - Hub got a new method: destroy(). - Hub got a new property: threadpool.

ares.pyx: - Fixed :issue:`104`: made ares_host_result pickable. Thanks to Shaun Cutts.

pywsgi: - Removed unused deprecated 'wfile' property from WSGIHandler - Fixed :issue:`92`: raise IOError on truncated POST requests. - Fixed :issue:`93`: do not sent multiple "100 continue" responses

core: - Fixed :issue:`97`: the timer watcher now calls ev_now_update() in start() and again() unless 'update' keyword is passed and set to False. - add set_syserr_cb() function; it's used by gevent internally. - gevent now installs syserr callback using libev's set_syserr_cb. This callback is called when libev encounters an error it cannot recover from. The default action is to print a message and abort. With the callback installed, a SystemError() is now raised in the main greenlet. - renamed 'backend_fd' property to 'fileno()' method. (not available if you build gevent against system libev) - added 'asynccnt' property (not available if you build gevent against system libev) - made loop.__repr__ output a bit more compact - the watchers check the arguments for validness now (previously invalid argument would crash libev). - The 'async' watcher now has send() method; - fixed time() function - libev has been upgraded to latest CVS version. - libev has been patched to use send()/recv() for evpipe on windows when libev_vfd.h is in effect

resolver_ares: - Slightly improved compatibility with stdlib's socket in some error cases.

socket: - Fixed close() method not to reference any globals - Fixed :issue:`115`: _dummy gets unexpected Timeout arg - Removed _fileobject used for python 2.4 compatibility in socket.py - Fixed :issue:`94`: fallback to buffer if memoryview fails in _get_memory on python 2.7

monkey: - Removed patch_httplib() - Fixed :issue:`112`: threading._sleep is not patched. Thanks to David LaBissoniere. - Added get_unpatched() function. However, it is slightly broken at the moment.

backdoor: - make 'locals()' not spew out __builtin__.__dict__ in backdoor - add optional banner argument to BackdoorServer

servers: - add server.DatagramServer; - StreamServer: 'ssl_enabled' is now a read-only property - servers no longer have 'kill' method; it has been renamed to 'close'. - listeners can now be configured as strings, e.g. ':80' or 80 - modify baseserver.BaseServer in such a way that makes it a good base class for both StreamServer and DatagramServer - BaseServer no longer accepts 'backlog' parameter. It is now done by StreamServer. - BaseServer implements start_accepting() and stop_accepting() methods - BaseServer now implements "temporarily stop accepting" strategy - BaseServer now has _do_read method which does everything except for actually calling accept()/recvfrom() - pre_start() method is renamed to init_socket() - renamed _stopped_event to _stop_event - 'started' is now a read-only property (which actually reports state of _stop_event) - post_stop() method is removed - close() now sets _stop_event(), thus setting 'started' to False, thus causing serve_forever() to exit - _tcp_listener() function is moved from baseserver.py to server.py - added 'fatal_errors' class attribute which is a tuple of all errnos that should kill the server

coros: - Semaphore: add _start_notify() method - Semaphore: avoid copying list of links; rawlink() no longer schedules notification

Release 1.0a3 (Sep 15, 2011)

Added 'ref' property to all watchers. Settings it to False make watcher call ev_unref/ev_ref appropriately so that this watcher does not prevent loop.run()/hub.join()/run() from exiting. Made resolver_ares.Resolver use 'ref' property for internal watcher.

In all servers, method "kill" was renamed to "close". The old name is available as deprecated alias.

Added a few properties to the loop: backend_fd, fdchangecnt, timercnt.

Upgraded c-ares to 1.7.5+patch.

Fixed getaddrinfo to return results in the order (::1, IPv4, IPv6).

Fixed getaddrinfo() to handle integer of string type. Thanks to kconor.

Fixed gethostbyname() to handle '' (empty string).

Fixed getaddrinfo() to convert UnicodeEncodeError into error('Int or String expected').

Fixed getaddrinfo() to uses the lowest 16 bits of passed port integer similar to built-in _socket.

Fixed getnameinfo() to call getaddrinfo() to process arguments similar to built-in _socket.

Fixed gethostbyaddr() to use getaddrinfo() to process arguments.

version_info is now a 5-tuple.

Added handle_system_error() method to Hub (used internally).

Fixed Hub's run() method to never exit. This prevent inappropriate switches into parent greenlet.

Fixed Hub.join() to return True if Hub was already dead.

Added 'event' argument to Hub.join().

Added run() function to gevent top level package.

Fixed Greenlet.start() to exit silently if greenlet was already started rather than raising :exc:`AssertionError`.

Fixed Greenlet.start() not to schedule another switch if greenlet is already dead.

Fixed gevent.signal() to spawn Greenlet instead of raw greenlet. Also it'll switch into the new greenlet immediately instead of scheduling additional callback.

Do monkey patch create_connection() as gevent's version works better with gevent.socket.socket than the standard create_connection.

pywsgi: make sure we don't try to read more requests if socket operation failed with EPIPE

pywsgi: if we failed to send the reply, change 'status' to socket error so that the logs mention the error.

Release 1.0a2 (Aug 2, 2011)

Fixed a bug in gevent.queue.Channel class. (Thanks to Alexey Borzenkov)

Release 1.0a1 (Aug 2, 2011)

Backward-incompatible changes:

Release highlights:

  • The :mod:`gevent.core` module now wraps libev's API and is not compatible with gevent 0.x.
  • Added a concept of pluggable event loops. By default gevent.core.loop is used, which is a wrapper around libev.
  • Added a concept of pluggable name resolvers. By default a resolver based on c-ares library is used.
  • Added support for multiple OS threads, each new thread will get its own Hub instance with its own event loop.
  • The release now includes and embeds the dependencies: libev and c-ares.
  • The standard :mod:`signal` works now as expected.
  • The unhandled errors are now handled uniformely by Hub.handle_error function.
  • Added :class:`Channel` class to :mod:`gevent.queue` module. It is equivalent to Queue(0) in gevent 0.x, which is deprecated now.
  • Added method :meth:`peek` to :class:`Queue` class.
  • Added :func:`idle` function which blocks until the event loop is idle.
  • Added a way to gracefully shutdown the application by waiting for all outstanding greenlets/servers/watchers: :meth:`Hub.join`.
  • Added new :mod:`gevent.ares` C extension which wraps c-ares and provides asynchronous DNS resolver.
  • Added new :mod:`gevent.resolver_ares` module provides synchronous API on top of :mod:`gevent.ares`.

The :mod:`gevent.socket` module:

  • DNS functions now use c-ares library rather than libevent-dns. This fixes a number of problems with name resolving:
    • Fix :issue:`2`: DNS resolver no longer breaks after fork(). You still need to call :func:`gevent.fork` (os.fork is monkey
      patched with it if monkey.patch_all() was called).
    • DNS resolver no longer ignores /etc/resolv.conf and /etc/hosts.
  • The following functions were added to socket module - gethostbyname_ex - getnameinfo - gethostbyaddr - getfqdn
  • Removed undocumented bind_and_listen and tcp_listener

The :class:`Hub` object:

  • Added :meth:`join` method which waits until the event loop exits or optional timeout expires.
  • Added :meth:`wait` method which waits until a watcher has got an event.
  • Added :meth:`handle_error` method which is called by all of gevent in case of unhandled exception.
  • Added :meth:`print_exception` method which is called by handle_error to print the exception traceback.

The :class:`Greenlet` objects:

  • Added __nonzero__ implementation that returns True after greenlet was started until it's dead. Previously greenlet was False after start() until it was first switched to.

The mod:gevent.pool module:

  • It is now possible to add raw greenlets to the pool.
  • The :meth:`map` and :meth:`imap` methods now start yielding the results as soon as possible.
  • The :meth:`imap_unordered` no longer swallows an exception raised while iterating its argument.

Miscellaneous:

  • gevent.sleep(<negative value>) no longer raises an exception, instead it does sleep(0).
  • Added method clear to internal Waiter class.
  • Removed wait method from internal Waiter class.
  • The :class:`WSGIServer` now sets max_accept to 1 if wsgi.multiprocessing is set to True.
  • Added :func:`monkey.patch_module` function that monkey patches module using __implements__ list provided by gevent module. All of gevent modules that replace stdlib module now have __implements__ attribute.

Release 0.13.8 (September 6, 2012)

  • Fixed :issue:`80`: gevent.httplib failed with RequestFailed errors because timeout was reset to 1s. Patch by Tomasz Prus.
  • core: fix compilation with the latest Cython: remove emit_ifdef/emit_else/emit_endif.
  • Fixed :issue:`132`: gevent.socket.gethostbyname(<unicode>) now does ascii encoding and uses gevent's resolver rather than calling built-in resolver. Patch by Alexey Borzenkov.

Release 0.13.7 (April 12, 2012)

  • Fixed :issue:`94`: fallback to buffer if memoryview fails in _get_memory on python 2.7.
  • Fixed :issue:`103`: Queue(None).full() returns False now (previously it returned True).
  • Fixed :issue:`112`: threading._sleep is not patched. Thanks to David LaBissoniere.
  • Fixed :issue:`115`: _dummy gets unexpected Timeout arg.

Release 0.13.6 (May 2, 2011)

  • Added __copy__ method to :class:`gevent.local.local` class that implements copy semantics compatible with built-in threading.local. Patch by Galfy Pundee.
  • Fixed :class:`StreamServer` class to catch EWOULDBLOCK rather than EAGAIN. This fixes lots of spurious tracebacks on Windows where these two constants are not the same. Patch by Alexey Borzenkov.
  • Fixed :issue:`65`: :func:`fork` now calls event_reinit only in the child process; otherwise the process could hang when using libevent2. Patch by Alexander Boudkar.

Release 0.13.5 (Apr 21, 2011)

  • Fixed build problem on Python 2.5

Release 0.13.4 (Apr 11, 2011)

Release 0.13.3 (Feb 7, 2011)

Release 0.13.2 (Jan 28, 2011)

Release 0.13.1 (Sep 23, 2010)

Release highlights:

:mod:`gevent.socket` module:

:mod:`gevent.ssl` module:

  • Imported a number of patches from stdlib by Antoine Pitrou:
    • Calling :meth:`makefile` method on an SSL object would prevent the underlying socket from being closed until all objects get truely destroyed (Python issue #5238).
    • SSL handshake would ignore the socket timeout and block indefinitely if the other end didn't respond (Python issue #5103).
    • When calling :meth:`getpeername` in SSLSocket.__init__, only silence exceptions caused by the "socket not connected" condition.
  • Added support for ciphers argument.
  • Updated SSLSocket.send and SSLSocket.recv methods to match the behavior of stdlib :mod:`ssl` better.
  • Fixed :class:`ssl.SSLObject` to delete events used by other greenlets when closing the instance (:issue:`34`).

Miscellaneous:

  • Made :class:`BaseServer` accept long values as pool argument in addition to int.
  • Made :attr:`http._requests` attribute public.
  • Updated webchat example to use file on disk rather than in-memory sqlite database to avoid :exc:`OperationalError`.
  • Fixed webproxy.py example to be runnable under external WSGI server.
  • Fixed bogus failure in test__exc_info.py.
  • Added new test to check PEP8 conformance: xtest_pep8.py.
  • Fixed :class:`BackdoorServer` close the connection on :exc:`SystemExit` and simplified the code.
  • Made :class:`Pool` raise :exc:`ValueError` when initialized with size=0.
  • Updated setup.py --libevent to configure and make libevent if it's not built already.
  • Updated setup.py to use setuptools if present and add dependency on greenlet.
  • Fixed doc/mysphinxext.py to work with Sphinx 1. Thanks by Örjan Persson.

Release 0.13.0 (Jul 14, 2010)

Release highlights:

Backward-incompatible changes:

:mod:`gevent.socket` module:

:mod:`gevent.coros` module:

:mod:`gevent.event` module:

:mod:`gevent.wsgi` module:

:mod:`gevent.pywsgi` module:

:mod:`gevent.core` module:

:mod:`gevent.http` and :mod:`gevent.wsgi` modules:

Miscellaneous:

Examples:

Thanks to Ralf Schmitt for :mod:`pywsgi`, a number of fixes for :mod:`wsgi`, help with :mod:`baseserver` and :mod:`server` modules, improving setup.py and various other patches and suggestions.

Thanks to Uriel Katz for :mod:`pywsgi` patches.

Release 0.12.2 (Mar 2, 2010)

  • Fixed http server to put the listening socket into a non-blocking mode. Contributed by Ralf Schmitt.

Release 0.12.1 (Feb 26, 2010)

  • Removed a symlink from the distribution (that causes pip to fail). Thanks to Brad Clements for reporting it.
  • setup.py: automatically create symlink from build/lib.../gevent/core.so to gevent/core.so.
  • :mod:`gevent.socket`: Improved compatibility with stdlib's socket:

Release 0.12.0 (Feb 5, 2010)

Release highlights:

:mod:`gevent.wsgi` module:

  • Made env["REMOTE_PORT"] into a string.
  • Fixed the server to close the iterator returned by the application.
  • Made wsgi.input object iterable.

:mod:`gevent.core` module:

  • Made DNS functions no longer accept/return IP addresses in dots-and-numbers format. They work with packed IPs now.
  • Made DNS functions no longer accept additional arguments to pass to the callback.
  • Fixed DNS functions to check the return value of the libevent functions and raise :exc:`IOError` if they failed.
  • Added :func:`core.dns_err_to_string`.
  • Made core.event.cancel not to raise if event_del reports an error. instead, the return code is passed to the caller.
  • Fixed minor issue in string representation of the events.

:mod:`gevent.socket` module:

Miscellaneous:

Release 0.11.2 (Dec 10, 2009)

Release 0.11.1 (Nov 15, 2009)

  • Fixed bug in :func:`select.select` function. Passing non-empty list of write descriptors used to cause this function to fail.
  • Changed setup.py to go ahead with the compilation even if the actual version of libevent cannot be determined (version 1.x.x is assumed in that case).

Contributed by Ludvig Ericson:

  • Fixed :mod:`wsgi`'s start_response to recognize exc_info argument.
  • Fixed setup.py to look for libevent.dylib rather than .so on Darwin platforms.

Release 0.11.0 (Oct 9, 2009)

Release 0.10.0 (Aug 26, 2009)

The following items were added to the gevent top level package:

The following items were marked as deprecated:

Internally, gevent.greenlet was split into a number of modules:

Thanks to Jason Toffaletti for reporting the installation issue and providing a test case for WSGI double content-length header bug.

Release 0.9.3 (Aug 3, 2009)

  • Fixed all known bugs in the :mod:`gevent.queue` module and made it 2.4-compatible. :class:`LifoQueue` and :class:`PriorityQueue` are implemented as well. :mod:`gevent.queue` will deprecate both coros.Queue and coros.Channel.
  • Fixed :class:`Timeout` to raise itself by default. TimeoutError is gone. Silent timeout is now created by passing False instead of None.
  • Fixed bug in :func:`gevent.select.select` where it could silent the wrong timeout.
  • :func:`spawn` and :func:`spawn_later` now avoid creating a closure and this decreases spawning time by 50%.
  • kill's and killall's wait argument was renamed to block. The polling is now implemented by greenlet.join and greenlet.joinall functions and it become more responsive, with gradual increase of sleep time.
  • Renamed proc.RunningProcSet to proc.ProcSet.
  • Added :func:`shutdown` function, which blocks until libevent has finished dispatching the events.
  • The return value of event_add and event_del in core.pyx are now checked properly and :exc:`IOError` is raised if they have failed.
  • Fixed backdoor.py, accidentally broken in the previous release.

Release 0.9.2 (Jul 20, 2009)

Release 0.9.1 (Jul 9, 2009)

  • Fixed compilation with libevent-1.3. Thanks to Litao Wei for reporting the problem.
  • Fixed :class:`Hub` to recover silently after event_dispatch() failures (I've seen this happen after fork even though event_reinit() is called as necessary). The end result is that :func:`fork` now works more reliably, as detected by test_socketserver.py - it used to fail occasionally, now it does not.
  • Reorganized the package, most of the stuff from gevent/__init__.py was moved to gevent/greenlet.py. gevent/__init__.py imports some of it back but not everything.
  • Renamed gevent.timeout to :class:`gevent.Timeout`. The old name is available as an alias.
  • Fixed a few bugs in :class:`queue.Queue`. Added test_queue.py from standard tests to check how good is :class:`queue.Queue` a replacement for a standard :mod:`Queue` (not good at all, timeouts in :meth:`queue.Queue.put` don't work yet)
  • :mod:`monkey` now patches ssl module when on 2.6 (very limited support).
  • Improved compatibility with Python 2.6 and Python 2.4.
  • Greenlet installed from PyPI (without py.magic prefix) is properly recognized now.
  • core.pyx was accidentally left out of the source package, it's included now.
  • :class:`GreenSocket <socket.socket>` now wraps a socket object from _socket module rather than from :mod:`socket`.

Release 0.9.0 (Jul 8, 2009)

Started as eventlet 0.8.11 fork, with the intention to support only libevent as a backend. Compared to eventlet, this version has a much simpler API and implementation and a few severe bugs fixed, namely

There's a test in my repo of eventlet that reproduces both of them: http://bitbucket.org/denis/eventlet/src/tip/greentest/test__socket.py

Besides having less bugs and less code to care about the goals of the fork are:

  • Piggy-back on libevent as much as possible (use its http and dns code).
  • Use the interfaces and conventions from the standard Python library where possible.