Metadata-Version: 2.4
Name: fastapi_kick
Version: 0.1.1
Summary: FastAPI app scaffolder with health, modules, and Postgres
Home-page: https://example.com/fastapi_kick
Author: Your Name
Author-email: you@example.com
Description-Content-Type: text/markdown
Requires-Dist: fastapi
Requires-Dist: uvicorn
Requires-Dist: sqlalchemy
Requires-Dist: python-dotenv
Requires-Dist: asyncpg
Requires-Dist: psycopg2-binary
Dynamic: author
Dynamic: author-email
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-dist
Dynamic: summary

# fastapi_kick

A simple FastAPI project scaffolder. After installation, run `fastapi_kick start <project_name>` to generate a ready-to-run FastAPI app with:

- `main.py` including CORS and router inclusion
- Versioned API with `/health` endpoint
- `modules/example` with basic router, schema, service, and model stub
- Postgres configuration with sync and async SQLAlchemy sessions loaded from `.env`

## Install

```
pip install fastapi_kick
```

On macOS with externally managed Python:

```
python3 -m pip install fastapi_kick --user --break-system-packages
export PATH="$(python3 -m site --user-base)/bin:$PATH"
```

## Usage

```
fastapi_kick start my_project
cd my_project
uvicorn main:app --reload
```

Create `.env` in the project root:

```
DATABASE_URL_SYNC=postgresql://user:password@localhost:5432/db
DATABASE_URL_ASYNC=postgresql+asyncpg://user:password@localhost:5432/db
```

## Development

```
pip install -r requirements.txt
python3 -m pip install -e .
fastapi_kick start dev_project
```
