Сборка Python проекта в один исполняемый файл: практические методы

Расширенные примеры и результаты

Пример 1: PyInstaller с включением дополнительных данных (файлы конфигурации, изображения)

# tree.py
import sys
import os
from pathlib import Path

def resource_path(relative_path):
    """Получить путь к файлу, учитывая упаковку PyInstaller."""
    if getattr(sys, 'frozen', False):
        base_path = sys._MEIPASS
    else:
        base_path = os.path.abspath(".")
    return os.path.join(base_path, relative_path)

# Использование
config_path = resource_path('config.ini')
with open(config_path) as f:
    print(f.read())

# Команда сборки с добавлением папки data
pyinstaller --onefile --add-data "data;data" tree.py

Результат: после запуска tree.exe он корректно находит config.ini внутри упакованного архива.

# Вывод (пример содержимого config.ini)
[APP]
version = 2.1
mode = production

Пример 2: Nuitka с оптимизацией и замером производительности

# test_speed.py
import time

def heavy_function():
    total = 0
    for i in range(10_000_000):
        total += i * i
    return total

start = time.perf_counter()
result = heavy_function()
end = time.perf_counter()
print(f"Result: {result}")
print(f"Time: {end - start:.3f} sec")

# Команда компиляции
nuitka --mingw64 --onefile --lto=yes test_speed.py

# Результат (среднее время):
Python interpreter: ~2.1 sec
Nuitka compiled EXE: ~1.3 sec (ускорение ~40%)

Опция --lto=yes включает Link Time Optimization для лучшей производительности.

Пример 3: cx_Freeze с указанием включения модулей для работы с OpenCV (cv2)

# setup_opencv.py
from cx_Freeze import setup, Executable

build_exe_options = {
    "packages": ["cv2", "numpy"],
    "excludes": ["tkinter", "PyQt5"]  # исключить ненужное
}

setup(
    name="CVApp",
    version="1.0",
    options={"build_exe": build_exe_options},
    executables=[Executable("image_processor.py")]
)

Сборка: python setup_opencv.py build

Пример 4: py2exe для старого скрипта на Python 3.6

# legacy_setup.py
from distutils.core import setup
import py2exe
import sys

# Если нет консольного окна
sys.argv.append('py2exe')

setup(
    options = {
        "py2exe": {
            "bundle_files": 1,
            "compressed": True,
            "includes": ["json", "os"]
        }
    },
    console=["legacy_script.py"],
    zipfile = None,
)

Запуск: python legacy_setup.py

# Успешная сборка: в папке dist появится legacy_script.exe размером ~15 MB

Пример 5: auto-py-to-exe с нестандартным портом и автоматическим открытием

# Запуск с изменённым портом (по умолчанию 8080)
auto-py-to-exe --port 9090

После открытия браузера выберите скрипт, укажите параметры и нажмите "Convert .py to .exe". Для консольных приложений отметьте "Console Based".

Пример 6: PyOxidizer с явным указанием зависимостей (для проекта с requests)

# pyoxidizer.bzl (полный файл)
def make_exe():
    dist = default_python_distribution()
    policy = dist.make_python_packaging_policy()
    policy.allow_embedding = True
    exe = dist.to_python_executable(
        name="myapp",
        packaging_policy=policy,
    )
    exe.add_python_resources(exe.pip_install(["requests"]))
    exe.add_python_resources(exe.read_package_root(
        path="src",
        packages=["myapp"],
    ))
    return exe

register_target("exe", make_exe, default=True)

Сборка: pyoxidizer build --release

# Результат: бинарник ~10 MB (существенно меньше, чем у PyInstaller)

Все примеры демонстрируют практические приёмы, которые помогут избежать типовых ошибок и адаптировать сборку под конкретный проект.