PyPI

Реестр пакетов Python Package Index (PyPI) — централизованное хранилище, где разработчики могут публиковать, обнаруживать и управлять пакетами Python для общего использования.

.pypirc — конфигурационный файл, используемый для настройки параметров доступа к PyPI при публикации пакетов Python. Файл расположен в домашней папке:

• для ОС Linux — /home/username/.pypirc;
• для Windows — c:\Users\Имя_пользователя\.pypirc.

pyproject.toml — файл конфигурации проекта Python, который используется для определения информации о проекте, зависимостях, сборке и других настройках. Файл pyproject.toml обычно располагается в корневой директории проекта Python.

Публикация пакетов PyPI

1. Отредактируйте локальный файл .pypirc (vi ~/.pypirc). Пример:

[distutils]
index-servers = gitverse
   
[gitverse]
repository = https://gitverse.ru/api/packages/ваше_имя/pypi
username = ваш_username_в_GitVerse
password = ваш_пароль_в_GitVerse
   
[global]
trusted-host = https://gitverse.ru

2. Откройте файл pyproject.toml и внесите изменения. Пример:

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"
[project]
name = "pypi_package_example"
version = "1.0.0"
authors = [
    { name="coauthor1", email="coauthor1@gitverse.ru" },
]
description = "A small example package"
readme = "README.md"
requires-python = ">=3.8"
classifiers = [
    "Programming Language :: Python :: 3",
    "License :: OSI Approved :: MIT License",
    "Operating System :: OS Independent",
]

3. Выполните команды.

python3 -m pip install --upgrade build

python3 -m build

python3 -m pip install --upgrade twine

python3 -m twine upload --repository gitverse dist/*

Файлы пакета имеют расширения .tar.gz и .whl. Нельзя опубликовать пакет, если пакет с таким же именем и версией уже существует. Сначала нужно удалить существующий пакет.

Установка пакета

Порядок установки описан на странице пакета: