Changes for 1.5#
1.5.0 (2020-04-10)#
Make
gevent.lock.RLock.acquire
accept the timeout parameter.Fix an
AttributeError
when wrapping gevent’sFileObject
around an opened text stream. Reported in issue #1542 by dmrlawson.Fix compilation of libuv on AIX and Solaris 10. See pull request #1549 and pull request #1548 by Arnon Yaari.
1.5a4 (2020-03-23)#
Platform and Packaging Updates#
Python version updates: gevent is now tested with CPython 3.6.10, 3.7.7 and 3.8.2. It is also tested with PyPy2 7.3 and PyPy 3.6 7.3.
The include directories used to compile the C extensions have been tweaked with the intent of making it easier to use older debug versions of Python. See issue #1461.
The binary wheels and installed package no longer include generated C source files and headers. Also excluded are Cython .pxd files, which were never documented. Please file an issue if you miss these.
Library and Dependency Updates#
Upgrade libev from 4.25 to 4.31 and update its embedded
config.guess
to the latest. See issue #1504.Important
libev, when built with
EV_VERIFY >= 2
, now performs verification of file descriptors when IO watchers are started and when they are stopped. If you first close a file descriptor and only then stop an associated watcher, libev will abort the process.Using the standard gevent socket and file objects handles this automatically, but if you’re using the IO watchers directly, you’ll need to watch out for this.
The binary wheels gevent distributes do not set
EV_VERIFY
and don’t have this issue.Make libuv and libev use the Python memory allocators. This assists with debugging. The event libraries allocate small amounts of memory at startup. The allocation functions have to take the GIL, but because of the limited amount of actual allocation that gets done this is not expected to be a bottleneck.
Update the bundled
tblib
library to the unreleased 1.7.0 version. The only change is to add more attributes toFrame
andCode
objects for pytest compatibility. See pull request #1541.
Potentially Breaking Changes#
Remove the magic proxy object
gevent.signal
. This served as both a deprecated alias ofgevent.signal_handler
and the modulegevent.signal
. This made it confusing to humans and static analysis tools alike. The alias was deprecated since gevent 1.1b4. See issue #1596.
Other#
Make
gevent.subprocess.Popen.communicate
raise exceptions raised by reading from the process, like the standard library. In particular, under Python 3, if the process output is being decoded as text, this can now raiseUnicodeDecodeError
. Reported in issue #1510 by Ofer Koren.Make
gevent.subprocess.Popen.communicate
be more careful about closing files. Previously if a timeout error happened, a second call tocommunicate
might not close the pipe.Add
gevent.contextvars
, a cooperative version ofcontextvars
. This is available to all Python versions. On Python 3.7 and above, wherecontextvars
is a standard library module, it is monkey-patched by default. See issue #1407.Use
selectors.PollSelector
as theselectors.DefaultSelector
after monkey-patching ifselect.poll
was defined. Previously, gevent replaced it withselectors.SelectSelector
, which has a different set of limitations (e.g., on certain platforms such as glibc Linux, it has a hardcoded limitation of only working with file descriptors < 1024). See issue #1466 reported by Sam Wong.Make the dnspython resolver work if dns python had been imported before the gevent resolver was initialized. Reported in issue #1526 by Chris Utz and Josh Zuech.
1.5a3 (2020-01-01)#
Python version updates: gevent is now tested with CPython 2.7.17, 3.5.9, 3.6.9, 3.7.5 and 3.8.0 (final). It is also tested with PyPy2 7.2 and PyPy 3.6 7.2
Fix using monkey-patched
threading.Lock
andthreading.RLock
objects as spin locks by making them callsleep(0)
if they failed to acquire the lock in a non-blocking call. This lets other callbacks run to release the lock, simulating preemptive threading. Using spin locks is not recommended, but may have been done in code written for threads, especially on Python 3. See issue #1464.Fix Semaphore (and monkey-patched threading locks) to be fair. This eliminates the rare potential for starvation of greenlets. As part of this change, the low-level method
rawlink
of Semaphore, Event, and AsyncResult now always remove the link object when calling it, sounlink
can sometimes be optimized out. See issue #1487.Make
gevent.pywsgi
supportConnection: keep-alive
in HTTP/1.0. Based on pull request #1331 by tanchuhan.Fix a potential crash using
gevent.idle()
when using libuv. See issue #1489.Fix some potential crashes using libuv async watchers.
Make
ThreadPool
consistently raiseInvalidThreadUseError
whenspawn
is called from a thread different than the thread that created the threadpool. This has never been allowed, but was inconsistently enforced. On gevent 1.3 and before, this would always raise “greenlet error: invalid thread switch,” orLoopExit
. On gevent 1.4, it could raiseLoopExit
, depending on the number of tasks, but still, calling it from a different thread was likely to corrupt libev or libuv internals.Remove some undocumented, deprecated functions from the threadpool module.
libuv: Fix a perceived slowness spawning many greenlets at the same time without yielding to the event loop while having no active IO watchers or timers. If the time spent launching greenlets exceeded the switch interval and there were no other active watchers, then the default IO poll time of about .3s would elapse between spawning batches. This could theoretically apply for any non-switching callbacks. This can be produced in synthetic benchmarks and other special circumstances, but real applications are unlikely to be affected. See issue #1493.
Fix using the threadpool inside a script or module run with
python -m gevent.monkey
. Previously it would use greenlets instead of native threads. See issue #1484.Fix potential crashes in the FFI backends if a watcher was closed and stopped in the middle of a callback from the event loop and then raised an exception. This could happen if the hub’s
handle_error
function was poorly customized, for example. See issue #1482Make
gevent.killall
stop greenlets from running that hadn’t been run yet. This make it consistent withGreenlet.kill()
. See issue #1473 reported by kochelmonster.Make
gevent.spawn_raw
set theloop
attribute on returned greenlets. This lets them work with more gevent APIs, notablygevent.killall()
. They already had dictionaries, but this may make them slightly larger, depending on platform (on CPython 2.7 through 3.6 there is no apparent difference for one attribute but on CPython 3.7 and 3.8 dictionaries are initially empty and only allocate space once an attribute is added; they’re still smaller than on earlier versions though).
File Object Changes#
Caution
There may be breaking changes here for applications that relied on the old behaviour. The old behaviour was under specified and inconsistent and really only worked consistently with ‘wb’ and ‘rb’ modes, so most applications shouldn’t be affected.
The file objects (
FileObjectPosix
,FileObjectThread
) now consistently support text and binary modes. If neither ‘b’ nor ‘t’ is given in the mode, they will read and write native strings. If ‘t’ is given, they will always work with unicode strings, and ‘b’ will always work with byte strings. (FileObjectPosix
already worked this way.) See issue #1441.The file objects accept encoding, errors and newline arguments. On Python 2, these are only used if ‘t’ is in the mode.
The default mode for
FileObjectPosix
changed fromrb
to simplyr
, for consistency with the other file objects and the standardopen
andio.open()
functions.Fix
FileObjectPosix
improperly being used from multiple greenlets. Previously this was hidden by forcing buffering, which raisedRuntimeError
.
1.5a2 (2019-10-21)#
Add support for CPython 3.8.0. (Windows wheels are not yet available.)
Update to Cython 0.29.13 and cffi 1.12.3.
Add an
--module
option togevent.monkey
allowing to run a Python module rather than a script. See pull request #1440.Improve the way joining the main thread works on Python 3.
Implement
SSLSocket.verify_client_post_handshake()
when available.Fix tests when TLS1.3 is supported.
Disable Nagle’s algorithm in the backdoor server. This can improve interactive response time.
Test on Python 3.7.4. There are important SSL test fixes.
1.5a1 (2019-05-02)#
Platform and Packaging Updates#
Python version updates: gevent is now tested with CPython 2.7.16, 3.5.6, 3.6.8, and 3.7.2. It is also tested with PyPy2 7.1 and PyPy 3.6 7.1 (PyPy 7.0 and 7.1 were not capable of running SSL tests on Travis CI).
Support for Python 3.4 has been removed, as that version is no longer supported uptstream.
gevent binary wheels are now manylinux2010 and include libuv support. pip 19 is needed to install them. See issue #1346.
gevent is now compiled with Cython 0.29.6 and cffi 1.12.2.
gevent sources include a pyproject.toml file, specifying the build requirements and enabling build isolation. pip 18 or above is needed to take advantage of this. See issue #1180.
libev-cffi: Let the compiler fill in the definition of
nlink_t
forst_nlink
instruct stat
, instead of trying to guess it ourself. Reported in issue #1372 by Andreas Schwab.Remove the
Makefile
. Its most useful commands,make clean
andmake distclean
, can now be accomplished in a cross-platform way usingpython setup.py clean
andpython setup.py clean -a
, respectively. The remainder of theMakefile
contained Travis CI commands that have been moved to.travis.yml
.Deprecate the
EMBED
andLIBEV_EMBED
, etc, build-time environment variables. Instead, useGEVENTSETUP_EMBED
andGEVENTSETUP_EMBED_LIBEV
. See issue #1402.The CFFI backends now respect the embed build-time setting. This allows building the libuv backend without embedding libuv (except on Windows).
Support test resources. This allows disabling tests that use the network. See Limiting Resource Usage for more.
Library and Dependency Updates#
Upgrade libuv from 1.24.0 to 1.27.0.
Upgrade libev from 4.23 to 4.25 and update its embedded
config.guess
to the latest.Upgrade c-ares from 1.14 to 1.15.
dnspython >= 1.16.0 is now required for the dnspython resolver.
Bug fixes#
Python 3.7 subprocess: Copy a
STARTUPINFO
passed as a parameter. Contributed by AndCycle in pull request #1352.subprocess:
WIFSTOPPED
andSIGCHLD
are now handled for determiningPopen.returncode
. See https://bugs.python.org/issue29335subprocess: No longer close redirected FDs if they are in
pass_fds
. This is a bugfix from Python 3.7 applied to all versions gevent runs on.Fix certain operations on a Greenlet in an invalid state (with an invalid parent) to raise a
TypeError
sooner rather than anAttributeError
later. This is also slightly faster on CPython with Cython. Inspired by issue #1363 as reported by Carson Ip. This means that some extreme corner cases that might have passed by replacing a Greenlet’s parent with something that’s not a gevent hub now no longer will.Fix: The
spawning_stack
for Greenlets on CPython should now have correct line numbers in more cases. See pull request #1379.
Enhancements#
The result of
gevent.ssl.SSLSocket.makefile()
can be used as a context manager on Python 2.Python 2: If the backport of the
_thread_
module fromfutures
has already been imported at monkey-patch time, also patch this module to be consistent. Thepkg_resources
package imports this, andpkg_resources
is often imported early on Python 2 for namespace packages, so iffutures
is installed this will likely be the case.Python 2: Avoid a memory leak when an
io.BufferedWriter
is wrapped around a socket. Reported by Damien Tournoud in issue #1318.Avoid unbounded memory usage when creating very deep spawn trees. Reported in issue #1371 by dmrlawson.
Win: Make
examples/process.py
do something useful. See pull request #1378 by Robert Iannucci.Spawning greenlets can be up to 10% faster. See pull request #1379.