pydecora 1.1.3

A lightweight and modular Python decorator library

pydecora 🧩

A lightweight and modular Python decorator library that helps you write cleaner and more expressive code.

🚀 Features

• 🧠 @cache: Simple in-memory caching with optional TTL and size limit
• 🔁 @retry: Automatically retry failed operations with exponential backoff
• 🛑 @suppress: Suppress exceptions and optionally log them
• ⏱️ @timeit: Time execution of functions
• 🧪 @validate_args: Enforce argument types using runtime validation
• 🧍 @singleton: Ensure a class is instantiated only once (classic singleton pattern)

📦 Installation

pip install pydecora

🧑‍💻 Usage

from pydecora import cache, retry

@cache(ttl=60)
def slow_func(x):
    return x * x

@retry(times=3, delay=1)
def flaky_api_call():
    ...

@singleton
class Config:
    def __init__(self):
        self.value = 42

📁 Project Structure

pydecora/
├── pydecora/
│   ├── init.py
│   └── decorators/
│       ├── cache.py
│       ├── retry.py
│       ├── singleton.py
│       ├── suppress.py
│       ├── timeit.py
│       └── validate_args.py
├── tests/
│   ├── test_cache.py
│   ├── test_retry.py
│   ├── test_singleton.py
│   ├── test_suppress.py
│   ├── test_timeit.py
│   └── test_validate_args.py
├── README.md
├── LICENSE
├── setup.py
└── pyproject.toml

🧪 Running Tests

pytest pydecora/tests

🤝 Contributing

Pull requests and ideas welcome! Please open an issue or fork and PR.

📄 License

MIT — see LICENSE