mainframe.pypi

Minimal client over PyPI JSON API.

Attributes

PYPI_BASE_URL

Exceptions

PackageNotFoundError

Raised when a package version is not found on PyPI.

Classes

Distribution	A single downloadable file (e.g. an sdist or wheel) for a release.
PackageMetadata	The subset of PyPI package metadata that mainframe uses.
Info	The info object of the PyPI JSON response (only the fields we read).
JSONResponse	The shape of the PyPI JSON response, limited to what we parse.
PyPIClient	A minimal synchronous client for the PyPI JSON API.

Module Contents

mainframe.pypi.PYPI_BASE_URL = 'https://pypi.org/pypi'

exception mainframe.pypi.PackageNotFoundError(name: str, version: str)

Bases: Exception

Raised when a package version is not found on PyPI.

name

version

class mainframe.pypi.Distribution(/, **data: Any)

Bases: pydantic.BaseModel

A single downloadable file (e.g. an sdist or wheel) for a release.

url: str

class mainframe.pypi.PackageMetadata(/, **data: Any)

Bases: pydantic.BaseModel

The subset of PyPI package metadata that mainframe uses.

name: str

version: str

distributions: list[Distribution]

class mainframe.pypi.Info(/, **data: Any)

Bases: pydantic.BaseModel

The info object of the PyPI JSON response (only the fields we read).

name: str

version: str

class mainframe.pypi.JSONResponse(/, **data: Any)

Bases: pydantic.BaseModel

The shape of the PyPI JSON response, limited to what we parse.

info: Info

urls: list[Distribution] = None

class mainframe.pypi.PyPIClient(http_client: httpx.Client)

A minimal synchronous client for the PyPI JSON API.

http_client

get_package_metadata(name: str, version: str) → PackageMetadata

Fetch metadata for a specific version of a package.

Parameters:

• name – The package name.

• version – The package version.

Returns:

The metadata for the requested package.

Raises:

PackageNotFoundError – If the package or version does not exist on PyPI.