Skip to main content

Minimal project scaffolding for developers

Project description

🌬️ briza

Python Version License Status

A fast, opinionated CLI to bootstrap clean Python projects.

briza helps you create structured, production-ready Python projects in seconds — with sensible defaults and zero boilerplate friction.


✨ Features

  • ⚡ Instant project scaffolding
  • 📦 Pre-configured pyproject.toml
  • 🗂 Clean src/-based structure
  • 🧩 Minimal and opinionated defaults
  • 🛠 Built for real-world Python development

📦 Installation

pip install briza

🚀 Quick Start

Create a new project:

briza new my_project

Done.

Your project is ready to go.


🛠 Commands

briza new <project_name>

Creates a new Python project with:

  • Configured pyproject.toml
  • Organized directory structure
  • Starter files
  • Clean entry point

Example:

briza new api_service

📁 Example Generated Structure

my_project/
├── pyproject.toml
├── README.md
└── src/
    └── my_project/
        ├── __init__.py
        └── main.py

🎯 Philosophy

briza follows a few core principles:

  • Keep it simple
  • Prefer convention over configuration
  • Avoid unnecessary complexity
  • Stay fast and lightweight

It is designed for developers who want structure — not ceremony.


📌 Version

Current stable release: 1.0.0

briza follows Semantic Versioning.


🛣 Roadmap

Future improvements may include:

  • Plugin system
  • Template customization
  • Project presets (API, CLI, library)
  • Optional CI configuration

🤝 Contributing

Contributions, issues, and suggestions are welcome.

If you'd like to improve briza:

  1. Fork the repository
  2. Create your feature branch
  3. Submit a Pull Request

📄 License

This project is licensed under the GNU General Public License v3.0 (GPL-3.0).

You are free to use, modify, and distribute this software under the same license terms.

See the LICENSE file for full details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

briza-1.0.0.tar.gz (42.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

briza-1.0.0-py3-none-any.whl (30.6 kB view details)

Uploaded Python 3

File details

Details for the file briza-1.0.0.tar.gz.

File metadata

  • Download URL: briza-1.0.0.tar.gz
  • Upload date:
  • Size: 42.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for briza-1.0.0.tar.gz
Algorithm Hash digest
SHA256 33b76f5cbf05c6f5ade19eb351cd0fc54416ab0ff03ec8faabfdacaa441be4f5
MD5 70cc82e7f9ff710d2f1cc0e5c489a454
BLAKE2b-256 54b73fe32fa5c66a8bd3a8c30d179ec21a931a70fc391a34a9eba28d9901b2bc

See more details on using hashes here.

File details

Details for the file briza-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: briza-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 30.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for briza-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 58e2d4a13aa1958b34dcd9c1f9ef8519c365a7b5dda6abe065cdedb7dc52d225
MD5 192458838c66fc101d66625a25f28f12
BLAKE2b-256 f32b13a3aad686f2427f24098d9c217f02931fdec377a7d6a6ceea620e5c5090

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page