elliptic-curve-databases

elliptic-curve-databases packages two small, read-only elliptic-curve databases historically distributed as SageMath's elliptic_curves package:

• John Cremona's elliptic curves of conductor below 10,000, represented as a compact SQLite database; and
• William Stein's collection of interesting elliptic curves, combined with the Cremona records and grouped into text files by rank.

The package has no dependency on SageMath. It exposes the data through importlib.resources, so consumers do not need to know where the wheel was installed.

Install

Requires Python 3.13 or newer.

python -m pip install elliptic-curve-databases

The Python import name is elliptic_curve_databases.

Use

from elliptic_curve_databases import (
    available_ranks,
    cremona_mini_connection,
    iter_rank,
)

print(available_ranks())

record = next(iter_rank(3))
print(record.label, record.ainvs)

with cremona_mini_connection() as connection:
    row = connection.execute(
        "SELECT curve, eqn FROM t_curve WHERE curve = ?", ("11a1",)
    ).fetchone()
    print(row)

cremona_mini_resource() and rank_resource(rank) return standard importlib.resources traversables. For APIs that require filesystem paths, use the cremona_mini_path() and rank_path(rank) context managers; their paths are valid only while the corresponding context is active.

Regenerate the packaged data

The unmodified legacy inputs are retained under sources/. Regenerate all derived resources with:

python generate.py

Check that the committed resources are logically identical to a fresh generation without modifying them:

python generate.py --check

The SQLite comparison is logical rather than byte-for-byte because SQLite file layout can vary across SQLite releases.

Develop

python -m pip install -e '.[test]'
python generate.py --check
python -m pytest
python -m build

After the data terms are confirmed, publishing is performed only by the Release GitHub Actions workflow when a GitHub Release is published. The workflow checks the generated databases, builds and validates both distributions, smoke-tests the wheel in a clean environment, attaches the artifacts to that Release, and uses PyPI Trusted Publishing through the protected pypi environment. The Release tag must be 0.8.3 or v0.8.3. Configure the repository, release.yml workflow, and pypi environment as a PyPI Trusted Publisher before publishing the first Release.

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

Migration from the previous package

This distribution replaces sagemath-data-elliptic-curves. Install elliptic-curve-databases and change imports from sage_data_elliptic_curves to elliptic_curve_databases. The resource helpers and bundled database contents are unchanged. The two distributions use separate import namespaces and can coexist while consumers migrate.