py-artdeco 0.1.0

Method-aware sync/async decorator factories for Python.

artdeco

Method-aware decorator factories for Python functions and methods, with support for both synchronous and asynchronous decorator implementations.

Features

• Create decorators that work for plain functions and bound instance methods.
• Use the same high-level API for sync and async decorator implementations.
• Prevent mismatched usage (sync decorator applied to async function, and vice versa).
• Typed package with py.typed included.

Installation

pip install py-artdeco

Quick Start

from artdeco import decorator


@decorator()
def log(call, prefix: str):
	print(prefix, "calling")
	return call()


@log("DEBUG:")
def add(a: int, b: int) -> int:
	return a + b


assert add(1, 2) == 3

Async example:

from artdeco import decorator


@decorator()
async def traced(call, prefix: str):
	print(prefix, "before")
	return await call()


@traced("ASYNC")
async def work(x: int) -> int:
	return x * 2

Development

This project uses uv for environment and dependency management.

Install tools and dependencies:

uv sync --group dev

Run checks:

uv run ruff check .
uv run pytest
uv run pyright src

Run typing tests:

uv run pyright src tests/typing

Build and validate distribution metadata:

uv build
uv run twine check dist/*

License

MIT, see LICENSE.