Metadata-Version: 2.1
|
Name: trio
|
Version: 0.22.0
|
Summary: A friendly Python library for async concurrency and I/O
|
Home-page: https://github.com/python-trio/trio
|
Author: Nathaniel J. Smith
|
Author-email: njs@pobox.com
|
License: MIT OR Apache-2.0
|
Keywords: async,io,networking,trio
|
Classifier: Development Status :: 3 - Alpha
|
Classifier: Intended Audience :: Developers
|
Classifier: License :: OSI Approved :: MIT License
|
Classifier: License :: OSI Approved :: Apache Software License
|
Classifier: Operating System :: POSIX :: Linux
|
Classifier: Operating System :: MacOS :: MacOS X
|
Classifier: Operating System :: POSIX :: BSD
|
Classifier: Operating System :: Microsoft :: Windows
|
Classifier: Programming Language :: Python :: Implementation :: CPython
|
Classifier: Programming Language :: Python :: Implementation :: PyPy
|
Classifier: Programming Language :: Python :: 3 :: Only
|
Classifier: Programming Language :: Python :: 3.7
|
Classifier: Programming Language :: Python :: 3.8
|
Classifier: Programming Language :: Python :: 3.9
|
Classifier: Programming Language :: Python :: 3.10
|
Classifier: Programming Language :: Python :: 3.11
|
Classifier: Topic :: System :: Networking
|
Classifier: Framework :: Trio
|
Requires-Python: >=3.7
|
License-File: LICENSE
|
License-File: LICENSE.APACHE2
|
License-File: LICENSE.MIT
|
Requires-Dist: attrs (>=19.2.0)
|
Requires-Dist: sortedcontainers
|
Requires-Dist: async-generator (>=1.9)
|
Requires-Dist: idna
|
Requires-Dist: outcome
|
Requires-Dist: sniffio
|
Requires-Dist: cffi (>=1.14) ; os_name == "nt" and implementation_name != "pypy"
|
Requires-Dist: exceptiongroup (>=1.0.0rc9) ; python_version < "3.11"
|
|
.. image:: https://raw.githubusercontent.com/python-trio/trio/9b0bec646a31e0d0f67b8b6ecc6939726faf3e17/logo/logo-with-background.svg
|
:width: 200px
|
:align: right
|
|
The Trio project's goal is to produce a production-quality, `permissively
|
licensed <https://github.com/python-trio/trio/blob/master/LICENSE>`__,
|
async/await-native I/O library for Python. Like all async libraries,
|
its main purpose is to help you write programs that do **multiple
|
things at the same time** with **parallelized I/O**. A web spider that
|
wants to fetch lots of pages in parallel, a web server that needs to
|
juggle lots of downloads and websocket connections at the same time, a
|
process supervisor monitoring multiple subprocesses... that sort of
|
thing. Compared to other libraries, Trio attempts to distinguish
|
itself with an obsessive focus on **usability** and
|
**correctness**. Concurrency is complicated; we try to make it *easy*
|
to get things *right*.
|
|
Trio was built from the ground up to take advantage of the `latest
|
Python features <https://www.python.org/dev/peps/pep-0492/>`__, and
|
draws inspiration from `many sources
|
<https://github.com/python-trio/trio/wiki/Reading-list>`__, in
|
particular Dave Beazley's `Curio <https://curio.readthedocs.io/>`__.
|
The resulting design is radically simpler than older competitors like
|
`asyncio <https://docs.python.org/3/library/asyncio.html>`__ and
|
`Twisted <https://twistedmatrix.com/>`__, yet just as capable. Trio is
|
the Python I/O library I always wanted; I find it makes building
|
I/O-oriented programs easier, less error-prone, and just plain more
|
fun. `Perhaps you'll find the same
|
<https://github.com/python-trio/trio/wiki/Testimonials>`__.
|
|
This project is young and still somewhat experimental: the overall
|
design is solid and the existing features are fully tested and
|
documented, but you may encounter missing functionality or rough
|
edges. We *do* encourage you do use it, but you should `read and
|
subscribe to issue #1
|
<https://github.com/python-trio/trio/issues/1>`__ to get warning and a
|
chance to give feedback about any compatibility-breaking changes.
|
|
Vital statistics:
|
|
* Supported environments: Linux, macOS, or Windows running some kind of Python
|
3.7-or-better (either CPython or PyPy3 is fine). \*BSD and illumos likely
|
work too, but are not tested.
|
|
* Install: ``python3 -m pip install -U trio`` (or on Windows, maybe
|
``py -3 -m pip install -U trio``). No compiler needed.
|
|
* Tutorial and reference manual: https://trio.readthedocs.io
|
|
* Bug tracker and source code: https://github.com/python-trio/trio
|
|
* Real-time chat: https://gitter.im/python-trio/general
|
|
* Discussion forum: https://trio.discourse.group
|
|
* License: MIT or Apache 2, your choice
|
|
* Contributor guide: https://trio.readthedocs.io/en/latest/contributing.html
|
|
* Code of conduct: Contributors are requested to follow our `code of
|
conduct
|
<https://trio.readthedocs.io/en/latest/code-of-conduct.html>`_
|
in all project spaces.
|
