Skip to main content

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.py de entrada
  • serverless.yaml já pronto para AWS Lambda
  • dependency_start.py e custom_config.py para configurações
  • aws_deploy.yml para 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.toml a 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


Download files

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

Source Distribution

hexgen-0.1.3.tar.gz (10.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

hexgen-0.1.3-py3-none-any.whl (11.0 kB view details)

Uploaded Python 3

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

Hashes for hexgen-0.1.3.tar.gz
Algorithm Hash digest
SHA256 718632632ba8d2ea7aa69ed1e1320c139bcd750c2b4d6a3fc4a290cb39dfbadc
MD5 f3943b0719dfa6f2ca8906b69ffd4e20
BLAKE2b-256 0b18b3bfbcec2290f70d1172d7781e64f27c031bc14a38e24ae675cedb7aeaf9

See more details on using hashes here.

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

Hashes for hexgen-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 9428e10bc85f52a970b83cdab5713ecfa2f2b341ab0a9fffb9bee6029d3b640f
MD5 33f668bda0be703a1d54d47b41a6e457
BLAKE2b-256 5c7728ad2a96e4ffd3effe1ce4da510c00f0d8e149def0ffd2b94173832b25c2

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