Metadata-Version: 2.4
Name: qstack-cli
Version: 0.2.0
Summary: CLI tool for the QStack framework (qstack).
Author: Jonah
License-Expression: MIT
License-File: LICENSE
Keywords: cli,codegen,fastapi,qstack,scaffold
Classifier: Environment :: Console
Classifier: Framework :: FastAPI
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Requires-Dist: jinja2>=3.1
Requires-Dist: questionary>=2.0
Requires-Dist: rich>=13.0
Requires-Dist: typer[all]>=0.9.0
Description-Content-Type: text/markdown

# qstack-cli

Command-line tool for the **QStack** framework — scaffolds, generates, and manages FastAPI projects built on [qstack](https://github.com/yourname/qstack).

## Install

```bash
pip install qstack-cli
```

Dev install:

```bash
git clone https://github.com/yourname/qstack-cli.git
cd qstack-cli
pip install -e .
```

## Commands

| Command | Purpose |
|---------|---------|
| `qstack new <name>` | Interactive project scaffold |
| `qstack generate <type> <name>` | Generate model / schema / repository / service / router / crud |
| `qstack db migrate <msg>` | Alembic `revision --autogenerate` |
| `qstack db upgrade [rev]` | Run migrations |
| `qstack db downgrade [rev]` | Roll back |
| `qstack db seed` | Run `app/seeds.py` |
| `qstack dev` | Start Docker services + uvicorn with reload |
| `qstack test [path]` | Run pytest (optional coverage) |
| `qstack doctor` | Health-check the current project |
| `qstack info` | Show project config and features |

## Quick Start

```bash
qstack new my-api
cd my-api
cp .env.example .env
docker compose up -d
# visit http://localhost:8000/docs
```

## Generate CRUD

```bash
qstack generate crud Task
```

Creates `app/models/task.py`, `app/schemas/task.py`, `app/repositories/task.py`, `app/services/task.py`, `app/routers/task.py` — all wired to `qstack` base classes.

## License

MIT
