Repolode
pypa

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