pymodularizer 0.1.9

Gerador de projetos Python modularizados

🛠️ PyModularizer - Gerador de Projetos Python Modularizados

PyModularizer é uma ferramenta de linha de comando para gerar rapidamente estruturas de projetos Python — desde scripts simples até aplicações modulares com FastAPI ou Flask. Ideal para acelerar a criação de pacotes reutilizáveis, APIs e sistemas organizados por módulos.

---

✨ Recursos

• Geração de estruturas de projeto prontas para uso
• Suporte a múltiplos tipos: script simples, pacote, aplicação modular, API com FastAPI ou Flask
• Criação de novos módulos com um único comando
• Estrutura compatível com boas práticas de organização e testes
• CLI interativa via Typer
• Pronto para publicação no PyPI

---

🚀 Instalação

Você pode instalar diretamente via PyPI:

pip install pymodularizer

Ou localmente, após clonar o repositório:

git clone https://github.com/havurquijo/pymodularizer.git
cd pymodularizer
pip install .

---

⚙️ Uso

Criar um novo projeto

pymodularizer new --name my_app --type modular_application

ou

pym new --name my_app --type modular_application

Opções disponíveis:

Opção	Descrição	Padrão
--name	Nome do projeto	meu_projeto
--version	Versão inicial do projeto	0.1.0
--src	Nome da pasta de código fonte	src
--main	Nome do arquivo principal	main.py
--type	Tipo do projeto (custom, simple_script, etc.)	custom

Adicionar um módulo

pym module meu_modulo --path src

Cria um módulo com estrutura básica dentro da pasta especificada (src por padrão).

Listar templates disponíveis

pym list-templates

Mostra todos os tipos de projetos disponíveis que podem ser usados com o comando new.

---

🧱 Templates disponíveis

pym list-templates

Tipo	Descrição
simple_script	Projeto com um único script e módulos auxiliares
python_package	Pacote instalável com módulos organizados
modular_application	Aplicação modular com serviços, módulos e configuração separada
fastapi_api	Estrutura pronta para uma API com FastAPI
flask_api	Estrutura pronta para uma API com Flask
custom	Estrutura personalizada definida pelo usuário

---

🧪 Testes

Testes automatizados usam pytest. Execute com:

pytest

As funções são testadas sem criar arquivos reais no sistema, usando tmp_path.

---

📂 Estrutura esperada

Exemplo de estrutura gerada:

my_app/
├── src/
│   ├── main.py
│   ├── modules/
│   ├── services/
│   └── config/
├── tests/
├── README.md
├── setup.cfg
├── pyproject.toml
└── requirements.txt

Exemplo de estrutura gerada para um projeto Flask:

.
├── app/
│   ├── __init__.py
│   ├── app.py
│   ├── routes/
│   │   ├── __init__.py
│   │   └── api.py
│   ├── services/
│   │   └── service.py
│   ├── models/
│   │   └── model.py
│   ├── utils/
│   │   └── helpers.py
│   ├── templates/
│   │   └── index.html
│   └── static/
│       ├── css/
│       │   └── style.css
│       └── js/
│           └── script.js
├── config/
│   ├── __init__.py
│   └── config.py
├── tests/
│   └── test_main.py
├── run.py
├── requirements.txt
└── .env.example

---

📦 Publicação no PyPI

Se você quiser clonar e adaptar para publicar seu próprio pacote, basta configurar:

• pyproject.toml
• setup.cfg
• README.md

E executar:

python -m build
python -m twine upload dist/*

---

🤝 Contribuindo

Pull requests são bem-vindos! Sinta-se à vontade para sugerir novos tipos de projeto, comandos e melhorias.

---

📝 Licença

Distribuído sob a licença MIT. Veja LICENSE para mais detalhes.