Как правильно указывать имя пакета и точку входа в Poetry

Question

Я начинаю работать с Python-пакетами через Poetry и столкнулся с непониманием структуры. Нужно уточнить: что именно указывается в `tool.poetry.name`, зачем в задании используется `hexlet-code`, как работает `[tool.poetry.scripts]` и что такое путь до точки входа. Можно ли имя папки отличать от алиаса, по которому вызывается пакет?

Nikolai Gagarinov · Answer

1. `tool.poetry.name` — это основное имя пакета, под которым он будет идентифицироваться и устанавливаться.
2. Использование имени вроде `hexlet-code` в задании нужно для автотестов и проверки корректности работы пакета, так что менять его нельзя.
3. Конструкция `[tool.poetry.scripts] hexlet-python-package = "hexlet_python_package.scripts.hexlet_python_package:main"` задаёт алиас `hexlet-python-package`, по которому установленный пакет можно вызывать через командную строку (`poetry run hexlet-python-package`) или после компиляции/установки пакета.
4. Правая часть (`hexlet_python_package.scripts.hexlet_python_package:main`) указывает путь до точки входа: сначала папка с кодом (`hexlet_python_package`), потом модуль (`scripts.hexlet_python_package`), и функция `main`. Имя папки может отличаться, главное, чтобы путь корректно указывал на функцию запуска.

Иными словами, алиас — это удобное имя для запуска, а путь до точки входа — реальное расположение функции внутри пакета.

Как правильно указывать имя пакета и точку входа в Poetry

Ответы