# dmtoolbox-win
- [dmtoolbox-win](#dmtoolbox-win)
- [Descrição](#descrição)
- [Funcionalidades](#funcionalidades)
- [Funcionalidades dos Módulos](#funcionalidades-dos-módulos)
- [appdataGen.py](#appdatagenpy)
- [createExeOnC.py](#createexeoncpy)
- [exeGenerator.py](#exegeneratorpy)
- [regedit.py](#regeditpy)
- [Instalação do Pacote dmtoolbox](#instalação-do-pacote-dmtoolbox)
- [Pré-Requisitos](#pré-requisitos)
- [Passo 1: Criação de um Ambiente Virtual (Opcional, mas Recomendado)](#passo-1-criação-de-um-ambiente-virtual-opcional-mas-recomendado)
- [Passo 2: Instalação do Pacote dmtoolbox](#passo-2-instalação-do-pacote-dmtoolbox)
- [Solução Alternativa: Instalação Manual das Dependências e Clonagem do Repositório](#solução-alternativa-instalação-manual-das-dependências-e-clonagem-do-repositório)
- [Uso](#uso)
- [Exemplo de Uso](#exemplo-de-uso)
- [Contribuindo](#contribuindo)
- [Autor](#autor)
- [Licença](#licença)
## 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](https://github.com/DanielMelloo/dmtoolbox-win/blob/main/dmtoolbox-win/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](https://github.com/DanielMelloo/dmtoolbox-win/blob/main/dmtoolbox-win/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](https://github.com/DanielMelloo/dmtoolbox-win/blob/main/dmtoolbox-win/exeGenerator.py)
- Utiliza o PyInstaller para converter scripts Python em executáveis autônomos, simplificando a distribuição de aplicações.
### [regedit.py](https://github.com/DanielMelloo/dmtoolbox/blob/main/dmtoolbox-win/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:
```bash
python -m pip install --upgrade pip
```
### Passo 1: Criação de um Ambiente Virtual (Opcional, mas Recomendado)
1. Abra um terminal.
2. Navegue até o diretório onde deseja armazenar o ambiente virtual e seu projeto.
3. Execute o comando para criar um ambiente virtual. Substitua `meuenv` pelo nome que deseja dar ao seu ambiente virtual:
python -m venv meuenv
4. Ative o ambiente virtual:
- No Windows:
```powershell
.\meuenv\Scripts\activate
```
- No Unix ou MacOS:
```bash
source meuenv/bin/activate
```
### Passo 2: Instalação do Pacote dmtoolbox
Com o ambiente virtual ativado, instale o pacote `dmtoolbox-win` utilizando o pip:
```bash
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`:
```bash
pip install -r win-requirements.txt
```
Certifique-se de que o [`dmtoolbox`](https://github.com/DanielMelloo/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.
```python
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](https://www.danielmello.tech)
- GitHub: [github.com/DanielMelloo](https://github.com/DanielMelloo)
## Licença
Este projeto é licenciado sob a GNU General Public License v3.0 - veja o arquivo [LICENSE](LICENSE) para mais detalhes.
[⬆ Voltar ao topo](#dmtoolbox-win)**
Raw data
{
"_id": null,
"home_page": "https://github.com/DanielMelloo/dmtoolbox-win",
"name": "dmtoolbox-win",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "utils automation numpy pandas matplotlib",
"author": "Daniel Mello",
"author_email": "danielmello.dev@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/de/aa/2dcbd20006777d79dcb07006b62d2ea2afe1b9b0070c139f02b8ff1892ec/dmtoolbox-win-0.1.1.tar.gz",
"platform": null,
"description": "\r\n\r\n\r\n\r\n \r\n\r\n\r\n# dmtoolbox-win\r\n\r\n\r\n- [dmtoolbox-win](#dmtoolbox-win)\r\n - [Descri\u00e7\u00e3o](#descri\u00e7\u00e3o)\r\n - [Funcionalidades](#funcionalidades)\r\n - [Funcionalidades dos M\u00f3dulos](#funcionalidades-dos-m\u00f3dulos)\r\n - [appdataGen.py](#appdatagenpy)\r\n - [createExeOnC.py](#createexeoncpy)\r\n - [exeGenerator.py](#exegeneratorpy)\r\n - [regedit.py](#regeditpy)\r\n - [Instala\u00e7\u00e3o do Pacote dmtoolbox](#instala\u00e7\u00e3o-do-pacote-dmtoolbox)\r\n - [Pr\u00e9-Requisitos](#pr\u00e9-requisitos)\r\n - [Passo 1: Cria\u00e7\u00e3o de um Ambiente Virtual (Opcional, mas Recomendado)](#passo-1-cria\u00e7\u00e3o-de-um-ambiente-virtual-opcional-mas-recomendado)\r\n - [Passo 2: Instala\u00e7\u00e3o do Pacote dmtoolbox](#passo-2-instala\u00e7\u00e3o-do-pacote-dmtoolbox)\r\n - [Solu\u00e7\u00e3o Alternativa: Instala\u00e7\u00e3o Manual das Depend\u00eancias e Clonagem do Reposit\u00f3rio](#solu\u00e7\u00e3o-alternativa-instala\u00e7\u00e3o-manual-das-depend\u00eancias-e-clonagem-do-reposit\u00f3rio)\r\n - [Uso](#uso)\r\n - [Exemplo de Uso](#exemplo-de-uso)\r\n - [Contribuindo](#contribuindo)\r\n - [Autor](#autor)\r\n - [Licen\u00e7a](#licen\u00e7a)\r\n\r\n\r\n## Descri\u00e7\u00e3o\r\n\r\n`dmtoolbox-win` \u00e9 uma extens\u00e3o do `dmtoolbox`, projetada especificamente para integrar funcionalidades espec\u00edficas do ambiente Windows em seus projetos Python. Este pacote complementar oferece ferramentas poderosas para manipula\u00e7\u00e3o de registros do Windows, cria\u00e7\u00e3o de execut\u00e1veis, gerenciamento avan\u00e7ado de arquivos e diret\u00f3rios, e muito mais.\r\n\r\n## Funcionalidades\r\n\r\n- **appdataGen**: Facilita a cria\u00e7\u00e3o, manipula\u00e7\u00e3o e organiza\u00e7\u00e3o de arquivos e pastas dentro do diret\u00f3rio AppData do Windows, permitindo o armazenamento de dados de aplicativos de forma estruturada e acess\u00edvel.\r\n\r\n- **createExeOnC**: Auxilia na cria\u00e7\u00e3o de c\u00f3pias execut\u00e1veis da sua aplica\u00e7\u00e3o diretamente no disco local C, simplificando o processo de instala\u00e7\u00e3o e distribui\u00e7\u00e3o de software.\r\n\r\n- **exeGenerator**: Utiliza o PyInstaller para converter scripts Python em execut\u00e1veis aut\u00f4nomos para Windows, facilitando a distribui\u00e7\u00e3o de aplica\u00e7\u00f5es sem necessidade de instala\u00e7\u00e3o do Python.\r\n\r\n- **regedit**: Fornece uma interface program\u00e1tica para a cria\u00e7\u00e3o, leitura, edi\u00e7\u00e3o e exclus\u00e3o de registros do Windows, permitindo a modifica\u00e7\u00e3o de configura\u00e7\u00f5es do sistema e de aplicativos de maneira automatizada.\r\n\r\n\r\n\r\n## Funcionalidades dos M\u00f3dulos\r\nCada m\u00f3dulo traz um conjunto de funcionalidades espec\u00edficas, detalhadas a seguir:\r\n\r\n### [appdataGen.py](https://github.com/DanielMelloo/dmtoolbox-win/blob/main/dmtoolbox-win/appdataGen.py)\r\n- Gerencia arquivos e diret\u00f3rios no AppData LocalLow, permitindo a cria\u00e7\u00e3o personalizada de estruturas de diret\u00f3rios e arquivos de configura\u00e7\u00e3o.\r\n\r\n### [createExeOnC.py](https://github.com/DanielMelloo/dmtoolbox-win/blob/main/dmtoolbox-win/createExeOnC.py)\r\n\r\n- Facilita a cria\u00e7\u00e3o de c\u00f3pias da aplica\u00e7\u00e3o no disco local C, \u00fatil para a distribui\u00e7\u00e3o de software ou instala\u00e7\u00e3o local r\u00e1pida.\r\n\r\n### [exeGenerator.py](https://github.com/DanielMelloo/dmtoolbox-win/blob/main/dmtoolbox-win/exeGenerator.py)\r\n- Utiliza o PyInstaller para converter scripts Python em execut\u00e1veis aut\u00f4nomos, simplificando a distribui\u00e7\u00e3o de aplica\u00e7\u00f5es.\r\n \r\n\r\n### [regedit.py](https://github.com/DanielMelloo/dmtoolbox/blob/main/dmtoolbox-win/regedit.py)\r\n- Permite a cria\u00e7\u00e3o e gerenciamento de entradas de registro do Windows, facilitando a integra\u00e7\u00e3o com o sistema operacional.\r\n\r\n## Instala\u00e7\u00e3o do Pacote dmtoolbox\r\n\r\nPara instalar o pacote dmtoolbox-win de maneira eficiente e segura, siga os passos abaixo. Recomendamos a utiliza\u00e7\u00e3o de um ambiente virtual Python para evitar conflitos de depend\u00eancias com outros pacotes instalados no sistema.\r\n\r\n### Pr\u00e9-Requisitos\r\n\r\n- Certifique-se de que o Python est\u00e1 instalado em seu sistema. O dmtoolbox \u00e9 compat\u00edvel com Python 3.6 ou superior.\r\n- \u00c9 recomend\u00e1vel ter o pip, o gerenciador de pacotes do Python, atualizado. Para atualizar o pip, execute o seguinte comando no terminal:\r\n```bash\r\npython -m pip install --upgrade pip\r\n```\r\n\r\n\r\n### Passo 1: Cria\u00e7\u00e3o de um Ambiente Virtual (Opcional, mas Recomendado)\r\n\r\n1. Abra um terminal.\r\n2. Navegue at\u00e9 o diret\u00f3rio onde deseja armazenar o ambiente virtual e seu projeto.\r\n3. Execute o comando para criar um ambiente virtual. Substitua `meuenv` pelo nome que deseja dar ao seu ambiente virtual:\r\n\r\npython -m venv meuenv\r\n\r\n4. Ative o ambiente virtual:\r\n\r\n - No Windows:\r\n ```powershell\r\n .\\meuenv\\Scripts\\activate\r\n ```\r\n\r\n - No Unix ou MacOS:\r\n ```bash\r\n source meuenv/bin/activate\r\n ```\r\n\r\n### Passo 2: Instala\u00e7\u00e3o do Pacote dmtoolbox\r\n\r\nCom o ambiente virtual ativado, instale o pacote `dmtoolbox-win` utilizando o pip:\r\n```bash\r\npip install dmtoolbox-win\r\n```\r\n\r\n### Solu\u00e7\u00e3o Alternativa: Instala\u00e7\u00e3o Manual das Depend\u00eancias e Clonagem do Reposit\u00f3rio\r\n\r\nCaso encontre problemas ao instalar o pacote via pip, voc\u00ea pode optar por instalar manualmente as depend\u00eancias e clonar o reposit\u00f3rio do projeto. Primeiro, instale as depend\u00eancias listadas no arquivo `requirements.txt`:\r\n```bash\r\npip install -r win-requirements.txt\r\n```\r\n\r\nCertifique-se de que o [`dmtoolbox`](https://github.com/DanielMelloo/dmtoolbox) esteja instalado ou ser\u00e1 instalado automaticamente como depend\u00eancia.\r\n\r\n## Uso\r\n\r\nPara usar `dmtoolbox-win`, simplesmente importe o pacote ou m\u00f3dulos espec\u00edficos em seu projeto Python. Veja a documenta\u00e7\u00e3o para exemplos detalhados de uso e funcionalidades.\r\n\r\n`dmtoolbox-win` \u00e9 a ferramenta ideal para desenvolvedores Python que trabalham em ambientes Windows e procuram integrar funcionalidades espec\u00edficas do Windows em seus projetos com facilidade e efici\u00eancia.\r\n\r\n\r\n\r\n\r\n## Exemplo de Uso\r\n\r\nPara criar um arquivo execut\u00e1vel de um script Python, voc\u00ea pode utilizar o m\u00f3dulo `exeGenerator`. Este m\u00f3dulo permite converter um script Python em um arquivo execut\u00e1vel para Windows, especificando o caminho do script, o nome desejado para o execut\u00e1vel e o diret\u00f3rio onde o execut\u00e1vel ser\u00e1 salvo.\r\n\r\n```python\r\nfrom dmtoolbox_win.exeGenerator import create_executable\r\n\r\n# Caminho do seu script Python\r\nscript_path = \"meu_script.py\"\r\n\r\n# Nome desejado para o execut\u00e1vel\r\nexe_name = \"MeuApp\"\r\n\r\n# Diret\u00f3rio onde o execut\u00e1vel ser\u00e1 salvo\r\nrelease_dir = \"./dist\"\r\n\r\ncreate_executable(script_path, exe_name, release_dir)\r\n```\r\n\r\nEste exemplo demonstra como usar o m\u00f3dulo `exeGenerator` para converter um script Python em um arquivo execut\u00e1vel para Windows.\r\n\r\n## Contribuindo\r\n\r\nContribui\u00e7\u00f5es para `dmtoolbox-win` s\u00e3o bem-vindas! Se voc\u00ea tem sugest\u00f5es de melhorias, corre\u00e7\u00f5es de bugs ou novas funcionalidades, fique \u00e0 vontade para abrir uma issue ou enviar um pull request.\r\n\r\n## Autor\r\n\r\n- Nome: Daniel Mello\r\n- Website: [Portf\u00f3lio](https://www.danielmello.tech)\r\n- GitHub: [github.com/DanielMelloo](https://github.com/DanielMelloo)\r\n\r\n\r\n## Licen\u00e7a\r\nEste projeto \u00e9 licenciado sob a GNU General Public License v3.0 - veja o arquivo [LICENSE](LICENSE) para mais detalhes.\r\n\r\n\r\n[\u2b06 Voltar ao topo](#dmtoolbox-win)**\r\n",
"bugtrack_url": null,
"license": "GPLv3",
"summary": "Uma extens\u00e3o do dmtoolbox focada em funcionalidades espec\u00edficas do Windows, incluindo manipula\u00e7\u00e3o de registros, cria\u00e7\u00e3o de execut\u00e1veis e gerenciamento de arquivos e configura\u00e7\u00f5es avan\u00e7adas do sistema.",
"version": "0.1.1",
"project_urls": {
"Homepage": "https://github.com/DanielMelloo/dmtoolbox-win"
},
"split_keywords": [
"utils",
"automation",
"numpy",
"pandas",
"matplotlib"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "641bdc26f87e62f982ab558d603fd6e697aad1cd6aca941cc97bc18c90cf2e63",
"md5": "57536c5a3b9052ac1968f96133f1312c",
"sha256": "c64ea0c0a698f47c5955cf7f49b566326985a5d02d77f77894d5c1c73af01ad0"
},
"downloads": -1,
"filename": "dmtoolbox_win-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "57536c5a3b9052ac1968f96133f1312c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 20308,
"upload_time": "2024-03-04T12:48:54",
"upload_time_iso_8601": "2024-03-04T12:48:54.635699Z",
"url": "https://files.pythonhosted.org/packages/64/1b/dc26f87e62f982ab558d603fd6e697aad1cd6aca941cc97bc18c90cf2e63/dmtoolbox_win-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "deaa2dcbd20006777d79dcb07006b62d2ea2afe1b9b0070c139f02b8ff1892ec",
"md5": "91c04811cf52abea846c6d0c6835423d",
"sha256": "225c3a7dcc48175a38cdfe92d7838b1f29cc46c94e1a4d6a7248eb13ac2e8c64"
},
"downloads": -1,
"filename": "dmtoolbox-win-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "91c04811cf52abea846c6d0c6835423d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 19134,
"upload_time": "2024-03-04T12:48:55",
"upload_time_iso_8601": "2024-03-04T12:48:55.884973Z",
"url": "https://files.pythonhosted.org/packages/de/aa/2dcbd20006777d79dcb07006b62d2ea2afe1b9b0070c139f02b8ff1892ec/dmtoolbox-win-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-04 12:48:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "DanielMelloo",
"github_project": "dmtoolbox-win",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "dmtoolbox-win"
}
JSON
