nan-graph (Python)

Port en Python del core @carloscortezcloud/nan-graph (TypeScript) — el motor del grafo de SOFE Architecture Graph (fusión Ñan × BYaML v2). OSS, Apache-2.0, bajo breakingthecloud.

Misma API que el core TS; se mantiene en sync manual (patrón styrr → styrr-py).

Grafo dirigido en memoria con relaciones tipadas: traversal BFS/DFS, blast radius, cost chain, fan-in / SPOF, y filtrado por tipo de relación.

Install

pip install nan-graph

Uso

from nangraph import NanGraph, blast_radius, cost_chain, from_yaml

g = (
    NanGraph()
    .add_node({"id": "api", "type": "aws.apigateway", "attrs": {"monthly_cost": 20}})
    .add_node({"id": "lambda", "type": "aws.lambda", "attrs": {"monthly_cost": 5}})
    .add_node({"id": "ddb", "type": "aws.dynamodb", "attrs": {"monthly_cost": 30}})
    .add_edge("api", "lambda", "routes_to")
    .add_edge("lambda", "ddb", "reads_writes")
)

blast_radius(g, "api")   # ['lambda', 'ddb'] — qué se cae si api falla
cost_chain(g, "api")     # 55.0 — costo downstream total

Importar desde YAML / JSON

from nangraph import from_yaml, from_object

# estilo dependency-graph.yaml
g = from_yaml("""
nodes:
  sofe-engine: { type: python-library }
  sofe-server: { type: python-api }
edges:
  - { from: sofe-engine, to: sofe-server, relType: bundles }
""")

# estilo BYaML v0.3 (components + relationships)
g2 = from_object({
    "components": [{"id": "api", "type": "aws.apigateway", "monthly_cost": 20}],
    "relationships": [{"from": "api", "to": "lambda", "type": "routes_to"}],
})

API

Paridad con el core TS

Licencia

Apache-2.0. Ver LICENSE.