========
Trollius
========
.. image:: http://unmaintained.tech/badge.svg
:target: http://unmaintained.tech/
:alt: No Maintenance Intended
.. warning::
The Trollius project is deprecated and unsupported. It is on PyPI
to support existing dependencies only.
=========
Changes
=========
.. warning::
The Trollius project is now deprecated!
2.2.1 (2021-04-28)
==================
- Properly reraise socket.error with an errno of EBADF as an OSError.
2.2.post1 (2019-07-29)
======================
This is a packaging-only release. It is intended to be the last
release.
- Release Windows wheels for CPython 2.7.
- Use ``python_requires`` to restrict installation to Python 2.7.
Version 2.2 (2018-03-09)
========================
Changes:
* ``run_aiotest.py`` has been removed since the ``aiotest`` project has been
removed
* Add the "No Maintenance Intended" badge to README
* The Trollius documentation is no longer online:
http://trollius.readthedocs.io/ has been removed
* Update the GitHub URL to: https://github.com/vstinner/trollius
Version 2.1 (2016-02-05)
========================
Changes:
* The Trollius project is now deprecated.
* Ugly hack to support Python 3.5 with the PEP 479. asyncio coroutines are
not supported on Python 3.5.
* Better exception traceback. Patch written by Dhawal Yogesh Bhanushali.
* Drop support for Python 2.6 and 3.2.
* Fix tests on Windows with Python 2. Patch written by Gabi Davar.
Version 2.0 (2015-07-13)
========================
Summary:
* SSL support on Windows for proactor event loop with Python 3.5 and newer
* Many race conditions were fixed in the proactor event loop
* Trollius moved to Github and the fork was recreated on top to asyncio git
repository
* Many resource leaks (ex: unclosed sockets) were fixed
* Optimization of socket connections: avoid: don't call the slow getaddrinfo()
function to ensure that the address is already resolved. The check is now
only done in debug mode.
The Trollius project moved from Bitbucket to Github. The project is now a fork
of the Git repository of the asyncio project (previously called the "tulip"
project), the trollius source code lives in the trollius branch.
The new Trollius home page is now: https://github.com/haypo/trollius
The asyncio project moved to: https://github.com/python/asyncio
Note: the PEP 492 is not supported in trollius yet.
API changes:
* Issue #234: Drop JoinableQueue on Python 3.5+
* add the asyncio.ensure_future() function, previously called async().
The async() function is now deprecated.
* New event loop methods: set_task_factory() and get_task_factory().
* Python issue #23347: Make BaseSubprocessTransport.wait() private.
* Python issue #23347: send_signal(), kill() and terminate() methods of
BaseSubprocessTransport now check if the transport was closed and if the
process exited.
* Python issue #23209, #23225: selectors.BaseSelector.get_key() now raises a
RuntimeError if the selector is closed. And selectors.BaseSelector.close()
now clears its internal reference to the selector mapping to break a
reference cycle. Initial patch written by Martin Richard.
* PipeHandle.fileno() of asyncio.windows_utils now raises an exception if the
pipe is closed.
* Remove Overlapped.WaitNamedPipeAndConnect() of the _overlapped module,
it is no more used and it had issues.
* Python issue #23537: Remove 2 unused private methods of
BaseSubprocessTransport: _make_write_subprocess_pipe_proto,
_make_read_subprocess_pipe_proto. Methods only raise NotImplementedError and
are never used.
* Remove unused SSLProtocol._closing attribute
New SSL implementation:
* Python issue #22560: On Python 3.5 and newer, use new SSL implementation
based on ssl.MemoryBIO instead of the legacy SSL implementation. Patch
written by Antoine Pitrou, based on the work of Geert Jansen.
* If available, the new SSL implementation can be used by ProactorEventLoop to
support SSL.
Enhance, fix and cleanup the IocpProactor:
* Python issue #23293: Rewrite IocpProactor.connect_pipe(). Add
_overlapped.ConnectPipe() which tries to connect to the pipe for asynchronous
I/O (overlapped): call CreateFile() in a loop until it doesn't fail with
ERROR_PIPE_BUSY. Use an increasing delay between 1 ms and 100 ms.
* Tulip issue #204: Fix IocpProactor.accept_pipe().
Overlapped.ConnectNamedPipe() now returns a boolean: True if the pipe is
connected (if ConnectNamedPipe() failed with ERROR_PIPE_CONNECTED), False if
the connection is in progress.
* Tulip issue #204: Fix IocpProactor.recv(). If ReadFile() fails with
ERROR_BROKEN_PIPE, the operation is not pending: don't register the
overlapped.
* Python issue #23095: Rewrite _WaitHandleFuture.cancel().
_WaitHandleFuture.cancel() now waits until the wait is cancelled to clear its
reference to the overlapped object. To wait until the cancellation is done,
UnregisterWaitEx() is used with an event instead of UnregisterWait().
* Python issue #23293: Rewrite IocpProactor.connect_pipe() as a coroutine. Use
a coroutine with asyncio.sleep() instead of call_later() to ensure that the
scheduled call is cancelled.
* Fix ProactorEventLoop.start_serving_pipe(). If a client was connected before
the server was closed: drop the client (close the pipe) and exit
* Python issue #23293: Cleanup IocpProactor.close(). The special case for
connect_pipe() is no more needed. connect_pipe() doesn't use overlapped
operations anymore.
* IocpProactor.close(): don't cancel futures which are already cancelled
* Enhance (fix) BaseProactorEventLoop._loop_self_reading(). Handle correctly
CancelledError: just exit. On error, log the exception and exit; don't try to
close the event loop (it doesn't work).
Bug fixes:
* Fix LifoQueue's and PriorityQueue's put() and task_done().
* Issue #222: Fix the @coroutine decorator for functions without __name__
attribute like functools.partial(). Enhance also the representation of a
CoroWrapper if the coroutine function is a functools.partial().
* Python issue #23879: SelectorEventLoop.sock_connect() must not call connect()
again if the first call to connect() raises an InterruptedError. When the C
function connect() fails with EINTR, the connection runs in background. We
have to wait until the socket becomes writable to be notified when the
connection succeed or fails.
* Fix _SelectorTransport.__repr__() if the event loop is closed
* Fix repr(BaseSubprocessTransport) if it didn't start yet
* Workaround CPython bug #23353. Don't use yield/yield-from in an except block
of a generator. Store the exception and handle it outside the except block.
* Fix BaseSelectorEventLoop._accept_connection(). Close the transport on error.
In debug mode, log errors using call_exception_handler().
* Fix _UnixReadPipeTransport and _UnixWritePipeTransport. Only start reading
when connection_made() has been called.
* Fix _SelectorSslTransport.close(). Don't call protocol.connection_lost() if
protocol.connection_made() was not called yet: if the SSL handshake failed or
is still in progress. The close() method can be called if the creation of the
connection is cancelled, by a timeout for example.
* Fix _SelectorDatagramTransport constructor. Only start reading after
connection_made() has been called.
* Fix _SelectorSocketTransport constructor. Only start reading when
connection_made() has been called: protocol.data_received() must not be
called before protocol.connection_made().
* Fix SSLProtocol.eof_received(). Wake-up the waiter if it is not done yet.
* Close transports on error. Fix create_datagram_endpoint(),
connect_read_pipe() and connect_write_pipe(): close the transport if the task
is cancelled or on error.
* Close the transport on subprocess creation failure
* Fix _ProactorBasePipeTransport.close(). Set the _read_fut attribute to None
after cancelling it.
* Python issue #23243: Fix _UnixWritePipeTransport.close(). Do nothing if the
transport is already closed. Before it was not possible to close the
transport twice.
* Python issue #23242: SubprocessStreamProtocol now closes the subprocess
transport at subprocess exit. Clear also its reference to the transport.
* Fix BaseEventLoop._create_connection_transport(). Close the transport if the
creation of the transport (if the waiter) gets an exception.
* Python issue #23197: On SSL handshake failure, check if the waiter is
cancelled before setting its exception.
* Python issue #23173: Fix SubprocessStreamProtocol.connection_made() to handle
cancelled waiter.
* Python issue #23173: If an exception is raised during the creation of a
subprocess, kill the subprocess (close pipes, kill and read the return
status). Log an error in such case.
* Python issue #23209: Break some reference cycles in asyncio. Patch written by
Martin Richard.
Optimization:
* Only call _check_resolved_address() in debug mode. _check_resolved_address()
is implemented with getaddrinfo() which is slow. If available, use
socket.inet_pton() instead of socket.getaddrinfo(), because it is much faster
Other changes:
* Python issue #23456: Add missing @coroutine decorators
* Python issue #23475: Fix test_close_kill_running(). Really kill the child
process, don't mock completly the Popen.kill() method. This change fix memory
leaks and reference leaks.
* BaseSubprocessTransport: repr() mentions when the child process is running
* BaseSubprocessTransport.close() doesn't try to kill the process if it already
finished.
* Tulip issue #221: Fix docstring of QueueEmpty and QueueFull
* Fix subprocess_attach_write_pipe example. Close the transport, not directly
the pipe.
* Python issue #23347: send_signal(), terminate(), kill() don't check if the
transport was closed. The check broken a Tulip example and this limitation is
arbitrary. Check if _proc is None should be enough. Enhance also close(): do
nothing when called the second time.
* Python issue #23347: Refactor creation of subprocess transports.
* Python issue #23243: On Python 3.4 and newer, emit a ResourceWarning when an
event loop or a transport is not explicitly closed
* tox.ini: enable ResourceWarning warnings
* Python issue #23243: test_sslproto: Close explicitly transports
* SSL transports now clear their reference to the waiter.
* Python issue #23208: Add BaseEventLoop._current_handle. In debug mode,
BaseEventLoop._run_once() now sets the BaseEventLoop._current_handle
attribute to the handle currently executed.
* Replace test_selectors.py with the file of Python 3.5 adapted for asyncio and
Python 3.3.
* Tulip issue #184: FlowControlMixin constructor now get the event loop if the
loop parameter is not set.
* _ProactorBasePipeTransport now sets the _sock attribute to None when the
transport is closed.
* Python issue #23219: cancelling wait_for() now cancels the task
* Python issue #23243: Close explicitly event loops and transports in tests
* Python issue #23140: Fix cancellation of Process.wait(). Check the state of
the waiter future before setting its result.
* Python issue #23046: Expose the BaseEventLoop class in the asyncio namespace
* Python issue #22926: In debug mode, call_soon(), call_at() and call_later()
methods of BaseEventLoop now use the identifier of the current thread to
ensure that they are called from the thread running the event loop. Before,
the get_event_loop() method was used to check the thread, and no exception
was raised when the thread had no event loop. Now the methods always raise an
exception in debug mode when called from the wrong thread. It should help to
notice misusage of the API.
2014-12-19: Version 1.0.4
=========================
Changes:
* Python issue #22922: create_task(), call_at(), call_soon(),
call_soon_threadsafe() and run_in_executor() now raise an error if the event
loop is closed. Initial patch written by Torsten Landschoff.
* Python issue #22921: Don't require OpenSSL SNI to pass hostname to ssl
functions. Patch by Donald Stufft.
* Add run_aiotest.py: run the aiotest test suite.
* tox now also run the aiotest test suite
* Python issue #23074: get_event_loop() now raises an exception if the thread
has no event loop even if assertions are disabled.
Bugfixes:
* Fix a race condition in BaseSubprocessTransport._try_finish(): ensure that
connection_made() is called before connection_lost().
* Python issue #23009: selectors, make sure EpollSelecrtor.select() works when
no file descriptor is registered.
* Python issue #22922: Fix ProactorEventLoop.close(). Call
_stop_accept_futures() before sestting the _closed attribute, otherwise
call_soon() raises an error.
* Python issue #22429: Fix EventLoop.run_until_complete(), don't stop the event
loop if a BaseException is raised, because the event loop is already stopped.
* Initialize more Future and Task attributes in the class definition to avoid
attribute errors in destructors.
* Python issue #22685: Set the transport of stdout and stderr StreamReader
objects in the SubprocessStreamProtocol. It allows to pause the transport to
not buffer too much stdout or stderr data.
* BaseSelectorEventLoop.close() now closes the self-pipe before calling the
parent close() method. If the event loop is already closed, the self-pipe is
not unregistered from the selector.
2014-10-20: Version 1.0.3
=========================
Changes:
* On Python 2 in debug mode, Future.set_exception() now stores the traceback
object of the exception in addition to the exception object. When a task
waiting for another task and the other task raises an exception, the
traceback object is now copied with the exception. Be careful, storing the
traceback object may create reference leaks.
* Use ssl.create_default_context() if available to create the default SSL
context: Python 2.7.9 and newer, or Python 3.4 and newer.
* On Python 3.5 and newer, reuse socket.socketpair() in the windows_utils
submodule.
* On Python 3.4 and newer, use os.set_inheritable().
* Enhance protocol representation: add "closed" or "closing" info.
* run_forever() now consumes BaseException of the temporary task. If the
coroutine raised a BaseException, consume the exception to not log a warning.
The caller doesn't have access to the local task.
* Python issue 22448: cleanup _run_once(), only iterate once to remove delayed
calls that were cancelled.
* The destructor of the Return class now shows where the Return object was
created.
* run_tests.py doesn't catch any exceptions anymore when loading tests, only
catch SkipTest.
* Fix (SSL) tests for the future Python 2.7.9 which includes a "new" ssl
module: module backported from Python 3.5.
* BaseEventLoop.add_signal_handler() now raises an exception if the parameter
is a coroutine function.
* Coroutine functions and objects are now rejected with a TypeError by the
following functions: add_signal_handler(), call_at(), call_later(),
call_soon(), call_soon_threadsafe(), run_in_executor().
2014-10-02: Version 1.0.2
=========================
This release fixes bugs. It also provides more information in debug mode on
error.
Major changes:
* Tulip issue #203: Add _FlowControlMixin.get_write_buffer_limits() method.
* Python issue #22063: socket operations (socket,recv, sock_sendall,
sock_connect, sock_accept) of SelectorEventLoop now raise an exception in
debug mode if sockets are in blocking mode.
Major bugfixes:
* Tulip issue #205: Fix a race condition in BaseSelectorEventLoop.sock_connect().
* Tulip issue #201: Fix a race condition in wait_for(). Don't raise a
TimeoutError if we reached the timeout and the future completed in the same
iteration of the event loop. A side effect of the bug is that Queue.get()
looses items.
* PipeServer.close() now cancels the "accept pipe" future which cancels the
overlapped operation.
Other changes:
* Python issue #22448: Improve cancelled timer callback handles cleanup. Patch
by Joshua Moore-Oliva.
* Python issue #22369: Change "context manager protocol" to "context management
protocol". Patch written by Serhiy Storchaka.
* Tulip issue #206: In debug mode, keep the callback in the representation of
Handle and TimerHandle after cancel().
* Tulip issue #207: Fix test_tasks.test_env_var_debug() to use correct asyncio
module.
* runtests.py: display a message to mention if tests are run in debug or
release mode
* Tulip issue #200: Log errors in debug mode instead of simply ignoring them.
* Tulip issue #200: _WaitHandleFuture._unregister_wait() now catchs and logs
exceptions.
* _fatal_error() method of _UnixReadPipeTransport and _UnixWritePipeTransport
now log all exceptions in debug mode
* Fix debug log in BaseEventLoop.create_connection(): get the socket object
from the transport because SSL transport closes the old socket and creates a
new SSL socket object.
* Remove the _SelectorSslTransport._rawsock attribute: it contained the closed
socket (not very useful) and it was not used.
* Fix _SelectorTransport.__repr__() if the transport was closed
* Use the new os.set_blocking() function of Python 3.5 if available
2014-07-30: Version 1.0.1
=========================
This release supports PyPy and has a better support of asyncio coroutines,
especially in debug mode.
Changes:
* Tulip issue #198: asyncio.Condition now accepts an optional lock object.
* Enhance representation of Future and Future subclasses: add "created at".
Bugfixes:
* Fix Trollius issue #9: @trollius.coroutine now works on callbable objects
(without ``__name__`` attribute), not only on functions.
* Fix Trollius issue #13: asyncio futures are now accepted in all functions:
as_completed(), async(), @coroutine, gather(), run_until_complete(),
wrap_future().
* Fix support of asyncio coroutines in debug mode. If the last instruction
of the coroutine is "yield from", it's an asyncio coroutine and it does not
need to use From().
* Fix and enhance _WaitHandleFuture.cancel():
- Tulip issue #195: Fix a crash on Windows: don't call UnregisterWait() twice
if a _WaitHandleFuture is cancelled twice.
- Fix _WaitHandleFuture.cancel(): return the result of the parent cancel()
method (True or False).
- _WaitHandleFuture.cancel() now notify IocpProactor through the overlapped
object that the wait was cancelled.
* Tulip issue #196: _OverlappedFuture now clears its reference to the
overlapped object. IocpProactor keeps a reference to the overlapped object
until it is notified of its completion. Log also an error in debug mode if it
gets unexpected notifications.
* Fix runtest.py to be able to log at level DEBUG.
Other changes:
* BaseSelectorEventLoop._write_to_self() now logs errors in debug mode.
* Fix as_completed(): it's not a coroutine, don't use ``yield From(...)`` but
``yield ...``
* Tulip issue #193: Convert StreamWriter.drain() to a classic coroutine.
* Tulip issue #194: Don't use sys.getrefcount() in unit tests: the full test
suite now pass on PyPy.
2014-07-21: Version 1.0
=======================
Major Changes
-------------
* Event loops have a new ``create_task()`` method, which is now the recommanded
way to create a task object. This method can be overriden by third-party
event loops to use their own task class.
* The debug mode has been improved a lot. Set ``TROLLIUSDEBUG`` envrironment
variable to ``1`` and configure logging to log at level ``logging.DEBUG``
(ex: ``logging.basicConfig(level=logging.DEBUG)``). Changes:
- much better representation of Trollius objects (ex: ``repr(task)``):
unified ``<Class arg1 arg2 ...>`` format, use qualified name when available
- show the traceback where objects were created
- show the current filename and line number for coroutine
- show the filename and line number where objects were created
- log most important socket events
- log most important subprocess events
* ``Handle.cancel()`` now clears references to callback and args
* Log an error if a Task is destroyed while it is still pending, but only on
Python 3.4 and newer.
* Fix for asyncio coroutines when passing tuple value in debug mode.
``CoroWrapper.send()`` now checks if it is called from a "yield from"
generator to decide if the parameter should be unpacked or not.
* ``Process.communicate()`` now ignores ``BrokenPipeError`` and
``ConnectionResetError`` exceptions.
* Rewrite signal handling on Python 3.3 and newer to fix a race condition: use
the "self-pipe" to get signal numbers.
Other Changes
-------------
* Fix ``ProactorEventLoop()`` in debug mode
* Fix a race condition when setting the result of a Future with
``call_soon()``. Add an helper, a private method, to set the result only if
the future was not cancelled.
* Fix ``asyncio.__all__``: export also ``unix_events`` and ``windows_events``
symbols. For example, on Windows, it was not possible to get
``ProactorEventLoop`` or ``DefaultEventLoopPolicy`` using ``from asyncio
import *``.
* ``Handle.cancel()`` now clears references to callback and args
* Make Server attributes and methods private, the sockets attribute remains
public.
* BaseEventLoop.create_datagram_endpoint() now waits until
protocol.connection_made() has been called. Document also why transport
constructors use a waiter.
* _UnixSubprocessTransport: fix file mode of stdin: open stdin in write mode,
not in read mode.
2014-06-23: version 0.4
=======================
Changes between Trollius 0.3 and 0.4:
* Trollius event loop now supports asyncio coroutines:
- Trollius coroutines can yield asyncio coroutines,
- asyncio coroutines can yield Trollius coroutines,
- asyncio.set_event_loop() accepts a Trollius event loop,
- asyncio.set_event_loop_policy() accepts a Trollius event loop policy.
* The ``PYTHONASYNCIODEBUG`` envrionment variable has been renamed to
``TROLLIUSDEBUG``. The environment variable is now used even if the Python
command line option ``-E`` is used.
* Synchronize with Tulip.
* Support PyPy (fix subproces, fix unit tests).
Tulip changes:
* Tulip issue #171: BaseEventLoop.close() now raises an exception if the event
loop is running. You must first stop the event loop and then wait until it
stopped, before closing it.
* Tulip issue #172: only log selector timing in debug mode
* Enable the debug mode of event loops when the ``TROLLIUSDEBUG`` environment
variable is set
* BaseEventLoop._assert_is_current_event_loop() now only raises an exception if
the current loop is set.
* Tulip issue #105: in debug mode, log callbacks taking more than 100 ms to be
executed.
* Python issue 21595: ``BaseSelectorEventLoop._read_from_self()`` reads all
available bytes from the "self pipe", not only a single byte. This change
reduces the risk of having the pipe full and so getting the "BlockingIOError:
[Errno 11] Resource temporarily unavailable" message.
* Python issue 21723: asyncio.Queue: support any type of number (ex: float) for
the maximum size. Patch written by Vajrasky Kok.
* Issue #173: Enhance repr(Handle) and repr(Task): add the filename and line
number, when available. For task, the current line number of the coroutine
is used.
* Add BaseEventLoop.is_closed() method. run_forever() and run_until_complete()
methods now raises an exception if the event loop was closed.
* Make sure that socketpair() close sockets on error. Close the listening
socket if sock.bind() raises an exception.
* Fix ResourceWarning: close sockets on errors.
BaseEventLoop.create_connection(), BaseEventLoop.create_datagram_endpoint()
and _UnixSelectorEventLoop.create_unix_server() now close the newly created
socket on error.
* Rephrase and fix docstrings.
* Fix tests on Windows: wait for the subprocess exit. Before, regrtest failed
to remove the temporary test directory because the process was still running
in this directory.
* Refactor unit tests.
On Python 3.5, generators now get their name from the function, no more from
the code. So the ``@coroutine`` decorator doesn't loose the original name of
the function anymore.
2014-05-26: version 0.3
=======================
Rename the Python module ``asyncio`` to ``trollius`` to support Python 3.4. On
Python 3.4, there is already a module called ``asyncio`` in the standard
library which conflicted with ``asyncio`` module of Trollius 0.2. To write
asyncio code working on Trollius and Tulip, use ``import trollius as asyncio``.
Changes between Trollius 0.2 and 0.3:
* Synchronize with Tulip 3.4.1.
* Enhance Trollius documentation.
* Trollius issue #7: Fix ``asyncio.time_monotonic`` on Windows older than
Vista (ex: Windows 2000 and Windows XP).
* Fedora packages have been accepted.
Changes between Tulip 3.4.0 and 3.4.1:
* Pull in Solaris ``devpoll`` support by Giampaolo Rodola
(``trollius.selectors`` module).
* Add options ``-r`` and ``--randomize`` to runtests.py to randomize test
order.
* Add a simple echo client/server example.
* Tulip issue #166: Add ``__weakref__`` slots to ``Handle`` and
``CoroWrapper``.
* ``EventLoop.create_unix_server()`` now raises a ``ValueError`` if path and
sock are specified at the same time.
* Ensure ``call_soon()``, ``call_later()`` and ``call_at()`` are invoked on
current loop in debug mode. Raise a ``RuntimeError`` if the event loop of the
current thread is different. The check should help to debug thread-safetly
issue. Patch written by David Foster.
* Tulip issue #157: Improve test_events.py, avoid ``run_briefly()`` which is
not reliable.
* Reject add/remove reader/writer when event loop is closed.
Bugfixes of Tulip 3.4.1:
* Tulip issue #168: ``StreamReader.read(-1)`` from pipe may hang if
data exceeds buffer limit.
* CPython issue #21447: Fix a race condition in
``BaseEventLoop._write_to_self()``.
* Different bugfixes in ``CoroWrapper`` of ``trollius.coroutines``, class used
when running Trollius in debug mode:
- Fix ``CoroWrapper`` to workaround yield-from bug in CPython 3.4.0. The
CPython bug is now fixed in CPython 3.4.1 and 3.5.
- Make sure ``CoroWrapper.send`` proxies one argument correctly.
- CPython issue #21340: Be careful accessing instance variables in ``__del__``.
- Tulip issue #163: Add ``gi_{frame,running,code}`` properties to
``CoroWrapper``.
* Fix ``ResourceWarning`` warnings
* Tulip issue #159: Fix ``windows_utils.socketpair()``. Use ``"127.0.0.1"``
(IPv4) or ``"::1"`` (IPv6) host instead of ``"localhost"``, because
``"localhost"`` may be a different IP address. Reject also invalid arguments:
only ``AF_INET`` and ``AF_INET6`` with ``SOCK_STREAM`` (and ``proto=0``) are
supported.
* Tulip issue #158: ``Task._step()`` now also sets ``self`` to ``None`` if an
exception is raised. ``self`` is set to ``None`` to break a reference cycle.
2014-03-04: version 0.2
=======================
Trollius now uses ``yield From(...)`` syntax which looks close to Tulip ``yield
from ...`` and allows to port more easily Trollius code to Tulip. The usage of
``From()`` is not mandatory yet, but it may become mandatory in a future
version. However, if ``yield`` is used without ``From``, an exception is
raised if the event loop is running in debug mode.
Major changes:
* Replace ``yield ...`` syntax with ``yield From(...)``
* On Python 2, Future.set_exception() now only saves the traceback if the debug
mode of the event loop is enabled for best performances in production mode.
Use ``loop.set_debug(True)`` to save the traceback.
Bugfixes:
* Fix ``BaseEventLoop.default_exception_handler()`` on Python 2: get the
traceback from ``sys.exc_info()``
* Fix unit tests on SSL sockets on Python older than 2.6.6. Example:
Mac OS 10.6 with Python 2.6.1 or OpenIndiana 148 with Python 2.6.4.
* Fix error handling in the asyncio.time_monotonic module
* Fix acquire() method of Lock, Condition and Semaphore: don't return a context
manager but True, as Tulip. Task._step() now does the trick.
Other changes:
* tox.ini: set PYTHONASYNCIODEBUG to 1 to run tests
2014-02-25: version 0.1.6
=========================
Trollius changes:
* Add a new Sphinx documentation:
https://trollius.readthedocs.io/
* tox: pass posargs to nosetests. Patch contributed by Ian Wienand.
* Fix support of Python 3.2 and add py32 to tox.ini
* Merge with Tulip 0.4.1
Major changes of Tulip 0.4.1:
* Issue #81: Add support for UNIX Domain Sockets. New APIs:
- loop.create_unix_connection()
- loop.create_unix_server()
- streams.open_unix_connection()
- streams.start_unix_server()
* Issue #80: Add new event loop exception handling API. New APIs:
- loop.set_exception_handler()
- loop.call_exception_handler()
- loop.default_exception_handler()
* Issue #136: Add get_debug() and set_debug() methods to BaseEventLoopTests.
Add also a ``PYTHONASYNCIODEBUG`` environment variable to debug coroutines
since Python startup, to be able to debug coroutines defined directly in the
asyncio module.
Other changes of Tulip 0.4.1:
* asyncio.subprocess: Fix a race condition in communicate()
* Fix _ProactorWritePipeTransport._pipe_closed()
* Issue #139: Improve error messages on "fatal errors".
* Issue #140: WriteTransport.set_write_buffer_size() to call
_maybe_pause_protocol()
* Issue #129: BaseEventLoop.sock_connect() now raises an error if the address
is not resolved (hostname instead of an IP address) for AF_INET and
AF_INET6 address families.
* Issue #131: as_completed() and wait() now raises a TypeError if the list of
futures is not a list but a Future, Task or coroutine object
* Python issue #20495: Skip test_read_pty_output() of test_asyncio on FreeBSD
older than FreeBSD 8
* Issue #130: Add more checks on subprocess_exec/subprocess_shell parameters
* Issue #126: call_soon(), call_soon_threadsafe(), call_later(), call_at()
and run_in_executor() now raise a TypeError if the callback is a coroutine
function.
* Python issue #20505: BaseEventLoop uses again the resolution of the clock
to decide if scheduled tasks should be executed or not.
2014-02-10: version 0.1.5
=========================
- Merge with Tulip 0.3.1:
* New asyncio.subprocess module
* _UnixWritePipeTransport now also supports character devices, as
_UnixReadPipeTransport. Patch written by Jonathan Slenders.
* StreamReader.readexactly() now raises an IncompleteReadError if the
end of stream is reached before we received enough bytes, instead of
returning less bytes than requested.
* poll and epoll selectors now round the timeout away from zero (instead of
rounding towards zero) to fix a performance issue
* asyncio.queue: Empty renamed to QueueEmpty, Full to QueueFull
* _fatal_error() of _UnixWritePipeTransport and _ProactorBasePipeTransport
don't log BrokenPipeError nor ConnectionResetError
* Future.set_exception(exc) now instanciate exc if it is a class
* streams.StreamReader: Use bytearray instead of deque of bytes for internal
buffer
- Fix test_wait_for() unit test
2014-01-22: version 0.1.4
=========================
- The project moved to https://bitbucket.org/enovance/trollius
- Fix CoroWrapper (_DEBUG=True): add missing import
- Emit a warning when Return is not raised
- Merge with Tulip to get latest Tulip bugfixes
- Fix dependencies in tox.ini for the different Python versions
2014-01-13: version 0.1.3
=========================
- Workaround bugs in the ssl module of Python older than 2.6.6. For example,
Mac OS 10.6 (Snow Leopard) uses Python 2.6.1.
- ``return x, y`` is now written ``raise Return(x, y)`` instead of
``raise Return((x, y))``
- Support "with (yield lock):" syntax for Lock, Condition and Semaphore
- SSL support is now optional: don't fail if the ssl module is missing
- Add tox.ini, tool to run unit tests. For example, "tox -e py27" creates a
virtual environment to run tests with Python 2.7.
2014-01-08: version 0.1.2
=========================
- Trollius now supports CPython 2.6-3.4, PyPy and Windows. All unit tests
pass with CPython 2.7 on Linux.
- Fix Windows support. Fix compilation of the _overlapped module and add a
asyncio._winapi module (written in pure Python). Patch written by Marc
Schlaich.
- Support Python 2.6: require an extra dependency,
ordereddict (and unittest2 for unit tests)
- Support Python 3.2, 3.3 and 3.4
- Support PyPy 2.2
- Don't modify __builtins__ nor the ssl module to inject backported exceptions
like BlockingIOError or SSLWantReadError. Exceptions are available in the
asyncio module, ex: asyncio.BlockingIOError.
2014-01-06: version 0.1.1
=========================
- Fix asyncio.time_monotonic on Mac OS X
- Fix create_connection(ssl=True)
- Don't export backported SSLContext in the ssl module anymore to not confuse
libraries testing hasattr(ssl, "SSLContext")
- Relax dependency on the backported concurrent.futures module: use a
synchronous executor if the module is missing
2014-01-04: version 0.1
=======================
- First public release
Raw data
{
"_id": null,
"home_page": "https://github.com/jamadden/trollius",
"name": "trollius",
"maintainer": "",
"docs_url": null,
"requires_python": ">=2.7, < 3",
"maintainer_email": "",
"keywords": "Deprecated Unmaintained asyncio backport",
"author": "Victor Stinner",
"author_email": "victor.stinner@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/9f/f8/b6ecbbd907997b039b8ca5a1d27b1f8f76fbc301c2dafe540dbb95811591/trollius-2.2.1.tar.gz",
"platform": "",
"description": "========\nTrollius\n========\n\n.. image:: http://unmaintained.tech/badge.svg\n :target: http://unmaintained.tech/\n :alt: No Maintenance Intended\n\n.. warning::\n The Trollius project is deprecated and unsupported. It is on PyPI\n to support existing dependencies only.\n\n\n=========\n Changes\n=========\n\n.. warning::\n The Trollius project is now deprecated!\n\n\n2.2.1 (2021-04-28)\n==================\n\n- Properly reraise socket.error with an errno of EBADF as an OSError.\n\n2.2.post1 (2019-07-29)\n======================\n\nThis is a packaging-only release. It is intended to be the last\nrelease.\n\n- Release Windows wheels for CPython 2.7.\n- Use ``python_requires`` to restrict installation to Python 2.7.\n\nVersion 2.2 (2018-03-09)\n========================\n\nChanges:\n\n* ``run_aiotest.py`` has been removed since the ``aiotest`` project has been\n removed\n* Add the \"No Maintenance Intended\" badge to README\n* The Trollius documentation is no longer online:\n http://trollius.readthedocs.io/ has been removed\n* Update the GitHub URL to: https://github.com/vstinner/trollius\n\nVersion 2.1 (2016-02-05)\n========================\n\nChanges:\n\n* The Trollius project is now deprecated.\n* Ugly hack to support Python 3.5 with the PEP 479. asyncio coroutines are\n not supported on Python 3.5.\n* Better exception traceback. Patch written by Dhawal Yogesh Bhanushali.\n* Drop support for Python 2.6 and 3.2.\n* Fix tests on Windows with Python 2. Patch written by Gabi Davar.\n\n\nVersion 2.0 (2015-07-13)\n========================\n\nSummary:\n\n* SSL support on Windows for proactor event loop with Python 3.5 and newer\n* Many race conditions were fixed in the proactor event loop\n* Trollius moved to Github and the fork was recreated on top to asyncio git\n repository\n* Many resource leaks (ex: unclosed sockets) were fixed\n* Optimization of socket connections: avoid: don't call the slow getaddrinfo()\n function to ensure that the address is already resolved. The check is now\n only done in debug mode.\n\nThe Trollius project moved from Bitbucket to Github. The project is now a fork\nof the Git repository of the asyncio project (previously called the \"tulip\"\nproject), the trollius source code lives in the trollius branch.\n\nThe new Trollius home page is now: https://github.com/haypo/trollius\n\nThe asyncio project moved to: https://github.com/python/asyncio\n\nNote: the PEP 492 is not supported in trollius yet.\n\nAPI changes:\n\n* Issue #234: Drop JoinableQueue on Python 3.5+\n* add the asyncio.ensure_future() function, previously called async().\n The async() function is now deprecated.\n* New event loop methods: set_task_factory() and get_task_factory().\n* Python issue #23347: Make BaseSubprocessTransport.wait() private.\n* Python issue #23347: send_signal(), kill() and terminate() methods of\n BaseSubprocessTransport now check if the transport was closed and if the\n process exited.\n* Python issue #23209, #23225: selectors.BaseSelector.get_key() now raises a\n RuntimeError if the selector is closed. And selectors.BaseSelector.close()\n now clears its internal reference to the selector mapping to break a\n reference cycle. Initial patch written by Martin Richard.\n* PipeHandle.fileno() of asyncio.windows_utils now raises an exception if the\n pipe is closed.\n* Remove Overlapped.WaitNamedPipeAndConnect() of the _overlapped module,\n it is no more used and it had issues.\n* Python issue #23537: Remove 2 unused private methods of\n BaseSubprocessTransport: _make_write_subprocess_pipe_proto,\n _make_read_subprocess_pipe_proto. Methods only raise NotImplementedError and\n are never used.\n* Remove unused SSLProtocol._closing attribute\n\nNew SSL implementation:\n\n* Python issue #22560: On Python 3.5 and newer, use new SSL implementation\n based on ssl.MemoryBIO instead of the legacy SSL implementation. Patch\n written by Antoine Pitrou, based on the work of Geert Jansen.\n* If available, the new SSL implementation can be used by ProactorEventLoop to\n support SSL.\n\nEnhance, fix and cleanup the IocpProactor:\n\n* Python issue #23293: Rewrite IocpProactor.connect_pipe(). Add\n _overlapped.ConnectPipe() which tries to connect to the pipe for asynchronous\n I/O (overlapped): call CreateFile() in a loop until it doesn't fail with\n ERROR_PIPE_BUSY. Use an increasing delay between 1 ms and 100 ms.\n* Tulip issue #204: Fix IocpProactor.accept_pipe().\n Overlapped.ConnectNamedPipe() now returns a boolean: True if the pipe is\n connected (if ConnectNamedPipe() failed with ERROR_PIPE_CONNECTED), False if\n the connection is in progress.\n* Tulip issue #204: Fix IocpProactor.recv(). If ReadFile() fails with\n ERROR_BROKEN_PIPE, the operation is not pending: don't register the\n overlapped.\n* Python issue #23095: Rewrite _WaitHandleFuture.cancel().\n _WaitHandleFuture.cancel() now waits until the wait is cancelled to clear its\n reference to the overlapped object. To wait until the cancellation is done,\n UnregisterWaitEx() is used with an event instead of UnregisterWait().\n* Python issue #23293: Rewrite IocpProactor.connect_pipe() as a coroutine. Use\n a coroutine with asyncio.sleep() instead of call_later() to ensure that the\n scheduled call is cancelled.\n* Fix ProactorEventLoop.start_serving_pipe(). If a client was connected before\n the server was closed: drop the client (close the pipe) and exit\n* Python issue #23293: Cleanup IocpProactor.close(). The special case for\n connect_pipe() is no more needed. connect_pipe() doesn't use overlapped\n operations anymore.\n* IocpProactor.close(): don't cancel futures which are already cancelled\n* Enhance (fix) BaseProactorEventLoop._loop_self_reading(). Handle correctly\n CancelledError: just exit. On error, log the exception and exit; don't try to\n close the event loop (it doesn't work).\n\nBug fixes:\n\n* Fix LifoQueue's and PriorityQueue's put() and task_done().\n* Issue #222: Fix the @coroutine decorator for functions without __name__\n attribute like functools.partial(). Enhance also the representation of a\n CoroWrapper if the coroutine function is a functools.partial().\n* Python issue #23879: SelectorEventLoop.sock_connect() must not call connect()\n again if the first call to connect() raises an InterruptedError. When the C\n function connect() fails with EINTR, the connection runs in background. We\n have to wait until the socket becomes writable to be notified when the\n connection succeed or fails.\n* Fix _SelectorTransport.__repr__() if the event loop is closed\n* Fix repr(BaseSubprocessTransport) if it didn't start yet\n* Workaround CPython bug #23353. Don't use yield/yield-from in an except block\n of a generator. Store the exception and handle it outside the except block.\n* Fix BaseSelectorEventLoop._accept_connection(). Close the transport on error.\n In debug mode, log errors using call_exception_handler().\n* Fix _UnixReadPipeTransport and _UnixWritePipeTransport. Only start reading\n when connection_made() has been called.\n* Fix _SelectorSslTransport.close(). Don't call protocol.connection_lost() if\n protocol.connection_made() was not called yet: if the SSL handshake failed or\n is still in progress. The close() method can be called if the creation of the\n connection is cancelled, by a timeout for example.\n* Fix _SelectorDatagramTransport constructor. Only start reading after\n connection_made() has been called.\n* Fix _SelectorSocketTransport constructor. Only start reading when\n connection_made() has been called: protocol.data_received() must not be\n called before protocol.connection_made().\n* Fix SSLProtocol.eof_received(). Wake-up the waiter if it is not done yet.\n* Close transports on error. Fix create_datagram_endpoint(),\n connect_read_pipe() and connect_write_pipe(): close the transport if the task\n is cancelled or on error.\n* Close the transport on subprocess creation failure\n* Fix _ProactorBasePipeTransport.close(). Set the _read_fut attribute to None\n after cancelling it.\n* Python issue #23243: Fix _UnixWritePipeTransport.close(). Do nothing if the\n transport is already closed. Before it was not possible to close the\n transport twice.\n* Python issue #23242: SubprocessStreamProtocol now closes the subprocess\n transport at subprocess exit. Clear also its reference to the transport.\n* Fix BaseEventLoop._create_connection_transport(). Close the transport if the\n creation of the transport (if the waiter) gets an exception.\n* Python issue #23197: On SSL handshake failure, check if the waiter is\n cancelled before setting its exception.\n* Python issue #23173: Fix SubprocessStreamProtocol.connection_made() to handle\n cancelled waiter.\n* Python issue #23173: If an exception is raised during the creation of a\n subprocess, kill the subprocess (close pipes, kill and read the return\n status). Log an error in such case.\n* Python issue #23209: Break some reference cycles in asyncio. Patch written by\n Martin Richard.\n\nOptimization:\n\n* Only call _check_resolved_address() in debug mode. _check_resolved_address()\n is implemented with getaddrinfo() which is slow. If available, use\n socket.inet_pton() instead of socket.getaddrinfo(), because it is much faster\n\nOther changes:\n\n* Python issue #23456: Add missing @coroutine decorators\n* Python issue #23475: Fix test_close_kill_running(). Really kill the child\n process, don't mock completly the Popen.kill() method. This change fix memory\n leaks and reference leaks.\n* BaseSubprocessTransport: repr() mentions when the child process is running\n* BaseSubprocessTransport.close() doesn't try to kill the process if it already\n finished.\n* Tulip issue #221: Fix docstring of QueueEmpty and QueueFull\n* Fix subprocess_attach_write_pipe example. Close the transport, not directly\n the pipe.\n* Python issue #23347: send_signal(), terminate(), kill() don't check if the\n transport was closed. The check broken a Tulip example and this limitation is\n arbitrary. Check if _proc is None should be enough. Enhance also close(): do\n nothing when called the second time.\n* Python issue #23347: Refactor creation of subprocess transports.\n* Python issue #23243: On Python 3.4 and newer, emit a ResourceWarning when an\n event loop or a transport is not explicitly closed\n* tox.ini: enable ResourceWarning warnings\n* Python issue #23243: test_sslproto: Close explicitly transports\n* SSL transports now clear their reference to the waiter.\n* Python issue #23208: Add BaseEventLoop._current_handle. In debug mode,\n BaseEventLoop._run_once() now sets the BaseEventLoop._current_handle\n attribute to the handle currently executed.\n* Replace test_selectors.py with the file of Python 3.5 adapted for asyncio and\n Python 3.3.\n* Tulip issue #184: FlowControlMixin constructor now get the event loop if the\n loop parameter is not set.\n* _ProactorBasePipeTransport now sets the _sock attribute to None when the\n transport is closed.\n* Python issue #23219: cancelling wait_for() now cancels the task\n* Python issue #23243: Close explicitly event loops and transports in tests\n* Python issue #23140: Fix cancellation of Process.wait(). Check the state of\n the waiter future before setting its result.\n* Python issue #23046: Expose the BaseEventLoop class in the asyncio namespace\n* Python issue #22926: In debug mode, call_soon(), call_at() and call_later()\n methods of BaseEventLoop now use the identifier of the current thread to\n ensure that they are called from the thread running the event loop. Before,\n the get_event_loop() method was used to check the thread, and no exception\n was raised when the thread had no event loop. Now the methods always raise an\n exception in debug mode when called from the wrong thread. It should help to\n notice misusage of the API.\n\n2014-12-19: Version 1.0.4\n=========================\n\nChanges:\n\n* Python issue #22922: create_task(), call_at(), call_soon(),\n call_soon_threadsafe() and run_in_executor() now raise an error if the event\n loop is closed. Initial patch written by Torsten Landschoff.\n* Python issue #22921: Don't require OpenSSL SNI to pass hostname to ssl\n functions. Patch by Donald Stufft.\n* Add run_aiotest.py: run the aiotest test suite.\n* tox now also run the aiotest test suite\n* Python issue #23074: get_event_loop() now raises an exception if the thread\n has no event loop even if assertions are disabled.\n\nBugfixes:\n\n* Fix a race condition in BaseSubprocessTransport._try_finish(): ensure that\n connection_made() is called before connection_lost().\n* Python issue #23009: selectors, make sure EpollSelecrtor.select() works when\n no file descriptor is registered.\n* Python issue #22922: Fix ProactorEventLoop.close(). Call\n _stop_accept_futures() before sestting the _closed attribute, otherwise\n call_soon() raises an error.\n* Python issue #22429: Fix EventLoop.run_until_complete(), don't stop the event\n loop if a BaseException is raised, because the event loop is already stopped.\n* Initialize more Future and Task attributes in the class definition to avoid\n attribute errors in destructors.\n* Python issue #22685: Set the transport of stdout and stderr StreamReader\n objects in the SubprocessStreamProtocol. It allows to pause the transport to\n not buffer too much stdout or stderr data.\n* BaseSelectorEventLoop.close() now closes the self-pipe before calling the\n parent close() method. If the event loop is already closed, the self-pipe is\n not unregistered from the selector.\n\n\n2014-10-20: Version 1.0.3\n=========================\n\nChanges:\n\n* On Python 2 in debug mode, Future.set_exception() now stores the traceback\n object of the exception in addition to the exception object. When a task\n waiting for another task and the other task raises an exception, the\n traceback object is now copied with the exception. Be careful, storing the\n traceback object may create reference leaks.\n* Use ssl.create_default_context() if available to create the default SSL\n context: Python 2.7.9 and newer, or Python 3.4 and newer.\n* On Python 3.5 and newer, reuse socket.socketpair() in the windows_utils\n submodule.\n* On Python 3.4 and newer, use os.set_inheritable().\n* Enhance protocol representation: add \"closed\" or \"closing\" info.\n* run_forever() now consumes BaseException of the temporary task. If the\n coroutine raised a BaseException, consume the exception to not log a warning.\n The caller doesn't have access to the local task.\n* Python issue 22448: cleanup _run_once(), only iterate once to remove delayed\n calls that were cancelled.\n* The destructor of the Return class now shows where the Return object was\n created.\n* run_tests.py doesn't catch any exceptions anymore when loading tests, only\n catch SkipTest.\n* Fix (SSL) tests for the future Python 2.7.9 which includes a \"new\" ssl\n module: module backported from Python 3.5.\n* BaseEventLoop.add_signal_handler() now raises an exception if the parameter\n is a coroutine function.\n* Coroutine functions and objects are now rejected with a TypeError by the\n following functions: add_signal_handler(), call_at(), call_later(),\n call_soon(), call_soon_threadsafe(), run_in_executor().\n\n\n2014-10-02: Version 1.0.2\n=========================\n\nThis release fixes bugs. It also provides more information in debug mode on\nerror.\n\nMajor changes:\n\n* Tulip issue #203: Add _FlowControlMixin.get_write_buffer_limits() method.\n* Python issue #22063: socket operations (socket,recv, sock_sendall,\n sock_connect, sock_accept) of SelectorEventLoop now raise an exception in\n debug mode if sockets are in blocking mode.\n\nMajor bugfixes:\n\n* Tulip issue #205: Fix a race condition in BaseSelectorEventLoop.sock_connect().\n* Tulip issue #201: Fix a race condition in wait_for(). Don't raise a\n TimeoutError if we reached the timeout and the future completed in the same\n iteration of the event loop. A side effect of the bug is that Queue.get()\n looses items.\n* PipeServer.close() now cancels the \"accept pipe\" future which cancels the\n overlapped operation.\n\nOther changes:\n\n* Python issue #22448: Improve cancelled timer callback handles cleanup. Patch\n by Joshua Moore-Oliva.\n* Python issue #22369: Change \"context manager protocol\" to \"context management\n protocol\". Patch written by Serhiy Storchaka.\n* Tulip issue #206: In debug mode, keep the callback in the representation of\n Handle and TimerHandle after cancel().\n* Tulip issue #207: Fix test_tasks.test_env_var_debug() to use correct asyncio\n module.\n* runtests.py: display a message to mention if tests are run in debug or\n release mode\n* Tulip issue #200: Log errors in debug mode instead of simply ignoring them.\n* Tulip issue #200: _WaitHandleFuture._unregister_wait() now catchs and logs\n exceptions.\n* _fatal_error() method of _UnixReadPipeTransport and _UnixWritePipeTransport\n now log all exceptions in debug mode\n* Fix debug log in BaseEventLoop.create_connection(): get the socket object\n from the transport because SSL transport closes the old socket and creates a\n new SSL socket object.\n* Remove the _SelectorSslTransport._rawsock attribute: it contained the closed\n socket (not very useful) and it was not used.\n* Fix _SelectorTransport.__repr__() if the transport was closed\n* Use the new os.set_blocking() function of Python 3.5 if available\n\n\n2014-07-30: Version 1.0.1\n=========================\n\nThis release supports PyPy and has a better support of asyncio coroutines,\nespecially in debug mode.\n\nChanges:\n\n* Tulip issue #198: asyncio.Condition now accepts an optional lock object.\n* Enhance representation of Future and Future subclasses: add \"created at\".\n\nBugfixes:\n\n* Fix Trollius issue #9: @trollius.coroutine now works on callbable objects\n (without ``__name__`` attribute), not only on functions.\n* Fix Trollius issue #13: asyncio futures are now accepted in all functions:\n as_completed(), async(), @coroutine, gather(), run_until_complete(),\n wrap_future().\n* Fix support of asyncio coroutines in debug mode. If the last instruction\n of the coroutine is \"yield from\", it's an asyncio coroutine and it does not\n need to use From().\n* Fix and enhance _WaitHandleFuture.cancel():\n\n - Tulip issue #195: Fix a crash on Windows: don't call UnregisterWait() twice\n if a _WaitHandleFuture is cancelled twice.\n - Fix _WaitHandleFuture.cancel(): return the result of the parent cancel()\n method (True or False).\n - _WaitHandleFuture.cancel() now notify IocpProactor through the overlapped\n object that the wait was cancelled.\n\n* Tulip issue #196: _OverlappedFuture now clears its reference to the\n overlapped object. IocpProactor keeps a reference to the overlapped object\n until it is notified of its completion. Log also an error in debug mode if it\n gets unexpected notifications.\n* Fix runtest.py to be able to log at level DEBUG.\n\nOther changes:\n\n* BaseSelectorEventLoop._write_to_self() now logs errors in debug mode.\n* Fix as_completed(): it's not a coroutine, don't use ``yield From(...)`` but\n ``yield ...``\n* Tulip issue #193: Convert StreamWriter.drain() to a classic coroutine.\n* Tulip issue #194: Don't use sys.getrefcount() in unit tests: the full test\n suite now pass on PyPy.\n\n\n2014-07-21: Version 1.0\n=======================\n\nMajor Changes\n-------------\n\n* Event loops have a new ``create_task()`` method, which is now the recommanded\n way to create a task object. This method can be overriden by third-party\n event loops to use their own task class.\n* The debug mode has been improved a lot. Set ``TROLLIUSDEBUG`` envrironment\n variable to ``1`` and configure logging to log at level ``logging.DEBUG``\n (ex: ``logging.basicConfig(level=logging.DEBUG)``). Changes:\n\n - much better representation of Trollius objects (ex: ``repr(task)``):\n unified ``<Class arg1 arg2 ...>`` format, use qualified name when available\n - show the traceback where objects were created\n - show the current filename and line number for coroutine\n - show the filename and line number where objects were created\n - log most important socket events\n - log most important subprocess events\n\n* ``Handle.cancel()`` now clears references to callback and args\n* Log an error if a Task is destroyed while it is still pending, but only on\n Python 3.4 and newer.\n* Fix for asyncio coroutines when passing tuple value in debug mode.\n ``CoroWrapper.send()`` now checks if it is called from a \"yield from\"\n generator to decide if the parameter should be unpacked or not.\n* ``Process.communicate()`` now ignores ``BrokenPipeError`` and\n ``ConnectionResetError`` exceptions.\n* Rewrite signal handling on Python 3.3 and newer to fix a race condition: use\n the \"self-pipe\" to get signal numbers.\n\n\nOther Changes\n-------------\n\n* Fix ``ProactorEventLoop()`` in debug mode\n* Fix a race condition when setting the result of a Future with\n ``call_soon()``. Add an helper, a private method, to set the result only if\n the future was not cancelled.\n* Fix ``asyncio.__all__``: export also ``unix_events`` and ``windows_events``\n symbols. For example, on Windows, it was not possible to get\n ``ProactorEventLoop`` or ``DefaultEventLoopPolicy`` using ``from asyncio\n import *``.\n* ``Handle.cancel()`` now clears references to callback and args\n* Make Server attributes and methods private, the sockets attribute remains\n public.\n* BaseEventLoop.create_datagram_endpoint() now waits until\n protocol.connection_made() has been called. Document also why transport\n constructors use a waiter.\n* _UnixSubprocessTransport: fix file mode of stdin: open stdin in write mode,\n not in read mode.\n\n\n2014-06-23: version 0.4\n=======================\n\nChanges between Trollius 0.3 and 0.4:\n\n* Trollius event loop now supports asyncio coroutines:\n\n - Trollius coroutines can yield asyncio coroutines,\n - asyncio coroutines can yield Trollius coroutines,\n - asyncio.set_event_loop() accepts a Trollius event loop,\n - asyncio.set_event_loop_policy() accepts a Trollius event loop policy.\n\n* The ``PYTHONASYNCIODEBUG`` envrionment variable has been renamed to\n ``TROLLIUSDEBUG``. The environment variable is now used even if the Python\n command line option ``-E`` is used.\n* Synchronize with Tulip.\n* Support PyPy (fix subproces, fix unit tests).\n\nTulip changes:\n\n* Tulip issue #171: BaseEventLoop.close() now raises an exception if the event\n loop is running. You must first stop the event loop and then wait until it\n stopped, before closing it.\n* Tulip issue #172: only log selector timing in debug mode\n* Enable the debug mode of event loops when the ``TROLLIUSDEBUG`` environment\n variable is set\n* BaseEventLoop._assert_is_current_event_loop() now only raises an exception if\n the current loop is set.\n* Tulip issue #105: in debug mode, log callbacks taking more than 100 ms to be\n executed.\n* Python issue 21595: ``BaseSelectorEventLoop._read_from_self()`` reads all\n available bytes from the \"self pipe\", not only a single byte. This change\n reduces the risk of having the pipe full and so getting the \"BlockingIOError:\n [Errno 11] Resource temporarily unavailable\" message.\n* Python issue 21723: asyncio.Queue: support any type of number (ex: float) for\n the maximum size. Patch written by Vajrasky Kok.\n* Issue #173: Enhance repr(Handle) and repr(Task): add the filename and line\n number, when available. For task, the current line number of the coroutine\n is used.\n* Add BaseEventLoop.is_closed() method. run_forever() and run_until_complete()\n methods now raises an exception if the event loop was closed.\n* Make sure that socketpair() close sockets on error. Close the listening\n socket if sock.bind() raises an exception.\n* Fix ResourceWarning: close sockets on errors.\n BaseEventLoop.create_connection(), BaseEventLoop.create_datagram_endpoint()\n and _UnixSelectorEventLoop.create_unix_server() now close the newly created\n socket on error.\n* Rephrase and fix docstrings.\n* Fix tests on Windows: wait for the subprocess exit. Before, regrtest failed\n to remove the temporary test directory because the process was still running\n in this directory.\n* Refactor unit tests.\n\nOn Python 3.5, generators now get their name from the function, no more from\nthe code. So the ``@coroutine`` decorator doesn't loose the original name of\nthe function anymore.\n\n\n2014-05-26: version 0.3\n=======================\n\nRename the Python module ``asyncio`` to ``trollius`` to support Python 3.4. On\nPython 3.4, there is already a module called ``asyncio`` in the standard\nlibrary which conflicted with ``asyncio`` module of Trollius 0.2. To write\nasyncio code working on Trollius and Tulip, use ``import trollius as asyncio``.\n\nChanges between Trollius 0.2 and 0.3:\n\n* Synchronize with Tulip 3.4.1.\n* Enhance Trollius documentation.\n* Trollius issue #7: Fix ``asyncio.time_monotonic`` on Windows older than\n Vista (ex: Windows 2000 and Windows XP).\n* Fedora packages have been accepted.\n\nChanges between Tulip 3.4.0 and 3.4.1:\n\n* Pull in Solaris ``devpoll`` support by Giampaolo Rodola\n (``trollius.selectors`` module).\n* Add options ``-r`` and ``--randomize`` to runtests.py to randomize test\n order.\n* Add a simple echo client/server example.\n* Tulip issue #166: Add ``__weakref__`` slots to ``Handle`` and\n ``CoroWrapper``.\n* ``EventLoop.create_unix_server()`` now raises a ``ValueError`` if path and\n sock are specified at the same time.\n* Ensure ``call_soon()``, ``call_later()`` and ``call_at()`` are invoked on\n current loop in debug mode. Raise a ``RuntimeError`` if the event loop of the\n current thread is different. The check should help to debug thread-safetly\n issue. Patch written by David Foster.\n* Tulip issue #157: Improve test_events.py, avoid ``run_briefly()`` which is\n not reliable.\n* Reject add/remove reader/writer when event loop is closed.\n\nBugfixes of Tulip 3.4.1:\n\n* Tulip issue #168: ``StreamReader.read(-1)`` from pipe may hang if\n data exceeds buffer limit.\n* CPython issue #21447: Fix a race condition in\n ``BaseEventLoop._write_to_self()``.\n* Different bugfixes in ``CoroWrapper`` of ``trollius.coroutines``, class used\n when running Trollius in debug mode:\n\n - Fix ``CoroWrapper`` to workaround yield-from bug in CPython 3.4.0. The\n CPython bug is now fixed in CPython 3.4.1 and 3.5.\n - Make sure ``CoroWrapper.send`` proxies one argument correctly.\n - CPython issue #21340: Be careful accessing instance variables in ``__del__``.\n - Tulip issue #163: Add ``gi_{frame,running,code}`` properties to\n ``CoroWrapper``.\n\n* Fix ``ResourceWarning`` warnings\n* Tulip issue #159: Fix ``windows_utils.socketpair()``. Use ``\"127.0.0.1\"``\n (IPv4) or ``\"::1\"`` (IPv6) host instead of ``\"localhost\"``, because\n ``\"localhost\"`` may be a different IP address. Reject also invalid arguments:\n only ``AF_INET`` and ``AF_INET6`` with ``SOCK_STREAM`` (and ``proto=0``) are\n supported.\n* Tulip issue #158: ``Task._step()`` now also sets ``self`` to ``None`` if an\n exception is raised. ``self`` is set to ``None`` to break a reference cycle.\n\n\n2014-03-04: version 0.2\n=======================\n\nTrollius now uses ``yield From(...)`` syntax which looks close to Tulip ``yield\nfrom ...`` and allows to port more easily Trollius code to Tulip. The usage of\n``From()`` is not mandatory yet, but it may become mandatory in a future\nversion. However, if ``yield`` is used without ``From``, an exception is\nraised if the event loop is running in debug mode.\n\nMajor changes:\n\n* Replace ``yield ...`` syntax with ``yield From(...)``\n* On Python 2, Future.set_exception() now only saves the traceback if the debug\n mode of the event loop is enabled for best performances in production mode.\n Use ``loop.set_debug(True)`` to save the traceback.\n\nBugfixes:\n\n* Fix ``BaseEventLoop.default_exception_handler()`` on Python 2: get the\n traceback from ``sys.exc_info()``\n* Fix unit tests on SSL sockets on Python older than 2.6.6. Example:\n Mac OS 10.6 with Python 2.6.1 or OpenIndiana 148 with Python 2.6.4.\n* Fix error handling in the asyncio.time_monotonic module\n* Fix acquire() method of Lock, Condition and Semaphore: don't return a context\n manager but True, as Tulip. Task._step() now does the trick.\n\nOther changes:\n\n* tox.ini: set PYTHONASYNCIODEBUG to 1 to run tests\n\n2014-02-25: version 0.1.6\n=========================\n\nTrollius changes:\n\n* Add a new Sphinx documentation:\n https://trollius.readthedocs.io/\n* tox: pass posargs to nosetests. Patch contributed by Ian Wienand.\n* Fix support of Python 3.2 and add py32 to tox.ini\n* Merge with Tulip 0.4.1\n\nMajor changes of Tulip 0.4.1:\n\n* Issue #81: Add support for UNIX Domain Sockets. New APIs:\n\n - loop.create_unix_connection()\n - loop.create_unix_server()\n - streams.open_unix_connection()\n - streams.start_unix_server()\n\n* Issue #80: Add new event loop exception handling API. New APIs:\n\n - loop.set_exception_handler()\n - loop.call_exception_handler()\n - loop.default_exception_handler()\n\n* Issue #136: Add get_debug() and set_debug() methods to BaseEventLoopTests.\n Add also a ``PYTHONASYNCIODEBUG`` environment variable to debug coroutines\n since Python startup, to be able to debug coroutines defined directly in the\n asyncio module.\n\nOther changes of Tulip 0.4.1:\n\n* asyncio.subprocess: Fix a race condition in communicate()\n* Fix _ProactorWritePipeTransport._pipe_closed()\n* Issue #139: Improve error messages on \"fatal errors\".\n* Issue #140: WriteTransport.set_write_buffer_size() to call\n _maybe_pause_protocol()\n* Issue #129: BaseEventLoop.sock_connect() now raises an error if the address\n is not resolved (hostname instead of an IP address) for AF_INET and\n AF_INET6 address families.\n* Issue #131: as_completed() and wait() now raises a TypeError if the list of\n futures is not a list but a Future, Task or coroutine object\n* Python issue #20495: Skip test_read_pty_output() of test_asyncio on FreeBSD\n older than FreeBSD 8\n* Issue #130: Add more checks on subprocess_exec/subprocess_shell parameters\n* Issue #126: call_soon(), call_soon_threadsafe(), call_later(), call_at()\n and run_in_executor() now raise a TypeError if the callback is a coroutine\n function.\n* Python issue #20505: BaseEventLoop uses again the resolution of the clock\n to decide if scheduled tasks should be executed or not.\n\n\n2014-02-10: version 0.1.5\n=========================\n\n- Merge with Tulip 0.3.1:\n\n * New asyncio.subprocess module\n * _UnixWritePipeTransport now also supports character devices, as\n _UnixReadPipeTransport. Patch written by Jonathan Slenders.\n * StreamReader.readexactly() now raises an IncompleteReadError if the\n end of stream is reached before we received enough bytes, instead of\n returning less bytes than requested.\n * poll and epoll selectors now round the timeout away from zero (instead of\n rounding towards zero) to fix a performance issue\n * asyncio.queue: Empty renamed to QueueEmpty, Full to QueueFull\n * _fatal_error() of _UnixWritePipeTransport and _ProactorBasePipeTransport\n don't log BrokenPipeError nor ConnectionResetError\n * Future.set_exception(exc) now instanciate exc if it is a class\n * streams.StreamReader: Use bytearray instead of deque of bytes for internal\n buffer\n\n- Fix test_wait_for() unit test\n\n2014-01-22: version 0.1.4\n=========================\n\n- The project moved to https://bitbucket.org/enovance/trollius\n- Fix CoroWrapper (_DEBUG=True): add missing import\n- Emit a warning when Return is not raised\n- Merge with Tulip to get latest Tulip bugfixes\n- Fix dependencies in tox.ini for the different Python versions\n\n2014-01-13: version 0.1.3\n=========================\n\n- Workaround bugs in the ssl module of Python older than 2.6.6. For example,\n Mac OS 10.6 (Snow Leopard) uses Python 2.6.1.\n- ``return x, y`` is now written ``raise Return(x, y)`` instead of\n ``raise Return((x, y))``\n- Support \"with (yield lock):\" syntax for Lock, Condition and Semaphore\n- SSL support is now optional: don't fail if the ssl module is missing\n- Add tox.ini, tool to run unit tests. For example, \"tox -e py27\" creates a\n virtual environment to run tests with Python 2.7.\n\n2014-01-08: version 0.1.2\n=========================\n\n- Trollius now supports CPython 2.6-3.4, PyPy and Windows. All unit tests\n pass with CPython 2.7 on Linux.\n- Fix Windows support. Fix compilation of the _overlapped module and add a\n asyncio._winapi module (written in pure Python). Patch written by Marc\n Schlaich.\n- Support Python 2.6: require an extra dependency,\n ordereddict (and unittest2 for unit tests)\n- Support Python 3.2, 3.3 and 3.4\n- Support PyPy 2.2\n- Don't modify __builtins__ nor the ssl module to inject backported exceptions\n like BlockingIOError or SSLWantReadError. Exceptions are available in the\n asyncio module, ex: asyncio.BlockingIOError.\n\n2014-01-06: version 0.1.1\n=========================\n\n- Fix asyncio.time_monotonic on Mac OS X\n- Fix create_connection(ssl=True)\n- Don't export backported SSLContext in the ssl module anymore to not confuse\n libraries testing hasattr(ssl, \"SSLContext\")\n- Relax dependency on the backported concurrent.futures module: use a\n synchronous executor if the module is missing\n\n2014-01-04: version 0.1\n=======================\n\n- First public release",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "Deprecated, unmaintained port of the asyncio module (PEP 3156) on Python 2",
"version": "2.2.1",
"split_keywords": [
"deprecated",
"unmaintained",
"asyncio",
"backport"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b238c8912bccf60742c0d3cc47c02d8944e8eaa5cb953bbb6a4d5c4714ef3bcd",
"md5": "2e256e49f42734673dc9f520afc054e9",
"sha256": "3b3fab99b14852a01ceda3a49e853d15720c922a4645dd8bec3c3ba9cf6877cf"
},
"downloads": -1,
"filename": "trollius-2.2.1-cp27-cp27m-win32.whl",
"has_sig": false,
"md5_digest": "2e256e49f42734673dc9f520afc054e9",
"packagetype": "bdist_wheel",
"python_version": "cp27",
"requires_python": ">=2.7, < 3",
"size": 142672,
"upload_time": "2021-04-28T17:32:03",
"upload_time_iso_8601": "2021-04-28T17:32:03.337232Z",
"url": "https://files.pythonhosted.org/packages/b2/38/c8912bccf60742c0d3cc47c02d8944e8eaa5cb953bbb6a4d5c4714ef3bcd/trollius-2.2.1-cp27-cp27m-win32.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "71c650600316017752e42f5e0f09c4ed7aa6bd4a1929008c94a87078f60675db",
"md5": "89e1b957e4d47a59812e5e97dadaf007",
"sha256": "74043df6e5392917b93d77d4742746aa082c152a468b193736cbb83e12c747a7"
},
"downloads": -1,
"filename": "trollius-2.2.1-cp27-cp27m-win_amd64.whl",
"has_sig": false,
"md5_digest": "89e1b957e4d47a59812e5e97dadaf007",
"packagetype": "bdist_wheel",
"python_version": "cp27",
"requires_python": ">=2.7, < 3",
"size": 143992,
"upload_time": "2021-04-28T17:32:04",
"upload_time_iso_8601": "2021-04-28T17:32:04.858086Z",
"url": "https://files.pythonhosted.org/packages/71/c6/50600316017752e42f5e0f09c4ed7aa6bd4a1929008c94a87078f60675db/trollius-2.2.1-cp27-cp27m-win_amd64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9ff8b6ecbbd907997b039b8ca5a1d27b1f8f76fbc301c2dafe540dbb95811591",
"md5": "698a78b06cf604fd0e25391e41d205ea",
"sha256": "e525b94e80c5893293320975b93bb06f5104b6b84f7299e9708a7ae4d5c310ca"
},
"downloads": -1,
"filename": "trollius-2.2.1.tar.gz",
"has_sig": false,
"md5_digest": "698a78b06cf604fd0e25391e41d205ea",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=2.7, < 3",
"size": 302823,
"upload_time": "2021-04-28T17:23:29",
"upload_time_iso_8601": "2021-04-28T17:23:29.974050Z",
"url": "https://files.pythonhosted.org/packages/9f/f8/b6ecbbd907997b039b8ca5a1d27b1f8f76fbc301c2dafe540dbb95811591/trollius-2.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2021-04-28 17:23:29",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "jamadden",
"github_project": "trollius",
"travis_ci": true,
"coveralls": false,
"github_actions": false,
"appveyor": true,
"tox": true,
"lcname": "trollius"
}
JSON
