Metadata-Version: 2.4
Name: microforge-cli
Version: 0.1.1
Summary: A production-ready project generator for modern Python microservices
License: MIT
Keywords: microservices,fastapi,celery,cli,generator,scaffold
Author: Klejdi
Author-email: klejdi94@gmail.com
Requires-Python: >=3.9,<4.0
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: jinja2 (>=3.1.0,<4.0.0)
Requires-Dist: pyyaml (>=6.0.1,<7.0.0)
Project-URL: Homepage, https://github.com/klejdi94/microforge-cli
Project-URL: Repository, https://github.com/klejdi94/microforge-cli
Description-Content-Type: text/markdown

# Microforge 🔥

A production-ready project generator for modern Python microservices.

## Quick Start

```bash
# Install
pip install microforge

# Generate a microservice
microforge new myservice

# Run the service
cd myservice
docker-compose up
```

## Features

- **FastAPI** - Modern async web framework
- **Celery** - Distributed task queue
- **Docker** - Containerization with docker-compose
- **Kubernetes** - Helm charts for deployment
- **CI/CD** - Azure DevOps, GitHub Actions, GitLab CI
- **Observability** - OpenTelemetry + Prometheus metrics
- **Database** - PostgreSQL support (optional)
- **Authentication** - OAuth2 support (optional)

## Usage

### Basic Project
```bash
microforge new myservice
```

### With Options
```bash
microforge new myservice --db postgres --broker redis --ci github --auth oauth2 --git
```

### Available Options
- `--db` - Database: `postgres`
- `--broker` - Message broker: `redis`, `kafka`
- `--ci` - CI/CD: `azure`, `github`, `gitlab`
- `--auth` - Authentication: `oauth2`
- `--git` - Initialize Git repository

## Generated Project Structure

```
myservice/
├── app/                    # FastAPI application
│   ├── main.py            # Main application
│   ├── routes/            # API routes
│   ├── core/              # Core functionality
│   ├── db/                # Database (if --db postgres)
│   └── auth/              # Authentication (if --auth oauth2)
├── worker/                # Celery worker
├── tests/                 # Test suite
├── helm/                  # Kubernetes deployment
├── Dockerfile             # Container image
├── docker-compose.yml     # Local development
└── pyproject.toml         # Dependencies
```

## Development

```bash
# Clone repository
git clone https://github.com/klejdi94/microforge-cli.git
cd microforge-cli

# Install dependencies
pip install -e .

# Run tests
python -m pytest

# Build package
python -m build
```

## License

MIT License - see LICENSE file for details.

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

---

**Start forging microservices today!** 🔥
