Releases: agronholm/anyio
4.6.0
- Dropped support for Python 3.8 (as #698 cannot be resolved without cancel message support)
- Fixed 100% CPU use on asyncio while waiting for an exiting task group to finish while said task group is within a cancelled cancel scope (#695)
- Fixed cancel scopes on asyncio not propagating
CancelledError
on exit when the enclosing cancel scope has been effectively cancelled (#698) - Fixed asyncio task groups not yielding control to the event loop at exit if there were no child tasks to wait on
- Fixed inconsistent task uncancellation with asyncio cancel scopes belonging to a task group when said task group has child tasks running
4.5.0
- Improved the performance of
anyio.Lock
andanyio.Semaphore
on asyncio (even up to 50 %) - Added the
fast_acquire
parameter toanyio.Lock
andanyio.Semaphore
to further boost performance at the expense of safety (acquire()
will not yield control back if there is no contention) - Added support for the
from_uri()
,full_match()
,parser
methods/properties inanyio.Path
, newly added in Python 3.13 (#737) - Added support for more keyword arguments for
run_process()
andopen_process()
:startupinfo
,creationflags
,pass_fds
,user
,group
,extra_groups
andumask
(#742) - Improved the type annotations and support for
PathLike
inrun_process()
andopen_process()
to allow for path-like arguments, just likesubprocess.Popen
- Changed the
ResourceWarning
from an unclosed memory object stream to include its address for easier identification - Changed
start_blocking_portal()
to always use daemonic threads, to accommodate the "loitering event loop" use case - Bumped the minimum version of Trio to v0.26.1
- Fixed
__repr__()
ofMemoryObjectItemReceiver
, whenitem
is not defined (#767; PR by @Danipulok) - Fixed
to_process.run_sync()
failing to initialize if__main__.__file__
pointed to a file in a nonexistent directory (#696) - Fixed
AssertionError: feed_data after feed_eof
on asyncio when a subprocess is closed early, before its output has been read (#490) - Fixed
TaskInfo.has_pending_cancellation()
on asyncio not respecting shielded scopes (#771; PR by @gschaffner) - Fixed
SocketStream.receive()
returningbytearray
instead ofbytes
when using asyncio withProactorEventLoop
(Windows) (#776) - Fixed quitting the debugger in a pytest test session while in an active task group failing the test instead of exiting the test session (because the exit exception arrives in an exception group)
- Fixed support for Linux abstract namespaces in UNIX sockets that was broken in v4.2 (#781 <#781>_; PR by @tapetersen)
- Fixed
KeyboardInterrupt
(ctrl+c) hanging the asyncio pytest runner
4.4.0
- Added the
BlockingPortalProvider
class to aid with constructing synchronous counterparts to asynchronous interfaces that would otherwise require multiple blocking portals - Added
__slots__
toAsyncResource
so that child classes can use__slots__
(#733; PR by Justin Su) - Added the
TaskInfo.has_pending_cancellation()
method - Fixed erroneous
RuntimeError: called 'started' twice on the same task status
when cancelling a task in a TaskGroup created with thestart()
method before the first checkpoint is reached after callingtask_status.started()
(#706; PR by Dominik Schwabe) - Fixed two bugs with
TaskGroup.start()
on asyncio:- Fixed erroneous
RuntimeError: called 'started' twice on the same task status
when cancelling a task in a TaskGroup created with thestart()
method before the first checkpoint is reached after callingtask_status.started()
(#706; PR by Dominik Schwabe) - Fixed the entire task group being cancelled if a
TaskGroup.start()
call gets cancelled (#685, #710)
- Fixed erroneous
- Fixed a race condition that caused crashes when multiple event loops of the same backend were running in separate threads and simultaneously attempted to use AnyIO for their first time (#425; PR by David Jiricek and Ganden Schaffner)
- Fixed cancellation delivery on asyncio incrementing the wrong cancel scope's cancellation counter when cascading a cancel operation to a child scope, thus failing to uncancel the host task (#716)
- Fixed erroneous
TypedAttributeLookupError
if a typed attribute getter raisesKeyError
- Fixed the asyncio backend not respecting the
PYTHONASYNCIODEBUG
environment variable when setting thedebug
flag inanyio.run()
- Fixed
SocketStream.receive()
not detecting EOF on asyncio if there is also data in the read buffer (#701) - Fixed
MemoryObjectStream
dropping an item if the item is delivered to a recipient that is waiting to receive an item but has a cancellation pending (#728) - Emit a
ResourceWarning
forMemoryObjectReceiveStream
andMemoryObjectSendStream
that were garbage collected without being closed (PR by Andrey Kazantcev) - Fixed
MemoryObjectSendStream.send()
not raisingBrokenResourceError
when the last correspondingMemoryObjectReceiveStream
is closed while waiting to send a falsey item (#731; PR by Ganden Schaffner)
4.3.0
-
Added support for the Python 3.12
walk_up
keyword argument inanyio.Path.relative_to()
(PR by Colin Taylor) -
Fixed passing
total_tokens
toanyio.CapacityLimiter()
as a keyword argument not working on thetrio
backend (#515) -
Fixed
Process.aclose()
not performing the minimum level of necessary cleanup when cancelled. Previously:- Cancellation of
Process.aclose()
could leak an orphan process - Cancellation of
run_process()
could very briefly leak an orphan process. - Cancellation of
Process.aclose()
orrun_process()
on Trio could leave standard streams unclosed
(PR by Ganden Schaffner)
- Cancellation of
-
Fixed
Process.stdin.aclose()
,Process.stdout.aclose()
, andProcess.stderr.aclose()
not including a checkpoint on asyncio (PR by Ganden Schaffner) -
Fixed documentation on how to provide your own typed attributes
4.2.0
-
Add support for
byte
-based paths inconnect_unix
,create_unix_listeners
,create_unix_datagram_socket
, andcreate_connected_unix_datagram_socket
. (PR by Lura Skye) -
Enabled the
Event
andCapacityLimiter
classes to be instantiated outside an event loop thread -
Broadly improved/fixed the type annotations. Among other things, many functions and methods that take variadic positional arguments now make use of PEP 646
TypeVarTuple
to allow the positional arguments to be validated by static type checkers. These changes affected numerous methods and functions, including:anyio.run()
TaskGroup.start_soon()
anyio.from_thread.run()
anyio.from_thread.run_sync()
anyio.to_thread.run_sync()
anyio.to_process.run_sync()
BlockingPortal.call()
BlockingPortal.start_task_soon()
BlockingPortal.start_task()
(also resolves #560)
-
Fixed various type annotations of
anyio.Path
to match Typeshed:anyio.Path.__lt__()
anyio.Path.__le__()
anyio.Path.__gt__()
anyio.Path.__ge__()
anyio.Path.__truediv__()
anyio.Path.__rtruediv__()
anyio.Path.hardlink_to()
anyio.Path.samefile()
anyio.Path.symlink_to()
anyio.Path.with_segments()
(PR by Ganden Schaffner)
-
Fixed adjusting the total number of tokens in a
CapacityLimiter
on asyncio failing to wake up tasks waiting to acquire the limiter in certain edge cases (fixed with help from Egor Blagov) -
Fixed
loop_factory
anduse_uvloop
options not being used on the asyncio backend (#643) -
Fixed cancellation propagating on asyncio from a task group to child tasks if the task hosting the task group is in a shielded cancel scope (#642)
4.1.0
- Adapted to API changes made in Trio v0.23:
- Call
trio.to_thread.run_sync()
using theabandon_on_cancel
keyword argument instead ofcancellable
- Removed a checkpoint when exiting a task group
- Renamed the
cancellable
argument inanyio.to_thread.run_sync()
toabandon_on_cancel
(and deprecated the old parameter name) - Bumped minimum version of Trio to v0.23
- Call
- Added support for voluntary thread cancellation via
anyio.from_thread.check_cancelled()
- Bumped minimum version of trio to v0.23
- Exposed the
ResourceGuard
class in the public API (#627) - Fixed
RuntimeError: Runner is closed
when running higher-scoped async generator fixtures in some cases (#619) - Fixed discrepancy between
asyncio
andtrio
where reraising a cancellation exception in anexcept*
block would incorrectly bubble out of its cancel scope (#634)
4.0.0
- BACKWARDS INCOMPATIBLE Replaced AnyIO's own
ExceptionGroup
class with the PEP 654BaseExceptionGroup
andExceptionGroup
- BACKWARDS INCOMPATIBLE Changes to cancellation semantics:
- Any exceptions raising out of a task groups are now nested inside an
ExceptionGroup
(orBaseExceptionGroup
if one or moreBaseException
were included) - Fixed task group not raising a cancellation exception on asyncio at exit if no child tasks were spawned and an outer cancellation scope had been cancelled before
- Ensured that exiting a
TaskGroup
always hits a yield point, regardless of whether there are running child tasks to be waited on - On asyncio, cancel scopes will defer cancelling tasks that are scheduled to resume with a finished future
- On asyncio and Python 3.9/3.10, cancel scopes now only suppress cancellation exceptions if the cancel message matches the scope
- Task groups on all backends now raise a single cancellation exception when an outer cancel scope is cancelled, and no exceptions other than cancellation exceptions are raised in the group
- Any exceptions raising out of a task groups are now nested inside an
- BACKWARDS INCOMPATIBLE Changes the pytest plugin to run all tests and fixtures in the same task, allowing fixtures to set context variables for tests and other fixtures
- BACKWARDS INCOMPATIBLE Changed
anyio.Path.relative_to()
andanyio.Path.is_relative_to()
to only accept one argument, as passing multiple arguments is deprecated as of Python 3.12 - BACKWARDS INCOMPATIBLE Dropped support for spawning tasks from old-style coroutine functions (
@asyncio.coroutine
) - BACKWARDS INCOMPATIBLE The
policy
option on theasyncio
backend was changed toloop_factory
to accommodateasyncio.Runner
- Changed
anyio.run()
to useasyncio.Runner
(or a back-ported version of it on Pythons older than 3.11) on theasyncio
backend - Dropped support for Python 3.7
- Added support for Python 3.12
- Bumped minimum version of trio to v0.22
- Added the
anyio.Path.is_junction()
andanyio.Path.walk()
methods - Added
create_unix_datagram_socket
andcreate_connected_unix_datagram_socket
to create UNIX datagram sockets (PR by Jean Hominal) - Fixed
from_thread.run
andfrom_thread.run_sync
not setting sniffio on asyncio. As a result:- Fixed
from_thread.run_sync
failing when used to call sniffio-dependent functions on asyncio - Fixed
from_thread.run
failing when used to call sniffio-dependent functions on asyncio from a thread running trio or curio - Fixed deadlock when using
from_thread.start_blocking_portal(backend="asyncio")
in a thread running trio or curio (PR by Ganden Schaffner)
- Fixed
- Improved type annotations:
- The
item_type
argument ofcreate_memory_object_stream
was deprecated. To indicate the item type handled by the stream, usecreate_memory_object_stream[T_Item]()
instead. Type checking should no longer fail when annotating memory object streams with uninstantiable item types (PR by Ganden Schaffner)
- The
- Added the
CancelScope.cancelled_caught
property which tells users if the cancel scope suppressed a cancellation exception - Fixed
fail_after()
raising an unwarrantedTimeoutError
when the cancel scope was cancelled before reaching its deadline - Fixed
MemoryObjectReceiveStream.receive()
causing the receiving task on asyncio to remain in a cancelled state if the operation was cancelled after an item was queued to be received by the task (but before the task could actually receive the item) - Fixed
TaskGroup.start()
on asyncio not responding to cancellation from the outside - Fixed tasks started from
BlockingPortal
not notifying synchronous listeners (concurrent.futures.wait()
) when they're cancelled - Removed unnecessary extra waiting cycle in
Event.wait()
on asyncio in the case where the event was not yet set - Fixed processes spawned by
anyio.to_process()
being "lost" as unusable to the process pool when processes that have idled over 5 minutes are pruned at part of theto_process.run_sync()
call, leading to increased memory consumption (PR by Anael Gorfinkel)
Changes since 4.0.0rc1:
- Fixed the type annotation of
TaskGroup.start_soon()
to accept any awaitables (already in v3.7.0 but was missing from 4.0.0rc1) - Changed
CancelScope
to also consider the cancellation count (in addition to the cancel message) on asyncio to determine if a cancellation exception should be swallowed on scope exit, to combat issues where third party libraries catch theCancelledError
and raise another, thus erasing the original cancel message - Worked around a CPython bug that caused
TLSListener.handle_handshake_error()
on asyncio to log"NoneType: None"
instead of the error (PR by Ganden Schaffner) - Re-added the
item_type
argument tocreate_memory_object_stream()
(but using it raises a deprecation warning and does nothing with regards to the static types of the returned streams) - Fixed processes spawned by
anyio.to_process()
being "lost" as unusable to the process pool when processes that have idled over 5 minutes are pruned at part of theto_process.run_sync()
call, leading to increased memory consumption (PR by Anael Gorfinkel)