graph-databases

graph-databases packages the graph database resources historically shipped as SageMath's graphs data package. It has no dependency on Sage and performs no network access or writes at import or run time.

The distribution contains:

• graphs.db, an immutable SQLite database of unlabeled graphs;
• brouwer_srg_database.json, the strongly regular graph parameter database;
• isgci_sage.xml, the ISGCI graph-class database; and
• smallgraphs.txt, the small-graph names used with the ISGCI data.

Installation

Requires Python 3.13 or newer.

python -m pip install graph-databases

The Python import name is graph_databases.

API

Use the resource API when consuming the raw files:

from graph_databases import open_resource, resource, resource_path

with open_resource("smallgraphs.txt", "r") as stream:
    first_line = stream.readline()

# `resource_path` also works when a loader needs a real filesystem path.
with resource_path("isgci_sage.xml") as path:
    print(path)

The SQLite helper always opens the bundled database read-only and closes the connection after the context exits:

from graph_databases import graph_database_connection

with graph_database_connection() as connection:
    rows = connection.execute("SELECT count(*) FROM graph_data").fetchone()[0]

The Brouwer JSON data can be decoded with one call:

from graph_databases import load_brouwer_database

records = load_brouwer_database()

Only known top-level resource names are accepted. The package never modifies its installed resources; applications that download updates should store them in a separate user-writable location.

Releases

Publishing a GitHub Release runs the repository's Release GitHub Actions workflow. The workflow builds and checks the wheel and source distribution, smoke-tests the wheel in a clean environment, attaches both files to the GitHub Release, and publishes them to PyPI through Trusted Publishing. The Release tag must be 20210214.2 or v20210214.2. Configure a PyPI Trusted Publisher for this repository, the release.yml workflow, and the pypi environment before publishing the first release. Do not publish a release until the data-license blocker below has been resolved.

Data provenance and licensing

The Python source and packaging files are provided under GPL-2.0-or-later. The bundled databases come from several upstream sources and retain their source-specific terms. Sage's existing COPYING.txt labels graphs as None (database), so the precise redistribution terms must be confirmed with the data owners before a public PyPI release. See DATA_LICENSES.md for the provenance currently recorded by Sage.

For the new PyPI project, configure a pending Trusted Publisher with project graph-databases, GitHub owner sagemath, repository data-graphs, workflow filename release.yml, and environment pypi.

Migration from the previous package

This distribution replaces sagemath-data-graphs. Install graph-databases and change imports from sage_data_graphs to graph_databases. The resource helpers and bundled database contents are unchanged. The two distributions use separate import namespaces and can coexist while consumers migrate.