.deb из проекта на Python с несколькими модулями

Вопрос или проблема

├── main.py
├── setup.py
└── triumphum
    ├── autocomplection.py
    ├── symbols.py
    ├── <…>
    ├── tui_classes.py
    ├── tui_functions.py
    ├── tui_list.py
    ├── tui.py
    └── tui_screens.py

Ответ или решение

Создание пакета .deb из Python проекта является классической задачей, с которой сталкиваются разработчики программного обеспечения. Ваш проект содержит несколько модулей, и создание правильной структуры каталогов в формате Debian является ключевым шагом для успешного пакетообразования. Рассмотрим все аспекты, касающиеся размещения файлов в проекте.

Теоретическая часть

Для начала, важно понимать, что в Debian-пакете каждый файл должен располагаться в определенной иерархии, следуя стандарту FHS (Filesystem Hierarchy Standard). Это позволяет поддерживать единообразие в структуре системы и облегчает управление пакетами.

Основные каталоги:

1. /usr/bin: Здесь размещаются исполняемые файлы, к которым пользователь может получить доступ непосредственно из терминала.
2. /usr/lib: Используется для размещения архитектурозависимых данных, включая компилированные библиотеки и модули.
3. /usr/share: Предназначен для архитектуронезависимых данных, таких как документация и примеры.

Практическое применение на основе вашего проекта

Ваш проект состоит из следующих компонентов:

• main.py: Предположительно, это основной исполняемый файл вашего приложения.
• setup.py: Скрипт для установки пакета.
• Директория triumphum с несколькими модулями.

Как организовать файлы:

1. main.py: Данный файл должен быть включен в пакет как исполняемый скрипт. Стандартно такие файлы размещают в /usr/bin. Таким образом, пользователь может вызвать ваш скрипт из любой точки системы.

2. setup.py и Python модули: Эти файлы, вероятно, не требуются для выполнения на конечной системе и чаще используются в процессе разработки и сборки пакета. Однако если вы предполагаете, что setup.py будет использоваться для управления пакетами (например, в качестве дистрибутивного механизма через pip), он может быть помещен в /usr/share/yourpackage.

3. triumphum: Сами модули вашего приложения должны быть размещены в /usr/lib/python3/dist-packages/triumphum или аналогичном каталоге, который соответствует вашей версии Python. Это обеспечит возможность доступа к ним из главного исполняемого файла и других модулей.

Пример настройки каталога для .deb пакета

Для иллюстрации, ниже описан пример структуры каталогов для вашего пакета:

package/
├── DEBIAN
│   └── control
└── usr
    ├── bin
    │   └── main.py
    ├── lib
    │   └── python3.8
    │       └── dist-packages
    │           └── triumphum
    │               ├── autocomplection.py
    │               ├── symbols.py
    │               ├── <…>
    │               ├── tui_classes.py
    │               ├── tui_functions.py
    │               ├── tui_list.py
    │               ├── tui.py
    │               └── tui_screens.py
    └── share
        └── yourpackage
            └── setup.py

Применение

Теперь, когда структура каталогов ясна, вам нужно будет использовать инструмент, такой как dpkg-deb, для создания пакета .deb. С помощью данной команды вы сможете собрать ваш проект в .deb формате:

dpkg-deb --build package

Это создаст .deb файл, который можно будет установить на системах, поддерживающих формат Debian, используя стандартные инструменты управления пакетами, такие как dpkg или apt.

Заключение

Развёртывание сложных Python проектов в виде Debian пакетов требует тщательного планирования структуры каталогов и понимания стандартов, принятых в сообществе Debian. Следуя принципам FHS и учитывая потребности вашего проекта, вы сможете создать пакет, который будет легко устанавливаем и поддерживаем в различных Debian-совместимых системах.