Metadata-Version: 2.4
Name: fast-scaffold
Version: 0.2.0
Summary: CLI para gerar scaffolding de projetos FastAPI
License-Expression: MIT
License-File: LICENSE
Keywords: fastapi,cli,scaffold,scaffolding,code-generator,typer,backend,api
Author: Ramon Willer
Author-email: willer.ramon@gmail.com
Requires-Python: >=3.10
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Framework :: FastAPI
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: mako (>=1.3.10,<1.4.0)
Requires-Dist: typer (>=0.21.1,<0.22.0)
Project-URL: Documentation, https://github.com/ramonwiller/fast-scaffold
Project-URL: Homepage, https://github.com/ramonwiller/fast-scaffold
Project-URL: Issues, https://github.com/ramonwiller/fast-scaffold/issues
Project-URL: Repository, https://github.com/ramonwiller/fast-scaffold
Description-Content-Type: text/markdown

# fast-scaffold 🚀

CLI to generate **FastAPI project scaffolding** in a fast, standardized, and extensible way.

`fast-scaffold` creates the initial structure of a FastAPI project using Mako templates, allowing for easy evolution into multiple types of scaffolds in the future.

---

## ✨ Features

- 📦 Simple and fast CLI
- ⚡ Generate FastAPI projects in seconds
- 🧱 Template-based structure (Mako)
- 🧩 Easy to extend for new scaffolds
- 🐍 Compatible with Python 3.10+

---

## 📦 Installation

### Using pipx (recommended for CLIs)

```bash
pipx install fast-scaffold
```

Or using pip:

```bash
pip install fast-scaffold
```

## 🚀 Quick Start

Create a new FastAPI project:

```bash
fast-scaffold project init my-api
```

This will generate the project structure in the current directory:

```text
my-api/
├── pyproject.toml
├── README.md
└── app/
    └── main.py
```

## 🧠 How it works

fast-scaffold utilizes Mako templates located within the package:

```text
fast_scaffold/
└── templates/
    └── project/
        ├── pyproject.toml.mako
        ├── README.md.mako
        └── app/
            └── main.py.mako
```

## 🛠️ Local Development

Clone the repository and install the dependencies:

```bash
poetry install
```

Run the CLI locally:

```bash
poetry run fast-scaffold project init my-api
```

## 📄 Requirements

* Python >= 3.10
* Poetry (for development)
* pipx (recommended for global use)


## 🤝 Contributing

Contributions are welcome! Feel free to open issues or submit pull requests.

##📜 License

MIT License

