Trio: async programming for humans and snake people

Trio is an experimental attempt to produce a production-quality, permissively licensed, async/await-native I/O library for Python, with an emphasis on usability and correctness – we want to make it easy to get things right.

Contents:

• Tutorial
  • Before you begin
  • Async functions
  • A kinder, gentler GIL
  • Networking with trio
  • An echo client and server: higher-level API
  • When things go wrong: timeouts, cancellation and exceptions in concurrent tasks
• Trio’s core functionality
  • Entering trio
  • General notes
  • Time and clocks
  • Cancellation and timeouts
  • Tasks let you do multiple things at once
  • Task-local storage and run-local storage
  • Synchronizing and communicating between tasks
  • Threads (if you must)
  • Debugging and instrumentation
  • Exceptions
• I/O in Trio
  • Sockets and networking
  • The abstract Stream API
  • TLS support
  • Async disk I/O
  • Subprocesses
  • Signals
• Testing made easier with trio.testing
  • Test harness integration
  • Time and timeouts
  • Inter-task ordering
  • Testing yield points
• Low-level operations in trio.hazmat
  • Low-level I/O primitives
  • System tasks
  • Entering trio from external threads or signal handlers
  • Safe KeyboardInterrupt handling
  • Sleeping and waking
• Design and internals
  • High-level design principles
  • User-level API principles
  • Specific style guidelines
  • A brief tour of trio’s internals
• Release history
  • v0.1.0 (2017-03-10)

Indices and tables

• Index
• Module Index
• Search Page