Як опублікувати пакети Python у PyPI за допомогою Poetry на Ubuntu 22.04

Як опублікувати пакети Python у PyPI за допомогою Poetry на Ubuntu 22.04

Вступ

PyPI (Python Package Index) — це офіційний репозиторій пакетів Python, який містить понад 300 000 пакетів, що виконують різні функції, від аналізу даних до розробки веб-додатків. Якщо ви розробили пакет Python, який, на вашу думку, буде корисний для інших, ви можете опублікувати його в PyPI, щоб зробити його доступним усім розробникам Python.

Poetry — це менеджер пакетів для Python, який спрощує процес розробки, керування та публікації пакетів Python. Він надає уніфікований інтерфейс для керування залежностями, створення пакунків і публікації їх у PyPI.

У цьому посібнику ви дізнаєтеся, як опублікувати пакет Python у PyPI за допомогою Poetry на Ubuntu 22.04. Ми крок за кроком розглянемо процес розробки, створення пакета та публікації його в PyPI.

Встановлення Poetry

Перш ніж почати, переконайтеся, що у вас встановлено Poetry. Ви можете встановити його, виконавши наступні команди в терміналі:

bash
curl -sSL https://install.python-poetry.org | python3 -

Після встановлення ви можете перевірити встановлену версію Poetry, виконавши команду:

bash
poetry --version

Створення пакета Python

1. Створіть новий каталог:
Створіть новий каталог для вашого пакета Python. Наприклад:

bash
mkdir my_package
cd my_package

2. Ініціалізуйте Poetry:
Ініціалізуйте новий проект Poetry у каталозі пакета, виконавши наступну команду:

bash
poetry init

3. Створіть файл __init__.py:
Створіть файл __init__.py у каталозі my_package і додайте до нього такий код:

python

my_package/__init__.py

Цей файл позначає каталог my_package як пакет Python.

4. Створіть модуль:
Створіть модуль Python у каталозі пакета. Наприклад:

bash
touch my_module.py

5. Напишіть код:
Додайте код до модуля my_module.py. Наприклад:

python

my_module.py

def hello_world():
print("Hello, world!")

6. Оновіть pyproject.toml:
Відредагуйте файл pyproject.toml і додайте наступний код, щоб вказати залежності та метадані пакета:


[tool.poetry]
name = "my_package"
version = "1.0.0"
description = "My awesome Python package"
authors = ["Your Name <[email protected]>"]

[tool.poetry.dependencies]
python = "^3.8"

Створення пакета

Після того, як ви створили свій пакет Python, ви можете створити розподіл пакета, який можна буде завантажити та встановити у PyPI.

1. Створіть розподіл:
Виконайте наступну команду, щоб створити розподіл пакета:

bash
poetry build

2. Перегляньте розподіл:
Ви можете переглянути створений розподіл у каталозі dist/. Він буде мати ім’я, що відповідає назві та версії вашого пакета.

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

Щоб опублікувати свій пакет в PyPI, вам потрібно мати обліковий запис на веб-сайті PyPI.

1. Створіть обліковий запис PyPI:
Перейдіть на веб-сайт PyPI та створіть обліковий запис.

2. Отримайте ключ API:
Після створення облікового запису отримайте API-ключ, перейшовши на сторінку “API”.

3. Оновіть файл конфігурації Poetry:
Відредагуйте файл pyproject.toml і додайте наступний код, щоб вказати свій API-ключ PyPI:


[tool.poetry.credentials]
pypi = "your-pypi-api-key"

4. Опублікуйте пакет:
Виконайте наступну команду, щоб опублікувати свій пакет в PyPI:

bash
poetry publish

5. Перевірте опублікований пакет:
Перейдіть на веб-сайт PyPI та знайдіть свій пакет. Він повинен бути доступним для завантаження та встановлення.

Висновок

У цьому посібнику ви дізналися, як опублікувати пакет Python у PyPI за допомогою Poetry на Ubuntu 22.04. Pubpoetry Hblishing your package on PyPI allows you to share your work with the Python community and make it available for use by other developers.

Публікуючи свій пакет у PyPI, ви можете зробити його доступним для широкої аудиторії розробників Python. Це може допомогти іншим користувачам виявити ваш пакет і скористатися його перевагами.

Крім того, публікація вашого пакета в PyPI може допомогти вам підвищити рівень впливу в спільноті Python і продемонструвати ваші навички розробки.

Часті запитання

1. Що таке PyPI?
Відповідь: PyPI (Python Package Index) — це офіційний репозиторій, що містить пакети Python.

2. Що таке Poetry?
Відповідь: Poetry — це менеджер пакетів для Python, який спрощує процес розробки, керування та публікації пакетів Python.

3. Як я можу опублікувати свій пакет у PyPI без Poetry?
Відповідь: Ви можете опублікувати свій пакет у PyPI вручну за допомогою команди python setup.py sdist upload.

4. Як я можу оновити опублікований пакет?
Відповідь: Оновіть пакет локально і опублікуйте його з новим номером версії за допомогою poetry publish.

5. Як я можу видалити пакет із PyPI?
Відповідь: Ви можете видалити пакет з PyPI, зв’язавшись із командою підтримки PyPI.

6. Що таке файл pyproject.toml?
Відповідь: Файл pyproject.toml — це конфігураційний файл, що використовується Poetry для керування метаданими пакета, залежностями та іншими параметрами конфігурації.

7. Як я можу перевірити, чи доступний мій пакет у PyPI?
Відповідь: Перейдіть на веб-сайт PyPI і знайдіть свій пакет за назвою.

8. Які переваги публікації мого пакета в PyPI?
Відповідь: Публікація вашого пакета в PyPI робить його доступним для широкої аудиторії розробників Python, підвищує ваш вплив у спільноті Python і демонструє ваші навички розробки.