Skip to main content

A lightweight and modular Python decorator library

Project description

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

๐Ÿ“ฆ 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():
    ...

๐Ÿ“ Project Structure

pydecora/
โ”œโ”€โ”€ pydecora/
โ”‚ โ”œโ”€โ”€ init.py
โ”‚ โ””โ”€โ”€ decorators/
โ”‚ โ”œโ”€โ”€ cache.py
โ”‚ โ”œโ”€โ”€ retry.py
โ”‚ โ”œโ”€โ”€ suppress.py
โ”‚ โ”œโ”€โ”€ timeit.py
โ”‚ โ””โ”€โ”€ validate_args.py
โ”œโ”€โ”€ tests/
โ”‚ โ”œโ”€โ”€ test_cache.py
โ”‚ โ”œโ”€โ”€ test_retry.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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pydecora-1.1.1.tar.gz (9.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pydecora-1.1.1-py3-none-any.whl (12.4 kB view details)

Uploaded Python 3

File details

Details for the file pydecora-1.1.1.tar.gz.

File metadata

  • Download URL: pydecora-1.1.1.tar.gz
  • Upload date:
  • Size: 9.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.0 CPython/3.10.18

File hashes

Hashes for pydecora-1.1.1.tar.gz
Algorithm Hash digest
SHA256 b91f1947e9454273813cb16704aebd81e640aca3e358277304004749fc743961
MD5 1268881593a7a4acd50b7236146bf704
BLAKE2b-256 cd42a14ea325073e4e71701f45a08da5532ef07fd0a841018816b59bd7bc016d

See more details on using hashes here.

File details

Details for the file pydecora-1.1.1-py3-none-any.whl.

File metadata

  • Download URL: pydecora-1.1.1-py3-none-any.whl
  • Upload date:
  • Size: 12.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.0 CPython/3.10.18

File hashes

Hashes for pydecora-1.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 7a0a683a41b471f54c9267e3da883b8306a2bed44b14f96261b06c2d534728c7
MD5 ca4c14827df8e89c8b7c2ffaa2b449fa
BLAKE2b-256 10e6ada43cf2eca2d32e3fbafc7f9bcd39f3018853afdec3240ca193e1f89a9f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page