Uma extensão do dmtoolbox focada em funcionalidades específicas do Windows, incluindo manipulação de registros, criação de executáveis e gerenciamento de arquivos e configurações avançadas do sistema.
Project description
dmtoolbox-win
- dmtoolbox-win
Descrição
dmtoolbox-win
é uma extensão do dmtoolbox
, projetada especificamente para integrar funcionalidades específicas do ambiente Windows em seus projetos Python. Este pacote complementar oferece ferramentas poderosas para manipulação de registros do Windows, criação de executáveis, gerenciamento avançado de arquivos e diretórios, e muito mais.
Funcionalidades
-
appdataGen: Facilita a criação, manipulação e organização de arquivos e pastas dentro do diretório AppData do Windows, permitindo o armazenamento de dados de aplicativos de forma estruturada e acessível.
-
createExeOnC: Auxilia na criação de cópias executáveis da sua aplicação diretamente no disco local C, simplificando o processo de instalação e distribuição de software.
-
exeGenerator: Utiliza o PyInstaller para converter scripts Python em executáveis autônomos para Windows, facilitando a distribuição de aplicações sem necessidade de instalação do Python.
-
regedit: Fornece uma interface programática para a criação, leitura, edição e exclusão de registros do Windows, permitindo a modificação de configurações do sistema e de aplicativos de maneira automatizada.
Funcionalidades dos Módulos
Cada módulo traz um conjunto de funcionalidades específicas, detalhadas a seguir:
appdataGen.py
- Gerencia arquivos e diretórios no AppData LocalLow, permitindo a criação personalizada de estruturas de diretórios e arquivos de configuração.
createExeOnC.py
- Facilita a criação de cópias da aplicação no disco local C, útil para a distribuição de software ou instalação local rápida.
exeGenerator.py
- Utiliza o PyInstaller para converter scripts Python em executáveis autônomos, simplificando a distribuição de aplicações.
regedit.py
- Permite a criação e gerenciamento de entradas de registro do Windows, facilitando a integração com o sistema operacional.
Instalação do Pacote dmtoolbox
Para instalar o pacote dmtoolbox-win de maneira eficiente e segura, siga os passos abaixo. Recomendamos a utilização de um ambiente virtual Python para evitar conflitos de dependências com outros pacotes instalados no sistema.
Pré-Requisitos
- Certifique-se de que o Python está instalado em seu sistema. O dmtoolbox é compatível com Python 3.6 ou superior.
- É recomendável ter o pip, o gerenciador de pacotes do Python, atualizado. Para atualizar o pip, execute o seguinte comando no terminal:
python -m pip install --upgrade pip
Passo 1: Criação de um Ambiente Virtual (Opcional, mas Recomendado)
- Abra um terminal.
- Navegue até o diretório onde deseja armazenar o ambiente virtual e seu projeto.
- Execute o comando para criar um ambiente virtual. Substitua
meuenv
pelo nome que deseja dar ao seu ambiente virtual:
python -m venv meuenv
-
Ative o ambiente virtual:
- No Windows:
.\meuenv\Scripts\activate
- No Unix ou MacOS:
source meuenv/bin/activate
Passo 2: Instalação do Pacote dmtoolbox
Com o ambiente virtual ativado, instale o pacote dmtoolbox-win
utilizando o pip:
pip install dmtoolbox-win
Solução Alternativa: Instalação Manual das Dependências e Clonagem do Repositório
Caso encontre problemas ao instalar o pacote via pip, você pode optar por instalar manualmente as dependências e clonar o repositório do projeto. Primeiro, instale as dependências listadas no arquivo requirements.txt
:
pip install -r win-requirements.txt
Certifique-se de que o dmtoolbox
esteja instalado ou será instalado automaticamente como dependência.
Uso
Para usar dmtoolbox-win
, simplesmente importe o pacote ou módulos específicos em seu projeto Python. Veja a documentação para exemplos detalhados de uso e funcionalidades.
dmtoolbox-win
é a ferramenta ideal para desenvolvedores Python que trabalham em ambientes Windows e procuram integrar funcionalidades específicas do Windows em seus projetos com facilidade e eficiência.
Exemplo de Uso
Para criar um arquivo executável de um script Python, você pode utilizar o módulo exeGenerator
. Este módulo permite converter um script Python em um arquivo executável para Windows, especificando o caminho do script, o nome desejado para o executável e o diretório onde o executável será salvo.
from dmtoolbox_win.exeGenerator import create_executable
# Caminho do seu script Python
script_path = "meu_script.py"
# Nome desejado para o executável
exe_name = "MeuApp"
# Diretório onde o executável será salvo
release_dir = "./dist"
create_executable(script_path, exe_name, release_dir)
Este exemplo demonstra como usar o módulo exeGenerator
para converter um script Python em um arquivo executável para Windows.
Contribuindo
Contribuições para dmtoolbox-win
são bem-vindas! Se você tem sugestões de melhorias, correções de bugs ou novas funcionalidades, fique à vontade para abrir uma issue ou enviar um pull request.
Autor
- Nome: Daniel Mello
- Website: Portfólio
- GitHub: github.com/DanielMelloo
Licença
Este projeto é licenciado sob a GNU General Public License v3.0 - veja o arquivo LICENSE para mais detalhes.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for dmtoolbox_win-0.1.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c64ea0c0a698f47c5955cf7f49b566326985a5d02d77f77894d5c1c73af01ad0 |
|
MD5 | 57536c5a3b9052ac1968f96133f1312c |
|
BLAKE2b-256 | 641bdc26f87e62f982ab558d603fd6e697aad1cd6aca941cc97bc18c90cf2e63 |