Repolode
Enviar
pypa

pypa/flit

Uma ferramenta simples para criar e publicar pacotes e módulos Python puros no PyPI com o mínimo de configuração.

Ver no GitHubSite
Estrelas
2,262
Forks
173
Issues abertas
125
Último commit
há 10 dias

O que é?

Flit empacota um único módulo ou pacote Python importável e o publica no PyPI. A ferramenta busca reduzir o número de decisões que a pessoa responsável pela manutenção precisa tomar sobre o empacotamento e evita erros comuns. O nome do pacote no PyPI é igual ao nome usado para importá-lo, e os subpacotes e arquivos de dados incluídos nele são adicionados automaticamente.

O fluxo de trabalho típico é adicionar uma versão e uma docstring de uma linha ao módulo, executar `flit init` para gerar um pyproject.toml e, em seguida, executar `flit publish`. A versão e a descrição são lidas do próprio módulo. Scripts de linha de comando e outros metadados são configurados no pyproject.toml. Arquivos flit.ini antigos podem ser convertidos com um módulo auxiliar incluído.

Para o desenvolvimento local, `flit install` instala um pacote em um ambiente, opcionalmente como um symlink para que as alterações tenham efeito imediato. Quem instala um wheel publicado recebe um pacote padrão, enquanto a instalação do sdist faz com que o pip use o Flit em um ambiente temporário.

Recursos principais

  • 01Publica um único módulo ou pacote no PyPI usando o nome de importação.
  • 02Lê a versão e a descrição do módulo, evitando duplicá-las.
  • 03Gera um pyproject.toml com `flit init`.
  • 04Inclui subpacotes e arquivos de dados automaticamente.
  • 05Instala pacotes localmente para desenvolvimento, opcionalmente como symlinks.

Casos de uso

  • Publicar uma pequena biblioteca Python pura no PyPI sem escrever um setup.py.
  • Converter um projeto antigo baseado em flit.ini para pyproject.toml.
  • Configurar uma instalação local editável de um pacote durante o desenvolvimento.

Início rápido

  1. 1

    Instale o flit com pip

    python3 -m pip install flit
  2. 2

    Adicione uma docstring de uma linha e __version__ ao seu módulo

  3. 3

    Execute flit init no diretório do módulo para criar o pyproject.toml

    flit init
  4. 4

    Envie seu pacote para o PyPI

    flit publish

Antes de usar

  • Empacota apenas um módulo ou pacote importável por vez.
  • Para serem distribuídos, módulos Python 2 também precisam ser importados sem erros no Python 3.

Tópicos

#python#packaging#pypi#build-tool#pyproject

Perguntas frequentes

O que é flit?
Uma ferramenta simples para criar e publicar pacotes e módulos Python puros no PyPI com o mínimo de configuração. Flit empacota um único módulo ou pacote Python importável e o publica no PyPI. A ferramenta busca reduzir o número de decisões que a pessoa responsável pela manutenção precisa tomar sobre o empacotamento e evita erros comuns. O nome do pacote no PyPI é igual ao nome usado para importá-lo, e os subpacotes e arquivos de dados incluídos nele são adicionados automaticamente.
flit é gratuito? Qual é a licença?
flit é open source sob a licença BSD-3-Clause. Confira os termos da licença antes de usá-lo em produtos comerciais.
flit ainda é mantido?
Manutenção ativa. O último commit de flit foi em 27 de out. de 2026.
Para que posso usar flit?
Publicar uma pequena biblioteca Python pura no PyPI sem escrever um setup.py. Converter um projeto antigo baseado em flit.ini para pyproject.toml. Configurar uma instalação local editável de um pacote durante o desenvolvimento.
Como instalar flit?
Instale o flit com pip: python3 -m pip install flit Adicione uma docstring de uma linha e __version__ ao seu módulo Execute flit init no diretório do módulo para criar o pyproject.toml: flit init Envie seu pacote para o PyPI: flit publish
Onde consigo flit?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/pypa/flit

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados