Metadata-Version: 2.1
Name: ryvencore
Version: 0.4.0a11
Summary: Python backend for node editor-like graph-based processing
Home-page: https://github.com/leon-thomm/ryvencore
Author: Leon Thomm
Author-email: l.thomm@mailbox.org
Project-URL: Website, https://ryven.org
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU Lesser General Public License v2 or later (LGPLv2+)
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE


<p align="center">
  <img src="./docs/img/logo.png" alt="drawing" width="70%"/>
</p>

An experimental Python library for graph-based processing, designed for flow-based/node-based visual scripting editors. It is the backbone of the [Ryven](https://github.com/leon-thomm/Ryven) project, but it can very much be used in other contexts as well.

While ryvencore is written purely in Python, it is very lightweight and highly compatible. It can be compiled with Cython, see the `setup_cython.py` file. The performance seems comparable so far, but the code hasn't been optimized for Cython yet, so there might be a lot of potential. Please consider contributing. ryvencore also seems compatible with most Python ports to WebAssembly, even the Cython compiled ryvencore.

### Installation

```
pip install ryvencore
```

or from sources:
```
git clone https://github.com/leon-thomm/ryvencore
cd ryvencore
pip install .
```

### Usage

As an experimental library, the API is not fully stable and small breaking changes over time should be expected. Generally, the API is defined by what is included in the [docs](https://leon-thomm.github.io/ryvencore/).

### Examples

**loading a project** e.g. exported from Ryven

```python
import ryvencore as rc
import json
import sys

if __name__ == '__main__':
    # project file path
    fpath = sys.args[1]

    # read project file
    with open(fpath, 'r') as f:
        project: dict = json.loads(f.read())

    # run ryvencore
    session = rc.Session()
    session.load(project)

    # access the first flow
    f = session.flows[0]
    
    # and the last node that was created
    my_node = f.nodes[-1]

    # and execute it
    my_node.update()
```

### Features

The main features include

- **load & save** from and into JSON
- **a simple and powerful nodes system** which lets you do anything, simple and unrestricted
- **data *and* exec flow support** - unlike lots of other solutions out there, ryvencore supports exec flows
- **variables system** with subscribe and update mechanism to build nodes that automatically adapt to change of data
- **built-in logging** based on python's `logging` module
- **actions system for nodes** (WIP)

### Licensing

ryvencore is licensed under the [LGPL License](github.com/leon-thomm/ryvencore/blob/master/LICENSE).
