> For the complete documentation index, see [llms.txt](https://appsecurity.gitbook.io/devops/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://appsecurity.gitbook.io/devops/ppc/ppc-langs/backend/python/packaging/intro.md).

# Intro

Guide from PyPA: <https://packaging.python.org/en/latest>

Пакеты — согласно гайду выше — все, что может быть собрано для дистрибуции, как правило — это то, что в корне содержит `pyproject.toml`, `setup.py` или `setup.cfg` (последние два использует `setuptools`).

Дистрибуция (библиотеки и инструменты):

* Исходным кодом (подходит, если среда, в которой будет запускать код соответствует вашей)
  * Называется **Source distribution** package или `sdist` (собирает в архив `.tar.gz`)
  * Можно собрать через обычные инструменты: `python -m build --sdist`
* Собранным пакетом
  * Называется **Built distribution** package (или `wheels`)
  * Wheel-формат (использует `pip`, пришел на замену Egg-формату)
  * Egg-формат (использует `setuptools`)

Сборщики состоят из двух частей:

* **Build Frontend** — это инструменты, которые собирают из исходного кода пакет для дистрибуции. Примеры build frontend — `pip` и `build`, `poetry`, `hatch` и др. Используют Build Backend's.
  * Сборка:

```
~ python -m pip install --upgrade build
~ cat pyproject.toml
~ python -m build
~ ls -al
dist/
├── example_package_YOUR_USERNAME_HERE-0.0.1-py3-none-any.whl
└── example_package_YOUR_USERNAME_HERE-0.0.1.tar.gz
```

* **Build Backend** — это библиотеки, которые умеют собирать из исходного кода пакет для дистрибуции для разных платформ, окружений и тп. Примеры: `hatchling`, `setuptools`, `meson`, `flit`, `poetry-core` и тд

Про [загрузку в PyPI](https://packaging.python.org/en/latest/tutorials/packaging-projects/#uploading-the-distribution-archives) через twine.