txnx611g/farc

Framework for Asyncio/AHSM Run-to-completion Concurrency. Python 3.4 or later

farc

Framework for Asyncio/Actor/AHSM Run-to-completion Concurrency written in Python3. In other words, a cheap knock-off of QP that uses Python3 coroutines. This book describes QP and how to program statecharts(a.k.a. hierarchical state machines).

This framework has fewer than 1000 LOC. It allows the programmer to create highly-concurrent programs by using a message-passing system and run-to-completion message handlers within a state-machine architecture. With these tools, complex, asynchronous operations are decomposed into managable chunks of code.

Known Issue: On windows, Ctrl+C is supressed by asyncio event loop's run_forever() (bug report). The workaround is to inject an event to awake the event loop.

Note: This project used to be called "pq" but that name was taken in PyPI, so I renamed to farc (ugh).

Code Repository

https://github.com/dwhall/farc

Release History

2019/05/15 0.1.1

• Removed 'initialState' argument from farc.Hsm() constructor; framework now expects Hsm/Ahsm classes to have 'initial()' method.
• Made state methods private in examples to demonstrate a best-practice.
• Created farc.Framework.run_forever() helper function.
• Misc comment and doctring improvements

2018/10/09 0.1.0 Initial release