Documentation

Reference

PyPI protocol and configuration details.

  • Standards

    Packaging PEPs and specifications implemented by the PyPI ecosystem.

  • HTTP endpoints

    The routes every index serves, plus health and metrics.

  • Upload rules

    The exact upload checks peryx runs: wheel .dist-info matching, the digest fields it verifies, PEP 440 version matching for admin operations, and the mutation paths for verb-named projects, with every accept/reject table and error string.

  • Simple API serving

    Simple API version derivation, gpg-sig retention, provenance, and slashless URL redirects.

  • Mirroring

    Select, sync, and verify PyPI projects and artifacts.

  • Availability behavior

    Python package authority keys, replica reads, upload retries, reclamation references, and log fields.

  • PyPI changelog compatibility

    The Warehouse XML-RPC routes, journal contract, and mirror recovery procedure.

  • Policy settings

    PyPI-specific fallback, version, distribution, wheel-tag, release-age, and attestation policy.

  • Shadowed candidates

    Inspect the Python distribution selected from a virtual index and the candidates it shadows.