forked from goodboy/tractor
1
0
Fork 0
'structured concurrent `trio`-"actors"'
Go to file
Tyler Goodlet 0a5a4d8487 Readme rework draft 2021-02-25 09:10:18 -05:00
.github/workflows Include Python 3.9 in CI 2020-12-27 13:28:54 -05:00
docs Readme rework draft 2021-02-25 09:10:18 -05:00
examples Remove tractor run from some debug examples 2021-02-24 13:14:40 -05:00
tests Use root as default name from `tractor.run()` 2021-02-25 08:51:28 -05:00
tractor Use root as default name from `tractor.run()` 2021-02-25 08:51:28 -05:00
.gitignore Initial commit 2018-07-05 16:01:15 -04:00
LICENSE Initial commit 2018-07-05 16:01:15 -04:00
mypy.ini Add mypy.ini lel 2020-01-21 15:28:12 -05:00
requirements-docs.txt Added logo, fixed github links and grammar issues 2020-08-31 11:49:14 -03:00
requirements-test.txt Add `pexpect` dep for debugger tests 2020-10-13 11:04:16 -04:00
setup.py Test putting readme in docs dir 2021-02-21 17:52:04 -05:00

docs/README.rst

tractor

The Python async-native multi-core system you always wanted.

gh_actions Documentation Status

tractor is a structured concurrent "actor model" built on trio and multiprocessing.

It is an attempt to pair trionic structured concurrency with distributed Python. You can think of it as a trio -across-processes or simply as a replacement for the stdlib's multiprocessing but built on async primitives for IPC.

tractor's nurseries lets you spawn trio "actors": new Python processes which each run a trio scheduled task tree (also known as an async sandwich). That is, each "Actor" is a new process plus a trio runtime.

Processes communicate by exchanging asynchronous messages and avoid sharing state. The intention of this model is to allow for highly distributed software that, through the adherence to structured concurrency, results in systems which fail in predicatable ways.

The first step to grok tractor is to get the basics of trio down. A great place to start is the trio docs and this blog post.

Install

No PyPi release yet!

pip install git+git://github.com/goodboy/tractor.git

Alluring Features

  • Infinitely nesteable process trees
  • A built-in API for inter-process streaming
  • A (first ever?) "native" multi-core debugger for Python using pdb++
  • (Soon to land) asyncio support allowing for "infected" actors where trio drives the asyncio scheduler via the astounding "guest mode"

Feel like saying hi?

This project is very much coupled to the ongoing development of trio (i.e. tractor gets most of its ideas from that brilliant community). If you want to help, have suggestions or just want to say hi, please feel free to reach us in our matrix channel. If matrix seems too hip, we're also mostly all in the the trio gitter channel!