philiprehberger-type-guard
v0.1.6112 downloadsMIT
Runtime type checking decorators for function arguments
$
pip install philiprehberger-type-guardREADME
philiprehberger-type-guard
Runtime type checking decorators for function arguments.
Installation
pip install philiprehberger-type-guard
Usage
Basic Usage
from philiprehberger_type_guard import guard
@guard
def greet(name: str, times: int = 1) -> str:
return name * times
greet("hello", 3) # Works fine
greet(123, 3) # Raises TypeGuardError
Generic Types
@guard
def process(items: list[int], lookup: dict[str, float]):
...
process([1, 2, 3], {"a": 1.0}) # OK
process(["a"], {}) # TypeGuardError
Union Types
@guard
def flexible(value: int | str | None):
...
flexible(42) # OK
flexible("hi") # OK
flexible(None) # OK
flexible(3.14) # TypeGuardError
Global Toggle
from philiprehberger_type_guard import enable, disable
disable() # Turn off all guards (e.g., in production)
enable() # Turn back on
Error Details
from philiprehberger_type_guard import TypeGuardError
try:
greet(123, 3)
except TypeGuardError as e:
print(e.param) # "name"
print(e.expected) # "str"
print(e.actual) # <class 'int'>
print(e.value) # 123
API
| Function / Class | Description |
|---|---|
@guard / @guard(enabled=True) | Decorator for runtime type checking |
enable() / disable() | Global toggle |
TypeGuardError | Raised on type mismatch (subclass of TypeError) |
Development
pip install -e .
python -m pytest tests/ -v
Support
If you find this project useful: