Skip to main content

Transforme seu projeto Python em um executável

Project description

Py to Exe Converter

Py to Exe Converter é uma aplicação desenvolvida em Python utilizando PyQt5 que permite converter scripts Python (.py) em executáveis (.exe) de forma simples e intuitiva. A aplicação oferece funcionalidades como seleção de ícones personalizados, definição de diretórios de saída e exibição de uma interface gráfica amigável com indicadores de progresso durante o processo de conversão.

🛠️ Funcionalidades

  • Conversão Fácil: Converta scripts Python em executáveis de uma única clique.
  • Seleção de Ícone Personalizado: Adicione ícones personalizados aos executáveis gerados.
  • Definição de Diretório de Saída: Escolha onde deseja salvar os executáveis convertidos.
  • Interface Gráfica Intuitiva: Utilize uma interface amigável com indicadores de progresso durante a conversão.
  • Fechamento Automático: A aplicação fecha automaticamente após a conclusão da conversão.
  • Resolução Personalizada: Configure a resolução das janelas para 800x600 pixels.

📋 Requisitos

Antes de começar, certifique-se de ter os seguintes pré-requisitos instalados:

  • Python 3.6 ou superior
  • pip (gerenciador de pacotes Python)
  • Ambiente Virtual (opcional, mas recomendado)

📦 Instalação

Para instalar o pacote, você pode usar o pip:

pip install py2exe

Utilização

Para executar o código, importe o módulo da seguinte maneira:

from py2exe import run

launch()
  1. Clone o Repositório:

    git https://github.com/hqr90/py2exe.git
    cd py-to-exe-converter
    
  2. Crie e Ative um Ambiente Virtual (Opcional, mas Recomendado):

    # No Windows
    python -m venv .venv
    .venv\Scripts\activate
    
    # No macOS/Linux
    python3 -m venv .venv
    source .venv/bin/activate
    
  3. Instale as Dependências Necessárias:

    pip install -r requirements.txt
    

    Nota: Caso não tenha um arquivo requirements.txt, instale manualmente as bibliotecas:

    pip install PyQt5 Pillow
    
  4. Adicione os Arquivos de Recursos:

    • icone_app.ico: Ícone para a aplicação. Coloque este arquivo no mesmo diretório do script principal.
    • spinner.gif: GIF animado para o indicador de progresso. Coloque este arquivo no mesmo diretório do script principal.

    Exemplo de Estrutura de Diretórios:

    py-to-exe-converter/
    ├── icone_app.ico
    ├── main.py
    ├── README.md
    └── requirements.txt
    

📂 Uso

  1. Execute a Aplicação:

    python __init__.py
    
  2. Interface da Aplicação:

    • Nome do Programa: Insira o nome desejado para o executável.
    • Caminho do Programa: Selecione o arquivo .py que você deseja converter.
    • Exibir Prompt: Marque a caixa se desejar que a janela do prompt seja exibida durante a execução do executável.
    • Adicionar Ícone Personalizado: Marque a caixa se desejar adicionar um ícone personalizado e selecione o arquivo de ícone.
    • Diretório de Saída: Selecione a pasta onde o executável será salvo.
  3. Criar Executável:

    • Clique no botão "Criar Executável".
    • A interface principal será substituída pela tela de progresso exibindo a mensagem "Convertendo .py para .exe..." e o indicador de carregamento.
    • Após a conclusão:
      • Sucesso: Uma mensagem de sucesso será exibida e a aplicação será fechada automaticamente.
      • Erro: Uma mensagem de erro detalhada será exibida, e a aplicação retornará para a página principal, permitindo que você tente novamente.

Explicação dos Argumentos:

  • --onefile: Cria um único arquivo executável.
  • --icon=icone_app.ico: Define o ícone do executável.
  • --add-data "icone_app.ico;.": Inclui o arquivo de ícone no diretório raiz do executável. Nota: No Windows, use ponto e vírgula (;) para separar o caminho da fonte e o destino. Em sistemas Unix, use dois pontos (:).

🐞 Resolução de Problemas

Erro ao Criar o Executável:

  • Permissões de Arquivo: Verifique se você tem permissões adequadas para ler os arquivos de entrada e escrever no diretório de saída.
  • Dependências do PyInstaller: Certifique-se de que todas as dependências necessárias estão instaladas no seu ambiente virtual.

🤝 Contribuição

Contribuições são bem-vindas! Se você encontrar bugs, tiver sugestões de melhorias ou quiser adicionar novas funcionalidades, sinta-se à vontade para abrir uma issue ou enviar um pull request.

📄 Licença

Este projeto está licenciado sob a Licença MIT.

📞 Contato

Para mais informações ou dúvidas, entre em contato com rebello.hiltonqueiroz@gmail.com.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

simplepy2exe-0.1.2.tar.gz (9.5 kB view details)

Uploaded Source

File details

Details for the file simplepy2exe-0.1.2.tar.gz.

File metadata

  • Download URL: simplepy2exe-0.1.2.tar.gz
  • Upload date:
  • Size: 9.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.3

File hashes

Hashes for simplepy2exe-0.1.2.tar.gz
Algorithm Hash digest
SHA256 50511ba44ba28ba08be67b371b19e8e3ab4a82d5bf96a5ff9ce47634cea8e8b1
MD5 ad759111a1c0f403c8e60a8dc82dc2e0
BLAKE2b-256 93a6604ba2c2e2564b2982113491798c9dacf70141f7de1d132e101d5dacb20b

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page