decoguard 0.1.0

Lightweight Python library for robustly validating decorated functions, providing a clean, structured way to ensure they comply with defined conditions.

🛡️ DECOGUARD

Lightweight Python library for robustly validating decorated functions, providing a clean, structured way to ensure they comply with defined conditions.

📚 The complete documentation is available here. It includes more examples and use cases, so be sure to take a look. 📚

✨ Features

• Meta-Decorators: Easily add validation logic to your decorators and decorator factories.
• Validator Functions: Fine-grained validation rules for function signatures and usage.
• Assertion Utilities: Reusable assertion helpers for standalone validation.
• Centralized Validation: Keep your validation logic clean and maintainable.
• Clear Error Reporting: Developer-friendly exceptions for invalid decorator usage.
• Drop-In Simplicity: Integrate with existing Python code with minimal changes.

🚀 Getting Started

1. Install decoguard

   pip install decoguard
   

2. Import and use meta-decorators

   from decoguard.decorators import validate_decorated
   from decoguard.validators import require_params
   
   @validate_decorated(require_params("x", "y"))
   def my_decorator(func): return func
   
   @my_decorator
   def correct_usage(x, y): pass
   
   @my_decorator
   def bad_usage(x): pass # Will raise DecoratorUsageValidationError
   

📄 License

This project is licensed under the GNU Affero General Public License v3.0. See LICENSE for details.