'structured concurrent `trio`-"actors"' https://github.com/goodboy/tractor
Go to file
Tyler Goodlet d6abfa774a Drop toc from sidebar 2020-02-10 12:14:16 -05:00
docs Drop toc from sidebar 2020-02-10 12:14:16 -05:00
examples Better document the window's gotcha solution in test code 2020-02-09 14:59:22 -05:00
tests Better document the window's gotcha solution in test code 2020-02-09 14:59:22 -05:00
tractor Pass a `Channel` to `LocalPortal` for compat purposes 2020-02-09 01:59:39 -05:00
.gitignore Initial commit 2018-07-05 16:01:15 -04:00
.travis.yml Fix typo 2020-01-31 12:04:13 -05:00
LICENSE Initial commit 2018-07-05 16:01:15 -04:00
README.rst Remove duplicate docs from readme 2020-02-10 12:14:16 -05:00
mypy.ini Add mypy.ini lel 2020-01-21 15:28:12 -05:00
requirements-test.txt More mypy apeasement on 3.7 2020-01-15 21:06:13 -05:00
setup.py Add trio-run-in-process` as dep 2020-01-21 10:28:32 -05:00

README.rst

tractor

An async-native "actor model" built on trio and multiprocessing.

travis

tractor is an attempt to bring trionic structured concurrency to distributed multi-core Python.

tractor lets you spawn trio "actors": processes which each run a trio scheduled task tree (also known as an async sandwich). Actors communicate by exchanging asynchronous messages and avoid sharing any state. This model allows for highly distributed software architecture which works just as well on multiple cores as it does over many hosts.

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.

Philosophy

tractor aims to be the Python multi-processing framework you always wanted.

Its tenets non-comprehensively include:

Warning

tractor is in alpha-alpha and is expected to change rapidly! Expect nothing to be set in stone. Your ideas about where it should go are greatly appreciated!

Install

No PyPi release yet!

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

Feel like saying hi?

This project is very much coupled to the ongoing development of trio (i.e. tractor gets all its ideas from that brilliant community). If you want to help, have suggestions or just want to say hi, please feel free to ping me on the trio gitter channel!