/usr/lib/python3/dist-packages/crochet-1.4.0.egg-info/PKG-INFO is in python3-crochet 1.4.0-0ubuntu2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 | Metadata-Version: 1.1
Name: crochet
Version: 1.4.0
Summary: Use Twisted anywhere!
Home-page: https://github.com/itamarst/crochet
Author: Itamar Turner-Trauring
Author-email: itamar@itamarst.org
License: MIT
Description: Crochet: Use Twisted Anywhere!
==============================
Crochet is an MIT-licensed library that makes it easier to use Twisted from
regular blocking code. Some use cases include:
* Easily use Twisted from a blocking framework like Django or Flask.
* Write a library that provides a blocking API, but uses Twisted for its
implementation.
* Port blocking code to Twisted more easily, by keeping a backwards
compatibility layer.
* Allow normal Twisted programs that use threads to interact with Twisted more
cleanly from their threaded parts. For example this can be useful when using
Twisted as a `WSGI container`_.
.. _WSGI container: https://twistedmatrix.com/documents/current/web/howto/web-in-60/wsgi.html
Crochet is maintained by Itamar Turner-Trauring.
Downloads are available on `PyPI`_.
Documentation can be found on `Read The Docs`_.
Bugs and feature requests should be filed at the project `Github page`_.
.. _Read the Docs: https://crochet.readthedocs.org/
.. _Github page: https://github.com/itamarst/crochet/
.. _PyPI: https://pypi.python.org/pypi/crochet
Features
========
Crochet aims for 100% unit test coverage, and supports Python 2.6, 2.7, 3.3 and 3.4 as well as PyPy.
.. image:: https://travis-ci.org/itamarst/crochet.png?branch=master
:target: http://travis-ci.org/itamarst/crochet
:alt: Build Status
Crochet provides the following general features:
* Allow blocking code to call into Twisted and block until results are available
or a timeout is hit, using the ``crochet.wait_for`` decorator.
* A lower-level API (``crochet.run_in_reactor``) allows blocking code to run
code "in the background" in the Twisted thread, with ability to repeatedly
check if it's done.
Additionally Crochet can:
* Transparently start Twisted's reactor in a thread it manages.
* The reactor shuts down automatically when the process' main thread finishes.
* Hooks up Twisted's log system to the Python standard library ``logging``
framework. Unlike Twisted's built-in ``logging`` bridge, this includes
support for blocking `Handler` instances.
What's New
==========
1.4.0
^^^^^
New features:
* Added support for Python 3.4.
Documentation:
* Added a section on known issues and workarounds.
Bug fixes:
* Main thread detection (used to determine when Crochet should shutdown) is now less fragile.
This means Crochet now supports more environments, e.g. uWSGI.
Thanks to Ben Picolo for the patch.
1.3.0
^^^^^
Bug fixes:
* It is now possible to call ``EventualResult.wait()`` (or functions
wrapped in ``wait_for``) at import time if another thread holds the
import lock. Thanks to Ken Struys for the patch.
1.2.0
^^^^^
New features:
* ``crochet.wait_for`` implements the timeout/cancellation pattern documented
in previous versions of Crochet. ``crochet.wait_for_reactor`` and
``EventualResult.wait(timeout=None)`` are now deprecated, since lacking
timeouts they could potentially block forever.
* Functions wrapped with ``wait_for`` and ``run_in_reactor`` can now be accessed
via the ``wrapped_function`` attribute, to ease unit testing of the underlying
Twisted code.
API changes:
* It is no longer possible to call ``EventualResult.wait()`` (or functions
wrapped with ``wait_for``) at import time, since this can lead to deadlocks
or prevent other threads from importing. Thanks to Tom Prince for the bug
report.
Bug fixes:
* ``warnings`` are no longer erroneously turned into Twisted log messages.
* The reactor is now only imported when ``crochet.setup()`` or
``crochet.no_setup()`` are called, allowing daemonization if only ``crochet``
is imported (http://tm.tl/7105). Thanks to Daniel Nephin for the bug report.
Documentation:
* Improved motivation, added contact info and news to the documentation.
* Better example of using Crochet from a normal Twisted application.
1.1.0
^^^^^
Bug fixes:
* ``EventualResult.wait()`` can now be used safely from multiple threads,
thanks to Gavin Panella for reporting the bug.
* Fixed reentrancy deadlock in the logging code caused by
http://bugs.python.org/issue14976, thanks to Rod Morehead for reporting the
bug.
* Crochet now installs on Python 3.3 again, thanks to Ben Cordero.
* Crochet should now work on Windows, thanks to Konstantinos Koukopoulos.
* Crochet tests can now run without adding its absolute path to PYTHONPATH or
installing it first.
Documentation:
* ``EventualResult.original_failure`` is now documented.
1.0.0
^^^^^
Documentation:
* Added section on use cases and alternatives. Thanks to Tobias Oberstein for
the suggestion.
Bug fixes:
* Twisted does not have to be pre-installed to run ``setup.py``, thanks to
Paul Weaver for bug report and Chris Scutcher for patch.
* Importing Crochet does not have side-effects (installing reactor event)
any more.
* Blocking calls are interrupted earlier in the shutdown process, to reduce
scope for deadlocks. Thanks to rmorehead for bug report.
0.9.0
^^^^^
New features:
* Expanded and much improved documentation, including a new section with
design suggestions.
* New decorator ``@wait_for_reactor`` added, a simpler alternative to
``@run_in_reactor``.
* Refactored ``@run_in_reactor``, making it a bit more responsive.
* Blocking operations which would otherwise never finish due to reactor having
stopped (``EventualResult.wait()`` or ``@wait_for_reactor`` decorated call)
will be interrupted with a ``ReactorStopped`` exception. Thanks to rmorehead
for the bug report.
Bug fixes:
* ``@run_in_reactor`` decorated functions (or rather, their generated wrapper)
are interrupted by Ctrl-C.
* On POSIX platforms, a workaround is installed to ensure processes started by
`reactor.spawnProcess` have their exit noticed. See `Twisted ticket 6378`_
for more details about the underlying issue.
.. _Twisted ticket 6378: http://tm.tl/6738
0.8.1
^^^^^
* ``EventualResult.wait()`` now raises error if called in the reactor thread,
thanks to David Buchmann.
* Unittests are now included in the release tarball.
* Allow Ctrl-C to interrupt ``EventualResult.wait(timeout=None)``.
0.7.0
^^^^^
* Improved documentation.
0.6.0
^^^^^
* Renamed ``DeferredResult`` to ``EventualResult``, to reduce confusion with
Twisted's ``Deferred`` class. The old name still works, but is deprecated.
* Deprecated ``@in_reactor``, replaced with ``@run_in_reactor`` which doesn't
change the arguments to the wrapped function. The deprecated API still works,
however.
* Unhandled exceptions in ``EventualResult`` objects are logged.
* Added more examples.
* ``setup.py sdist`` should work now.
0.5.0
^^^^^
* Initial release.
Keywords: twisted threading
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
|