Gentem

A Python CLI template boilerplate generator for quickly scaffolding Python projects.

Features

• Project Scaffolding: Generate Python projects with a single command
• Multiple Project Types: Support for library, CLI tool, and script projects
• FastAPI Templates: Pre-configured FastAPI project templates with optional database support
• Interactive Wizard: gentem init for guided project creation with presets
• Module Addition: gentem add to add Docker, Docs, Testing, Logging, and Database modules to existing projects
• Opinionated Structure: Best practices baked into every template
• Interactive Preview: --dry-run option to preview before creating files

Installation

pip install gentem

Or install from source:

git clone https://github.com/knightlesssword/gentem.git
cd gentem
pip install -e .

Usage

Creating a New Project

# Create a library project
gentem new mylib --type library

# Create a CLI tool project
gentem new mycli --type cli

# Create a simple script project
gentem new myscript --type script

# With author and description
gentem new mylib --type library --author "John Doe" --description "My library"

# With license
gentem new mylib --type library --license mit
gentem new mylib --type library --license apache
gentem new mylib --type library --license gpl
gentem new mylib --type library --license bsd

# Preview without creating files
gentem new mylib --type library --dry-run

Creating a FastAPI Project

# Create a basic FastAPI project
gentem fastapi myapi

# Create with async mode and lifespan
gentem fastapi myapi --async

# Create with PostgreSQL database (asyncpg)
gentem fastapi myapi --db asyncpg

# Create with SQLite database (aiosqlite)
gentem fastapi myapi --db sqlite

# Combine options
gentem fastapi myapi --async --db sqlite --author "John Doe"

Interactive Project Wizard

# Start interactive wizard
gentem init

# Skip prompts with defaults
gentem init --skip-prompts

# Use a preset
gentem init --preset minimal
gentem init --preset cli-tool
gentem init --preset fastapi

# Preview without creating files
gentem init --preset fastapi --dry-run

Adding Modules to Existing Projects

# Add Docker support to current project
gentem add docker

# Add Docker to specific project
gentem add docker -p ./myapi

# Add documentation (MkDocs)
gentem add docs

# Add testing module (pytest fixtures)
gentem add testing

# Add logging configuration
gentem add logging

# Add database migrations (Alembic)
gentem add database

# Add CI/CD workflow (GitHub Actions)
gentem add ci

# Add pre-commit hooks
gentem add precommit

# Add Poetry configuration
gentem add poetry

# Add multiple modules at once
gentem add docker docs testing

# Preview changes without creating files
gentem add docker --dry-run

# Overwrite existing files
gentem add docker --force

# Show verbose output
gentem add docker -v

Project Structure

Library Template

mylib/
├── app/
│   └── __init__.py
├── tests/
│   ├── __init__.py
│   └── test_mylib.py
├── pyproject.toml
├── README.md
├── LICENSE
└── .gitignore

CLI Tool Template

mycli/
├── app/
│   ├── __init__.py
│   ├── cli.py
│   └── main.py
├── pyproject.toml
├── README.md
├── LICENSE
└── .gitignore

FastAPI Template

myapi/
├── app/
│   ├── __init__.py
│   ├── main.py              # FastAPI application
│   ├── core/
│   │   ├── __init__.py
│   │   ├── config.py        # Settings
│   │   ├── exceptions.py    # Custom exceptions
│   │   └── database.py      # Database session (with --db)
│   ├── deps/
│   │   └── __init__.py      # Dependencies
│   ├── utils/
│   │   └── __init__.py      # Utility functions
│   ├── v1/
│   │   ├── __init__.py
│   │   └── apis/
│   │       ├── __init__.py
│   │       └── routes.py    # API routes
│   ├── services/
│   │   └── __init__.py      # Business logic
│   ├── schemas/
│   │   └── __init__.py      # Pydantic schemas
│   └── models/
│       └── __init__.py      # SQLAlchemy models
├── .env
├── requirements.txt
├── .gitignore
└── README.md

Development

# Install development dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Format code
black .
ruff check --fix .

# Type checking
mypy .

Contributing

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

License

This project is licensed under the MIT License - see the LICENSE file for details.