https://github.com/dusktreader/py-buzz

"That's not flying, it's falling with style": Python Exceptions with extras
https://github.com/dusktreader/py-buzz

exceptions python python-3

Last synced: about 2 months ago
JSON representation

"That's not flying, it's falling with style": Python Exceptions with extras

• Host: GitHub
• URL: https://github.com/dusktreader/py-buzz
• Owner: dusktreader
• License: mit
• Created: 2016-12-20T19:41:53.000Z (over 8 years ago)
• Default Branch: main
• Last Pushed: 2025-04-22T03:48:54.000Z (2 months ago)
• Last Synced: 2025-05-10T04:47:25.264Z (about 2 months ago)
• Topics: exceptions, python, python-3
• Language: Python
• Homepage: https://dusktreader.github.io/py-buzz/
• Size: 2.16 MB
• Stars: 18
• Watchers: 3
• Forks: 4
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
[![Latest Version](https://img.shields.io/pypi/v/py-buzz?label=pypi-version&logo=python&style=plastic)](https://pypi.org/project/py-buzz/)

[![Python Versions](https://img.shields.io/python/required-version-toml?tomlFilePath=https%3A%2F%2Fraw.githubusercontent.com%2Fdusktreader%2Fpy-buzz%2Fmain%2Fpyproject.toml&style=plastic&logo=python&label=python-versions)](https://www.python.org/)

[![Build Status](https://github.com/dusktreader/py-buzz/actions/workflows/main.yml/badge.svg)](https://github.com/dusktreader/py-buzz/actions/workflows/main.yml)

[![Documentation Status](https://github.com/dusktreader/py-buzz/actions/workflows/docs.yml/badge.svg)](https://dusktreader.github.io/py-buzz/)

![py-buzz-logo](https://github.com/dusktreader/py-buzz/blob/main/docs/source/images/buzz-logo-text.png)

**That's not flying, _it's falling with style_: Exceptions with extras**

![asciicast](https://github.com/dusktreader/py-buzz/blob/main/docs/source/images/py-buzz.gif)

py-buzz is fully equipped with a suite of exception tools that will save you

from writing the same code over and over again in your python projects. These

include:

* checking many conditions and reporting which ones failed (`check_expressions()`)

* catching exceptions wrapping them in clearer exception types with better error messages (`handle_errors()`)

* checking that values are defined and raising errors if not (`enforce_defined()`)

* checking that values are a certain type and raising errors if not (`ensure_type()`)

* checking conditions and raising errors on failure (`require_condition()`)

py-buzz also provides an exception class, Buzz, that can be used  as a base class

for custom exceptions within a project.

## Super-quick Start

* Only requires Python 3.9 or later

* Installed with pip (`$ pip install py-buzz`)

* Each feature demonstrated in an executable demo "extra"

## Documentation

The complete documentation can be found at the [py-buzz documentation page](https://dusktreader.github.io/py-buzz/)