Validator Decorator Python

This tool supports the design and documentation of a Python validator decorator. It focuses on the problem domain of enforcing input types, value constraints, and wrapper behavior at call time. It helps developers formalize how a decorator should validate each parameter, what errors to raise, and how to communicate violations to users. Conceptually, the tool models a decorator as a thin wrapper that inspects function signatures, applies a rule set, and delegates to the original function upon successful validation. It distinguishes required features (type hints alignment, basic error handling, and clear rule documentation) from optional capabilities (async support, custom exceptions, and metadata integration). It yields a reproducible plan, sample wrapper code, and a test-ready specification that can be used by QA to draft edge-case tests. The primary beneficiaries are Python library authors, API developers, and code reviewers who need consistent, auditable validation behavior across modules. Unique value lies in the combination of a formalized rule language, generated example implementations, and documentation that reduces ambiguity when enforcing contracts. Core features include a rules schema, signature-aware validation, error-minting guidance, and an outputs package containing code stubs and a validation report. Use cases span input validation for public APIs, parameter sanitization in data processing functions, and ensuring runtime guarantees in critical modules.