webgraph-swh 0.1.1

Python bindings for Software Heritage graph access (built on webgraph)

webgraph-swh

Building from source

Pre-built wheels are compiled for a generic x86-64 target. If you need native optimizations (e.g., BMI2 for faster succinct data structures), you can build the wheel from source:

pip install maturin
git clone https://github.com/vigna/webgraph-py.git
cd webgraph-py/webgraph-swh
maturin build --release -o dist
pip install dist/*.whl

The repository's .cargo/config.toml sets target-cpu=native, so the resulting wheel will be optimized for your CPU.

Python bindings for accessing Software Heritage graphs, built on top of webgraph.

Provides bidirectional graph traversal with full access to node properties (SWHIDs, timestamps, persons, messages) for the SWH compressed graph.

Installation

pip install webgraph-swh

This automatically installs the webgraph package as a dependency.

Quick start

from webgraph_swh import SwhGraph, PyNodeType

# Load the SWH graph with all properties
g = SwhGraph("/path/to/swh-graph")

print(f"Nodes: {g.num_nodes()}")

# Traverse successors with properties
for s in g.successors(42):
    print(g.swhid(s), g.node_type(s))

# Filter by node type
revrel = g.subgraph("rev,rel")
for s in revrel.successors(42):
    print(revrel.author_id(s), revrel.author_timestamp(s))

# Access the underlying BvGraph
bv = g.forward_graph()
for root, parent, node, dist in bv.bfs():
    ...