graph-sp 2026.1.1

High-performance DAG execution engine with Python bindings
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73

"""
Example: Branching and Variants in Python

This example demonstrates the new features:
- Creating named branches (subgraphs)
- Accessing branch information
- Future: Merging and variants (coming soon to Python API)
"""

import pygraphsp as gs


def main():
    print("=== Graph-SP Python Example: Branching ===\n")

    # Example 1: Simple Branching
    print("Example 1: Creating Branches")
    print("-----------------------------")
    graph = gs.Graph()

    # Create two experimental branches
    graph.create_branch("experiment_a")
    graph.create_branch("experiment_b")

    print(f"✓ Created branches: {graph.branch_names()}")
    print(f"✓ Has 'experiment_a': {graph.has_branch('experiment_a')}")
    print(f"✓ Has 'experiment_b': {graph.has_branch('experiment_b')}")
    print(f"✓ Has 'nonexistent': {graph.has_branch('nonexistent')}")
    print()

    # Example 2: Working with the main graph and branches
    print("Example 2: Main Graph vs Branches")
    print("----------------------------------")
    graph2 = gs.Graph()

    # Add a node to the main graph
    def main_fn(inputs):
        return {"output": "main graph result"}

    graph2.add(
        main_fn,
        label="Main Node",
        outputs=["output"]
    )

    # Create branches
    graph2.create_branch("branch_a")
    graph2.create_branch("branch_b")

    print(f"✓ Main graph has {graph2.node_count()} node")
    print(f"✓ Created {len(graph2.branch_names())} branches")
    print(f"✓ Branches: {graph2.branch_names()}")
    print()

    # Example 3: Use cases
    print("Example 3: Practical Use Cases")
    print("-------------------------------")
    print("Branches can be used for:")
    print("  • A/B testing different algorithms")
    print("  • Parallel experimentation")
    print("  • Organizing complex workflows")
    print("  • Creating variant configurations")
    print()

    print("=== Summary ===")
    print("✓ Branch creation and management demonstrated")
    print("✓ Python bindings support basic branch operations")
    print("\nNote: Full merge and variant features are available in Rust API")
    print("      and will be added to Python API in future updates.")


if __name__ == "__main__":
    main()