feat: Added do_except and do_else to other methods

Also:
* Added unit tests for new functionality
* Added new functionality to the demos

Author: dusktreader

CHANGELOG.md

@@ -5,6 +5,11 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
+## v7.1.0 - 2025-04-19
+* Added `do_except` and `do_else` to `require_condition`, `enforce_defined`, and `check_expressions`
+* Added unit tests for new functionality
+* Added new functionality to the demos
+
 ## v7.0.0 - 2025-03-28
 * Removed `exc_builder` option from `Buzz`
 * Added `exc_builder` classmethod for `Buzz`

Makefile

@@ -1,49 +1,79 @@
 .ONESHELL:
 .DEFAULT_GOAL:=help
 SHELL:=/bin/bash
-PACKAGE_NAME:=src/buzz
+PACKAGE_TARGET:=src/buzz
 
-.PHONY: test
-test:
-	uv run pytest
-
-.PHONY: types
-types:
-	uv run mypy ${PACKAGE_NAME} src/demo --pretty
-	uv run basedpyright ${PACKAGE_NAME} src/demo
-
-.PHONY: lint
-lint:
-	uv run ruff check ${PACKAGE_NAME} tests src/demo
 
-.PHONY: qa
-qa: test lint types
-	echo "All quality checks pass!"
+# ==== Helpers =========================================================================================================
+.PHONY: confirm
+confirm:  ## Don't use this directly
+	@echo -n "Are you sure? [y/N] " && read ans && [ $${ans:-N} = y ]
 
-.PHONY: format
-format:
-	uv run ruff format ${PACKAGE_NAME} tests src/demo
 
-.PHONY: docs
-docs:
-	uv run mkdocs build --config-file=docs/mkdocs.yaml
-
-.PHONY: docs-serve
-docs-serve:
-	uv run mkdocs serve --config-file=docs/mkdocs.yaml --dev-addr=localhost:10000
+.PHONY: help
+help:  ## Show help message
+	@awk 'BEGIN {FS = ": .*##"; printf "\nUsage:\n  make \033[36m\033[0m\n"} /^[$$()% 0-9a-zA-Z_\/-]+(\\:[$$()% 0-9a-zA-Z_\/-]+)*:.*?##/ { gsub(/\\:/,":", $$1); printf "  \033[36m%-15s\033[0m %s\n", $$1, $$2 } /^##@/ { printf "\n\033[1m%s\033[0m\n", substr($$0, 5) } ' $(MAKEFILE_LIST)
 
 .PHONY: clean
-clean:
+clean:  ## Clean up build artifacts and other junk
 	@rm -rf .venv
 	@uv run pyclean . --debris
 	@rm -rf dist
-	@rm -rf .mypy_cache
-	@rm -rf .pytest_cache
 	@rm -rf .ruff_cache
+	@rm -rf .pytest_cache
+	@rm -rf .mypy_cache
 	@rm -f .coverage*
 	@rm -f .junit.xml
 
-# Recipe stolen from: https://gist.github.com/prwhite/8168133?permalink_comment_id=4160123#gistcomment-4160123
-.PHONY: help
-help:  ## Show help message
-	@awk 'BEGIN {FS = ": .*##"; printf "\nUsage:\n  make \033[36m\033[0m\n"} /^[$$()% 0-9a-zA-Z_-]+(\\:[$$()% 0-9a-zA-Z_-]+)*:.*?##/ { gsub(/\\:/,":", $$1); printf "  \033[36m%-15s\033[0m %s\n", $$1, $$2 } /^##@/ { printf "\n\033[1m%s\033[0m\n", substr($$0, 5) } ' $(MAKEFILE_LIST)
+
+# ==== Quality Control =================================================================================================
+.PHONY: qa/test
+qa: qa/full  ## Shortcut for qa/full
+
+.PHONY: qa/test
+qa/test:  ## Run the tests
+	uv run pytest
+
+.PHONY: qa/types
+qa/types:  ## Run static type checks
+	uv run mypy ${PACKAGE_TARGET} tests src/demo --pretty
+	uv run basedpyright ${PACKAGE_TARGET} tests src/demo
+
+.PHONY: qa/lint
+qa/lint:  ## Run linters
+	uv run ruff check ${PACKAGE_TARGET} tests src/demo
+	uv run typos ${PACKAGE_TARGET} tests src/demo
+
+.PHONY: qa/full
+qa/full: qa/test qa/lint qa/types  ## Run the full set of quality checks
+	@echo "All quality checks pass!"
+
+.PHONY: qa/format
+qa/format:  ## RUn code formatter
+	uv run ruff format ${PACKAGE_TARGET} tests src/demo
+
+
+# ==== Documentation ===================================================================================================
+.PHONY: docs
+docs: docs/serve  ## Shortcut for docs/serve
+
+.PHONY: docs/build
+docs/build:  ## Build the documentation
+	uv run mkdocs build --config-file=docs/mkdocs.yaml
+
+.PHONY: docs/serve
+docs/serve:  ## Build the docs and start a local dev server
+	uv run mkdocs serve --config-file=docs/mkdocs.yaml --dev-addr=localhost:10000
+
+
+# ==== Demo Commands ===================================================================================================
+.PHONY: demo
+demo: demo/run  ## Shortcut for demo/run
+
+.PHONY: demo/run
+demo/run:  ## Run the app in debug mode
+	uv run py-buzz-demo
+
+.PHONY: demo/debug
+demo/debug:  ## Run the app in debug mode
+	uv run debugpy --listen localhost:5678 --wait-for-client py-buzz-demo