zipapp transforma um diretório de código em um arquivo ZIP executável pelo Python. O formato .pyz é conveniente para ferramentas internas e aplicações puramente Python com uma entrada clara.

Organize e empacote a aplicação

python -m zipapp minha_app -m "cli:main" -p "/usr/bin/env python3" -o minha_app.pyz
python minha_app.pyz --help

Defina um ponto de entrada estável

A opção -m cria o __main__.py que importa e chama a função indicada. Se o diretório já contém esse arquivo, preserve uma única estratégia. Não inclua segredos, caches ou ambientes virtuais no diretório de origem.

Conheça os limites de distribuição

O arquivo não embute o interpretador nem resolve automaticamente extensões nativas. Dependências precisam estar no ambiente ou ser compatíveis com inclusão no arquivo. Registre a versão mínima do Python e teste no sistema de destino.

Continue estudando

Leia também criação de interfaces de linha de comando. A documentação oficial do Python, consultada em 22 de julho de 2026, explica entry points, shebang e cópia de arquivos existentes.