PyPI

NORA реализует спецификации PEP 503 (Simple Repository API) и PEP 691 (JSON Simple API). Загружайте пакеты с помощью twine и устанавливайте через pip с прозрачным проксированием из pypi.org.

Настройка клиента

Установка пакетов через NORA:

pip install --index-url http://nora.example.com:4000/simple/ my-package

Настройка pip.conf для проекта или через переменную окружения:

export PIP_INDEX_URL=http://nora.example.com:4000/simple/

Загрузка пакетов:

twine upload --repository-url http://nora.example.com:4000/simple/ dist/*

Проксирование upstream

NORA загружает пакеты из PyPI, если они не найдены локально. URL для скачивания на страницах индекса перезаписываются для загрузки через NORA.

config.toml:

[pypi]
enabled = true
proxy = "https://pypi.org/simple/"
proxy_timeout = 30

Переменные окружения:

Переменная	Описание	По умолчанию
NORA_PYPI_ENABLED	Включить реестр PyPI	true
NORA_PYPI_PROXY	URL upstream-реестра	https://pypi.org/simple/
NORA_PYPI_PROXY_AUTH	Аутентификация upstream (user:pass)	—
NORA_PYPI_PROXY_TIMEOUT	Таймаут upstream в секундах	30

Возможности

Функция	Статус	Примечание
Simple-индекс (HTML)	Полная	PEP 503
Simple-индекс (JSON)	Полная	PEP 691, через заголовок Accept
Страница версий пакета	Полная	HTML + JSON
Скачивание файлов	Полная	Wheel, sdist, egg
twine upload	Полная	Multipart form-data
Хеши SHA256	Полная	В ссылках метаданных
Нормализация регистра	Полная	My-Package становится my-package
JSON API метаданные	Полная	application/vnd.pypi.simple.v1+json
Upstream-прокси	Полная	Настраиваемый TTL
Yanking	—	Не реализовано
Подписи загрузки (PGP)	—	Не реализовано

За reverse proxy

Когда NORA работает за Caddy, Traefik или Nginx, установите NORA_PUBLIC_URL, чтобы ссылки на скачивание указывали на внешний адрес, а не на http://0.0.0.0:4000:

NORA_PUBLIC_URL=https://registry.example.com

Если прокси использует самоподписанный сертификат, pip молча падает с ошибкой “No matching distribution found”. Решение:

# Вариант 1: доверять хосту
pip install --trusted-host registry.example.com my-package

# Вариант 2: указать CA-сертификат
pip install --cert /path/to/ca.crt my-package

Для постоянной настройки создайте ~/.pip/pip.conf:

[global]
index-url = https://registry.example.com/simple/
trusted-host = registry.example.com

Подробнее о настройке TLS — в разделе TLS / HTTPS.

Известные ограничения

• Yanking не поддерживается.
• PGP-подписи при загрузке не поддерживаются.