'structured concurrent `trio`-"actors"' https://github.com/goodboy/tractor

Go to file

Tyler Goodlet e6245671b0 Use runtime level on attach		2021-01-02 21:38:55 -05:00
.github/workflows	Include Python 3.9 in CI	2020-12-27 13:28:54 -05:00
docs	Allow passing function refs to `Portal.run()`	2020-12-21 09:09:55 -05:00
examples	Drop warning level logging assert(s)	2020-12-26 15:45:55 -05:00
tests	Drop warning level logging assert(s)	2020-12-26 15:45:55 -05:00
tractor	Use runtime level on attach	2021-01-02 21:38:55 -05:00
.gitignore	Initial commit	2018-07-05 16:01:15 -04:00
LICENSE	Initial commit	2018-07-05 16:01:15 -04:00
README.rst	Merge pull request #129 from goodboy/multiproc_debug	2020-10-14 09:14:03 -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	Add pdbpp as dep	2020-09-24 10:12:32 -04:00

README.rst

tractor

A structured concurrent, async-native "actor model" built on trio and multiprocessing.

tractor is an attempt to bring trionic structured concurrency to distributed multi-core Python; it aims to be the Python multi-processing framework you always wanted.

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.

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 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 on in our matrix channel. If matrix seems too hip, we're also mostly all in the the trio gitter channel!