selinonlib 1.0.0rc1

a simple tool to visualize, check and generate Python code from a YAML configuration file for Selinon dispatcher for Celery

A simple tool to visualize, check dependencies and generate Python code for Selinon. You can find generated Sphinx documentation here. Project is hosted on Github.

Is this project helpful? Send me a simple warm message!

Crossroad

• PyPI

• Developers documentation

• Travis CI

The Idea

A system consists of two main parts: * nodes * directed edges with conditions

A node can produce or accept a message. Each node is uniquely identified by its name which has to be unique in defined system. There are available two main types of nodes: * task * flow

A flow consists of tasks and each flow can be seen as a task (a black box) so flows can be used inside another flows as desired.

Conditions are made of predicates that can be used with logical operators and, or or not. You can run multiple tasks based on conditions or you can inspect multiple results of tasks in order to proceed with computation in the flow.

Cyclic dependencies on tasks and flows are fully supported. See Selinon for more info and examples.

Installation

$ pip3 install selinonlib

FAQ

Why is this tool useful?

See Selinon for usage examples. This tool is intended to automatically generate Python code from a YAML configuration file, perform additional consistency checks or plot flow graphs. It also provides a Selinon user a pack of predefined storage/database adapters and other tools suitable for user-specific Selinon configuration.

Examples:

Plot graphs of flows:

$ selinonlib-cli -vvv plot --nodes-definitions nodes.yml --flow-definitions flow1.yml flow2.yml --format svg --output-dir ./ && xdg-open flow1.svg

Generate Python code configuration for Selinon:

$ selinonlib-cli -vvv inspect --nodes-definitions nodes.yml --flow-definitions flow1.yml flow2.yml --dump out.py && cat out.py