Permalink
Find file Copy path
cfa82d8 Aug 22, 2018
4 contributors

Users who have contributed to this file

@njsmith @buhman @pquentin @smurfix
94 lines (74 sloc) 3.44 KB

Trio: async programming for humans and snake people

P.S. your API is a user interface – Kenneth Reitz

The Trio project's goal is to produce a production-quality, permissively licensed, 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, and draws inspiration from many sources, in particular Dave Beazley's Curio. The resulting design is radically simpler than older competitors like asyncio and Twisted, 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.

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 to get warning and a chance to give feedback about any compatibility-breaking changes.

Vital statistics:

.. toctree::
   :maxdepth: 2
   :caption: Trio's friendly, yet comprehensive, manual:

   tutorial.rst
   reference-core.rst
   reference-io.rst
   reference-testing.rst
   reference-hazmat.rst
   design.rst
   history.rst
   contributing.rst
   releasing.rst
   code-of-conduct.rst

Indices and tables