projex

A powerful CLI tool to generate production-ready Python project boilerplates instantly. Skip the boring setup and jump straight into coding!

✨ Features

• 🚀 Quick Setup - Generate complete project structures in seconds
• 🎯 8 Framework Templates - FastAPI, Django, Flask, Bottle, Pyramid, Tornado, Sanic, CherryPy
• 📦 Batteries Included - Pre-configured with best practices
• 🐳 Docker Ready - Includes Dockerfile and docker-compose
• ✅ Testing Setup - pytest configuration out of the box
• 🔧 Smart Scaffolding - Add models, endpoints, services, middleware with one command
• 🔐 4 Authentication Methods - JWT, OAuth2, API Key, Basic Auth
• 🗄️ 5 Database Options - PostgreSQL, MySQL, MongoDB, SQLite, Redis
• 🎨 3 Template Styles - Minimal, Standard, Full
• 🎭 Beautiful CLI - Rich terminal output with progress indicators
• 🔄 CI/CD Ready - GitHub Actions, GitLab CI, CircleCI configs
• 📚 Documentation Tools - MkDocs and Sphinx setup
• 🧪 Enhanced Testing - Advanced pytest configs, fixtures, factories
• 🔍 Project Validation - Validate structure and dependencies
• 📊 Dependency Management - Check outdated packages, security audits
• 🌍 Environment Management - Multiple environment configurations
• 📝 Makefile Generator - Common development tasks automated
• ⚖️ License Selection - MIT, Apache, GPL, BSD, Unlicense
• 🙈 Smart .gitignore - Custom gitignore templates via gitignore.io

📋 Framework Templates

FastAPI ⚡

Modern, fast API framework with automatic documentation

Features:

• ✅ Async/await support
• ✅ Automatic API docs (Swagger UI)
• ✅ Pydantic models for validation
• ✅ SQLAlchemy ORM integration
• ✅ Alembic migrations
• ✅ JWT authentication ready
• ✅ Docker support

Perfect for: RESTful APIs, WebSocket apps, high-performance services

projex create my-api --template fastapi

---

Django 🎯

Batteries-included web framework for perfectionists

Features:

• ✅ Django REST Framework
• ✅ Admin panel out of the box
• ✅ ORM with migrations
• ✅ Custom user model ready
• ✅ CORS headers configured
• ✅ Environment variables
• ✅ pytest-django setup

Perfect for: Web applications, admin dashboards, CMS platforms

projex create my-site --template django

---

Flask 🌶️

Lightweight and flexible web framework

Features:

• ✅ Flask-RESTful
• ✅ Flask-SQLAlchemy
• ✅ Flask-Migrate
• ✅ JWT authentication
• ✅ CORS support
• ✅ Blueprints structure
• ✅ Config management

Perfect for: Simple APIs, prototypes, custom architectures

projex create my-app --template flask

---

Bottle 🍾

Micro web framework - simple and fast

Features:

• ✅ Single file framework
• ✅ No dependencies (except standard library)
• ✅ Built-in template engine
• ✅ Simple routing
• ✅ Fast and lightweight
• ✅ WSGI compliant
• ✅ Easy to learn

Perfect for: Small APIs, microservices, learning projects

projex create my-service --template bottle

---

Pyramid 🔺

Flexible, scalable web framework

Features:

• ✅ URL generation
• ✅ Flexible authentication/authorization
• ✅ Extensible configuration
• ✅ SQLAlchemy integration
• ✅ Traversal and URL dispatch
• ✅ Built-in internationalization
• ✅ Highly modular

Perfect for: Large applications, complex routing, enterprise apps

projex create my-app --template pyramid

---

Tornado 🌪️

Async web framework and networking library

Features:

• ✅ Non-blocking network I/O
• ✅ WebSocket support
• ✅ High performance
• ✅ Asynchronous handlers
• ✅ Built-in authentication
• ✅ Template engine
• ✅ Long polling support

Perfect for: Real-time apps, WebSocket servers, long-polling services

projex create my-realtime --template tornado

---

Sanic 🚀

Fast async framework built on uvloop

Features:

• ✅ Blazing fast performance
• ✅ Async/await syntax
• ✅ Simple routing
• ✅ Class-based views
• ✅ Blueprint support
• ✅ Middleware support
• ✅ WebSocket support

Perfect for: High-performance APIs, async services, real-time apps

projex create my-fast-api --template sanic

---

CherryPy 🍒

Minimalist Python web framework

Features:

• ✅ HTTP/1.1-compliant WSGI server
• ✅ Simple object-oriented approach
• ✅ Built-in tools (sessions, auth, caching)
• ✅ Thread-pooled web server
• ✅ Plugin system
• ✅ Configuration system
• ✅ Mature and stable

Perfect for: Embedded applications, traditional web apps, simple services

projex create my-server --template cherrypy

---

All templates include:

• ✅ Docker and docker-compose setup
• ✅ Database integration ready
• ✅ Testing setup with pytest
• ✅ Environment configuration (.env)
• ✅ CORS support configured
• ✅ Best practices structure
• ✅ README with documentation
• ✅ .gitignore configured

🚀 Installation

From PyPI (recommended)

pip install projex

From Source

git clone https://github.com/ChAbdulWahhab/projex.git
cd projex
pip install -e .

💻 Quick Usage

Interactive Mode (Easiest!)

projex create

The CLI will guide you through:

• Project name
• Framework selection
• Database choice
• Authentication method
• Template style
• Additional options

