'structured concurrent `trio`-"actors"' https://github.com/goodboy/tractor
Go to file
Tyler Goodlet 8eb9a742dd Add multi-process debugging support using `pdbpp`
This is the first step in addressing #113 and the initial support
of #130. Basically this allows (sub)processes to engage the `pdbpp`
debug machinery which read/writes the root actor's tty but only in
a FIFO semaphored way such that no two processes are using it
simultaneously. That means you can have multiple actors enter a trace or
crash and run the debugger in a sensible way without clobbering each
other's access to stdio. It required adding some "tear down hooks" to
a custom `pdbpp.Pdb` type such that we release a child's lock on the
parent on debugger exit (in this case when either of the "continue" or
"quit" commands are issued to the debugger console).

There's some code left commented in anticipation of full support for
issue #130 where we're need to actually capture and feed stdin to the
target (remote) actor which won't necessarily being running on the same
host.
2020-09-24 10:12:10 -04:00
.github/workflows Drop mac support, will continue the experiment on another branch 2020-09-03 10:41:09 -03:00
debugging Add multi-process debugging support using `pdbpp` 2020-09-24 10:12:10 -04:00
docs Small grammar fix 2020-08-31 12:17:59 -03:00
examples Move two more examples out of docs for testing 2020-02-10 12:14:16 -05:00
tests Pass a copy of the expected exposed modules 2020-09-24 10:12:10 -04:00
tractor Add multi-process debugging support using `pdbpp` 2020-09-24 10:12:10 -04:00
.gitignore Initial commit 2018-07-05 16:01:15 -04:00
.travis.yml Install docs requirements in travis tests! 2020-08-31 12:33:25 -03:00
LICENSE Initial commit 2018-07-05 16:01:15 -04:00
README.rst Drop sphinx toctree 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-docs.txt Added logo, fixed github links and grammar issues 2020-08-31 11:49:14 -03:00
requirements-test.txt More mypy apeasement on 3.7 2020-01-15 21:06:13 -05:00
setup.py Added logo, fixed github links and grammar issues 2020-08-31 11:49:14 -03:00

README.rst

tractor

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

travis Documentation Status

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 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!