forked from goodboy/tractor
1
0
Fork 0
'structured concurrent `trio`-"actors"'
Go to file
Tyler Goodlet a668f714d5 Allow passing function refs to `Portal.run()`
This resolves and completes #69 allowing all RPC invocation APIs to pass
function references directly instead of explicit `str` names for the
target namespace and function (this is still done implicitly
underneath).  This brings us closer to `trio`'s task running API as well
as acknowledges that any inter-host RPC system (and API) will likely
need to be implemented on top of local RPC primitives anyway. Even if
this ends up **not** being true we can always go to "function stubs" as
part of our IAC protocol or, add a new method to do explicit namespace
calls: `.run_from_module()` or whatever everyone votes on.

Resolves #69

Further, this commit drops `Actor.statespace` from the entire system
since a user can easily get this same functionality using module
level variables. Fix docs to match all these changes (luckily mostly
already done due to example scripts referencing).
2020-12-21 09:09:55 -05:00
.github/workflows Report on skipped tests 2020-10-13 16:30:19 -04:00
docs Allow passing function refs to `Portal.run()` 2020-12-21 09:09:55 -05:00
examples Allow passing function refs to `Portal.run()` 2020-12-21 09:09:55 -05:00
tests Allow passing function refs to `Portal.run()` 2020-12-21 09:09:55 -05:00
tractor Allow passing function refs to `Portal.run()` 2020-12-21 09:09: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.

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