Command Line Mode

# Simple FastAPI project
projex create my-api --template fastapi

# Complete production-ready setup
projex create my-api \
  --template fastapi \
  --db postgresql \
  --auth jwt \
  --style full \
  --license mit

# Django with MongoDB
projex create my-site \
  --template django \
  --db mongodb \
  --author "Your Name"

# Minimal Flask app
projex create my-app \
  --template flask \
  --style minimal \
  --no-git

All Create Options

projex create [PROJECT_NAME] [OPTIONS]

Options:
  -t, --template TEXT       Framework template
                            [fastapi|django|flask|bottle|pyramid|tornado|sanic|cherrypy]
  -p, --path PATH          Directory path (default: current directory)
  -a, --author TEXT        Author name
  -d, --description TEXT   Project description
  --db TEXT                Database type
                           [postgresql|mysql|mongodb|sqlite|redis]
  --style TEXT             Template style
                           [minimal|standard|full]
  --auth TEXT              Authentication method
                           [jwt|oauth2|apikey|basic]
  --license TEXT           License type
                           [mit|apache|gpl|bsd|unlicense]
  --gitignore TEXT         Gitignore templates (comma-separated)
                           Example: python,venv,pycharm,vscode
  --no-git                 Skip git initialization
  --no-venv                Skip virtual environment creation
  --help                   Show help message

List Available Templates

projex list

# Output shows all 8 frameworks with descriptions

🛠️ Smart Scaffolding

Add components to your existing project:

Add Models

# Simple model
projex add model User --fields name:str,email:str,age:int

# Complex model with multiple field types
projex add model Product --fields name:str,price:float,stock:int,is_active:bool,created_at:datetime

# Supported field types:
# str, int, float, bool, date, datetime, list, dict

Add Endpoints

# CRUD endpoints
projex add endpoint users --crud

# Generates: GET, POST, PUT, DELETE endpoints

Add Services

# Synchronous service
projex add service payment

# Asynchronous service
projex add service email --async

Add Middleware

# CORS middleware
projex add middleware cors

# Authentication middleware
projex add middleware auth

Note: All projex add commands automatically detect your framework and generate appropriate code!

🔐 Authentication Options

JWT (JSON Web Tokens)

projex create my-api --template fastapi --auth jwt

Includes:

• Login/register endpoints
• Password hashing with bcrypt
• Token generation and validation
• Protected route examples
• Refresh token support (optional)

OAuth2 (Social Login)

projex create my-api --template fastapi --auth oauth2

Includes:

• Google OAuth2 integration
• GitHub OAuth2 integration
• User profile endpoints
• Token management
• Environment variable configuration

API Key

projex create my-api --template fastapi --auth apikey

Includes:

• API key generation
• Header-based authentication
• Key rotation support
• Rate limiting ready

Basic Authentication

projex create my-api --template flask --auth basic

Includes:

• Username/password authentication
• Base64 encoding
• Simple and straightforward
• Good for internal APIs

🗄️ Database Options

PostgreSQL (Recommended for production)

projex create my-api --template fastapi --db postgresql

Includes:

• SQLAlchemy ORM configuration
• Alembic migrations
• Connection pooling
• docker-compose with PostgreSQL service
• Environment variables for connection

MySQL/MariaDB

projex create my-api --template django --db mysql

Includes:

• MySQL-specific SQLAlchemy config
• Docker setup with MySQL
• Character set configuration

MongoDB

projex create my-api --template fastapi --db mongodb

Includes:

• Motor (async) for FastAPI
• PyMongo for sync frameworks
• Document models
• Connection string configuration
• docker-compose with MongoDB

SQLite (Good for development)

projex create my-api --template flask --db sqlite

Includes:

• Zero configuration needed
• File-based database
• Perfect for development/testing
• Easy to version control (optional)

Redis

projex create my-api --template fastapi --db redis

Includes:

• redis-py configuration
• Caching examples
• Session storage setup
• docker-compose with Redis

🎨 Template Styles

Minimal (Bare Bones)

projex create my-api --template fastapi --style minimal

Includes:

• Basic project structure
• Essential files only
• No Docker
• Simple configuration
• Perfect for learning

Standard (Default, Recommended)

projex create my-api --template fastapi --style standard
# or
projex create my-api --template fastapi

Includes:

• Complete project structure
• Docker and docker-compose
• Testing setup
• Environment configuration
• Production-ready

Full (Everything Included)

projex create my-api --template fastapi --style full

Includes:

• Everything from Standard
• CI/CD configuration
• Documentation setup
• Enhanced testing
• Code quality tools
• Makefile
• Multiple environments
• Maximum batteries included!

🔄 CI/CD Pipeline Generation

Generate CI/CD configurations:

GitHub Actions

cd my-project
projex add cicd --provider github

Generates: .github/workflows/ci.yml

Includes:

• Test job (pytest)
• Lint job (black, flake8)
• Build job (Docker)
• Deploy job (commented, ready to customize)

GitLab CI

projex add cicd --provider gitlab

Generates: .gitlab-ci.yml

Includes:

• Test stage
• Build stage
• Deploy stage
• Docker image building

CircleCI

projex add cicd --provider circle

Generates: .circleci/config.yml

Includes:

• Workflows
• Jobs (test, build, deploy)
• Orbs integration

🌍 Environment Management

Manage multiple environments:

cd my-project

# Create environment files
projex env add development
projex env add staging
projex env add production
projex env add test

# List all environments
projex