smartapi-cli 0.1.2

Opinionated FastAPI CLI for scalable Python APIs

🚀 SmartAPI

SmartAPI é um CLI opinativo para criação de APIs modernas e escaláveis com FastAPI.
Ele gera uma API completa do zero, já arquitetada, padronizada e pronta para produção.

---

✨ O que o SmartAPI entrega

• FastAPI + Uvicorn
• Celery + Redis
• PostgreSQL
• SQLAlchemy + Alembic
• Configuração de ambientes (.env)
• Docker + Docker Compose
• Padrão de módulos, controllers, services e jobs
• CLI para geração de código e automação de tarefas

---

📦 Instalação

pip install smartapi

---

⚡ Criando um projeto

Inicializando um projeto na pasta atual:

smartapi init

docker compose up --build -d

A API ficará disponível em:

http://localhost:8000

---

📚 Documentação automática

FastAPI gera documentação automaticamente:

• Swagger UI
  http://localhost:8000/docs

• ReDoc
  http://localhost:8000/redoc

---

🧱 Estrutura do projeto

app/
├── core/                Configurações centrais (app, db, celery, env)
├── modules/             Módulos da aplicação
│   └── example/
│       ├── controller/
│       ├── service/
│       ├── model/
│       ├── schemas/
│       └── router.py
├── jobs/                Jobs Celery
└── main.py              Entry point FastAPI

alembic/                 Migrations
docker/                  Dockerfiles
docker-compose.yml
requirements.txt
.env.example

---

🧩 Comandos disponíveis

smartapi make:module <Module>
smartapi make:controller <Module>
smartapi make:service <Module>
smartapi make:model <Module>
smartapi make:schema <Module>
smartapi make:router <Module>
smartapi make:crud
smartapi make:job
smartapi make:migration

Banco de dados

smartapi db:migrate
smartapi db:rollback

Executar a aplicação

smartapi app run

---

🧠 Filosofia

• Convenção > configuração
• Código previsível
• Arquitetura modular
• Infra pronta desde o dia 0
• Menos boilerplate, mais produto

---

📄 Licença

MIT

Criado com ❤️ por Arthur Rezende