Gerador de projetos com arquitetura hexagonal
Project description
# 🚀 hexgen — Gerador de Projetos com Arquitetura Hexagonal
`hexgen` (ou `hexo-cli`) é uma CLI Python para gerar rapidamente a estrutura base de um projeto com **arquitetura hexagonal**, seguindo boas práticas de organização de pastas e compatível com projetos `serverless`, `FastAPI`, `gRPC` e muito mais.
---
## 📦 Instalação
### Via PyPI (recomendado):
```bash
pip install hexgen
⚙️ Como usar
Gerar um novo projeto:
hexgen meu_projeto ou .
Estrutura gerada:
meu_projeto/
├── README.md
├── requirements.txt
├── .gitignore
├── serverless.yaml
├── src/
│ ├── main.py
│ ├── application/
│ │ ├── routers/
│ │ └── use_cases/
│ ├── config/
│ │ ├── custom_config.py
│ │ └── dependency_start.py
│ ├── domain/
│ │ ├── entities/
│ │ ├── interfaces/
│ │ └── services/
│ ├── infra/
│ │ ├── repositories/
│ │ ├── clients/
│ │ └── dtos/
├── tests/
│ └── main.py
└── .github/
└── workflows/
└── aws_deploy.yml
Todos os diretórios dentro de src/ recebem automaticamente arquivos __init__.py.
📁 Templates
Os arquivos gerados vêm de templates internos que incluem:
main.pyde entradaserverless.yamljá pronto para AWS Lambdadependency_start.pyecustom_config.pypara configuraçõesaws_deploy.ymlpara CI/CD com GitHub Actions
🧑💻 Desenvolvimento local
Clone este repositório e instale em modo desenvolvimento:
git clone https://github.com/seunome/hexo-cli.git
cd hexo-cli
pip install -e .
Agora você pode rodar:
hexgen nome_do_projeto
📤 Publicar no PyPI (manutenção)
Para empacotar:
python -m build
Para subir:
twine upload dist/*
🔁 Lembre-se de aumentar a versão no
pyproject.tomla cada novo upload.
🤝 Contribuição
Sinta-se à vontade para abrir issues, pull requests ou sugestões de melhoria!
📃 Licença
Este projeto está licenciado sob a licença MIT. 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
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file hexgen-0.1.3.tar.gz.
File metadata
- Download URL: hexgen-0.1.3.tar.gz
- Upload date:
- Size: 10.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
718632632ba8d2ea7aa69ed1e1320c139bcd750c2b4d6a3fc4a290cb39dfbadc
|
|
| MD5 |
f3943b0719dfa6f2ca8906b69ffd4e20
|
|
| BLAKE2b-256 |
0b18b3bfbcec2290f70d1172d7781e64f27c031bc14a38e24ae675cedb7aeaf9
|
File details
Details for the file hexgen-0.1.3-py3-none-any.whl.
File metadata
- Download URL: hexgen-0.1.3-py3-none-any.whl
- Upload date:
- Size: 11.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9428e10bc85f52a970b83cdab5713ecfa2f2b341ab0a9fffb9bee6029d3b640f
|
|
| MD5 |
33f668bda0be703a1d54d47b41a6e457
|
|
| BLAKE2b-256 |
5c7728ad2a96e4ffd3effe1ce4da510c00f0d8e149def0ffd2b94173832b25c2
|