pyforge-scaffold 0.0.3

A lightweight CLI tool for generating modern Python project structures with best practices built in

pyforge

pyforge is a CLI tool that scaffolds modern Python projects with sensible defaults for packaging, linting, testing, typing, and CI.

What It Generates

• Interactive project setup with input validation
• src/-layout package structure
• PEP 621-compliant pyproject.toml
• Optional dynamic versioning helper in scripts/setup.py
• Optional GitHub Actions workflow
• Ready-to-use quality tooling configuration

Installation

Install from source (development)

python -m pip install -e .

Install for CLI usage

Linux/macOS:

python3 -m pip install --user pyforge-scaffold

Windows:

py -m pip install --user pyforge-scaffold

With pipx:

pipx install pyforge-scaffold

Usage

Run:

pyforge

Follow the prompts, review the summary, and confirm project generation.

The generated project can optionally include a local virtual environment and install:

• -e .[dev] when recommended packages are enabled
• -e . otherwise

Development

python -m pip install -e .[dev]
pre-commit install

Build Distributions

python -m pip install --upgrade pip setuptools wheel build
python3 scripts/setup.py sdist bdist_wheel

Build artifacts are written to dist/.

Validate Distributions

python -m twine check dist/*

Publish to PyPI

1. Create a PyPI API token.
2. Export credentials:

export TWINE_USERNAME=__token__
export TWINE_PASSWORD=pypi-XXXXXXXXXXXXXXXXXXXXXXXX

3. Upload distributions:

python -m twine upload dist/*

Optional TestPyPI dry run:

python -m twine upload --repository testpypi dist/*