Repositório oficial do sistema de build Setuptools, a biblioteca de empacotamento Python usada para criar e distribuir projetos Python.
pypa/wheel
Ferramenta de linha de comando para inspecionar, descompactar, reempacotar e alterar tags de arquivos Python wheel (.whl), além de converter eggs em wheels.
- Estrelas
- 580
- Forks
- 200
- Issues abertas
- 22
- Último commit
- há 10 dias
O que é?
wheel é a ferramenta oficial de linha de comando do projeto PyPA para trabalhar com arquivos de distribuição binária do Python no formato wheel, definido pela PEP 427. Um wheel é um arquivo de pacote pré-compilado que permite ao pip instalar um projeto Python sem executar uma etapa de build na máquina do usuário.
A ferramenta oferece quatro operações: converter arquivos .egg legados em .whl, descompactar um wheel em um diretório, reempacotar um diretório editado como wheel e adicionar ou remover tags de plataforma e interpretador de um wheel existente. Essas operações são úteis quando é preciso adaptar um pacote para outra plataforma ou reempacotá-lo após uma modificação.
O projeto não oferece mais o comando de build bdist_wheel; desde o setuptools v70.1, o próprio setuptools compila wheels. Instale este pacote apenas se precisar da ferramenta de linha de comando wheel.
Recursos principais
- 01Converte arquivos .egg para o formato .whl
- 02Descompacta arquivos wheel em um diretório
- 03Reempacota diretórios editados como arquivos wheel
- 04Adiciona ou remove tags de wheels existentes
Casos de uso
- Alterar as tags de um wheel para que seja compatível com outra plataforma ou versão do Python
- Inspecionar ou editar o conteúdo de um wheel antes de redistribuí-lo
- Migrar distribuições antigas baseadas em egg para o formato wheel
Antes de usar
- Só é útil se você precisar da ferramenta de linha de comando wheel, pois o setuptools não precisa mais dela para criar wheels.
Tópicos
Perguntas frequentes
- O que é wheel?
- Ferramenta de linha de comando para inspecionar, descompactar, reempacotar e alterar tags de arquivos Python wheel (.whl), além de converter eggs em wheels. wheel é a ferramenta oficial de linha de comando do projeto PyPA para trabalhar com arquivos de distribuição binária do Python no formato wheel, definido pela PEP 427. Um wheel é um arquivo de pacote pré-compilado que permite ao pip instalar um projeto Python sem executar uma etapa de build na máquina do usuário.
- wheel é gratuito? Qual é a licença?
- wheel é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
- wheel ainda é mantido?
- Manutenção ativa. O último commit de wheel foi em 28 de out. de 2026.
- Para que posso usar wheel?
- Alterar as tags de um wheel para que seja compatível com outra plataforma ou versão do Python Inspecionar ou editar o conteúdo de um wheel antes de redistribuí-lo Migrar distribuições antigas baseadas em egg para o formato wheel
- Onde consigo wheel?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/pypa/wheel
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Utilitário de linha de comando para enviar distribuições Python de código-fonte e wheels ao PyPI, independentemente do sistema de build usado.
Um gerenciador de pacotes e projetos Python extremamente rápido, escrito em Rust, que substitui pip, virtualenv, pyenv, pipx e outras ferramentas.
Ferramenta de virtualenv e gerenciamento de dependências Python que combina pip e virtualenv e usa Pipfile e Pipfile.lock para builds reproduzíveis.
O instalador padrão de pacotes do Python, usado para instalar pacotes do Python Package Index (PyPI) e de outros índices.
Conjunto de ferramentas de linha de comando (pip-compile e pip-sync) que fixa dependências Python em arquivos de requirements reproduzíveis e mantém os ambientes sincronizados com eles.