Mr. Graph
Welcome to Mr. Graph!
Mr. Graph is a python library designed to make composing graphs of sync and async functions easy!
Getting Started
Philosophy
The purpose of Mr. Graph is to provide an efficient graph processing library for I/O bound functions. All blocking calls are ran in their own threads, and are executed concurrently with async functions. As these functions return their results, downstream functions are executed when their dependencies are done being computed.
Return values are always wrapped in dataclasses whose names and types are specified using docstrings on the functions.
This project might be useful for you if you have a graph of API calls to make which depend on each other.
Features
Mr. Graph is new and under active development. Current features include:
Use with either async or sync functions
Uses regular documentation formats to name return values.
Can infer pipelines from input and output signatures
All directed acyclic graph layouts supported. linear, fan-in, fan-out.
If you’re interested in contributing, please create a ticket on github and suggest a feature!
Example Usage
Building graphs can be as easy as:
from mr_graph import Graph
def return_one():
"""
return 1
return one with no inputs
Returns
-------
m : float
equal to 1
"""
return 1
async def add_1(m: float):
"""
add 1 to a number
add 1 to the input value m.
Parameters
----------
n : float
number to add 1 to.
Returns
-------
n : float
equal to n + 1
"""
return n + 1
async def build_implicit_linear_graph():
"""
Return 2
Simple example linear graph. Wired up automagically using the input and output variable names.
Parameters
----------
Returns
-------
two : float
always equal to 2
"""
g = Graph(nodes=[return_one, add_1])
return await g()