pyblueforge 1.0.0

A professional Python project scaffolder with rich customization.

PyBlueForge

PyBlueForge is a professional Python project scaffolder focused on fast project bootstrapping, consistent architecture, and polished terminal UX.

It provides a guided wizard (pyblueforge new) and non-interactive flags for automation. The generated projects are ready for package publication workflows and include modern defaults for testing and project layout.

Highlights

• Interactive wizard by default: run only pyblueforge new
• Structured templates: package, cli, and api
• Runtime and development dependencies at generation time
• Modern Python packaging with pyproject.toml + src/ layout
• Rich terminal interface using typer and rich
• Proprietary license policy support by default

Installation

pip install pyblueforge

For local development of PyBlueForge:

python -m pip install -e .[dev]

Quick Start

Interactive mode (default)

pyblueforge new

This opens an interactive wizard and asks for:

• project name
• template type
• destination folder
• Python requirement
• metadata (author/email/description)
• runtime dependencies
• dev dependencies
• git initialization

Non-interactive mode

pyblueforge new my_service --template api --add sqlalchemy --add httpx --dev-add pytest-cov --git

Command Reference

pyblueforge --help
pyblueforge --version
pyblueforge templates
pyblueforge new --help

Template Overview

• package: reusable Python package skeleton
• cli: Typer-based command-line application skeleton
• api: FastAPI application skeleton with /health endpoint

Generated Project Capabilities

Every generated project includes:

• pyproject.toml with Hatchling build backend
• src/<package_name>/ package layout
• tests/ starter tests
• README.md, .gitignore, and LICENSE

Publishing a Generated Project to PyPI

Inside the generated project directory:

python -m pip install build twine
python -m build
twine check dist/*

Documentation

• Documentation Index
• Getting Started
• CLI Reference
• Template System
• Architecture
• PyPI Release Guide
• Release Checklist
• License Policy
• Contributing
• Changelog

License

PyBlueForge is distributed under a proprietary license. See LICENSE for terms.