Size: 578
Comment: converted to 1.6 markup
|
Size: 6720
Comment: introduce a table to collect a few more samples (right now it's mostly links to stdlib manual)
|
Deletions are marked like this. | Additions are marked like this. |
Line 2: | Line 2: |
|| '''Category''' || '''Decorator''' || '''Summary''' || || builtin || [[https://docs.python.org/3/library/functions.html?highlight=property#property|@property]] || Turn function into propery accessor, also: `@property.setter` || || builtin || [[https://docs.python.org/3/library/functions.html?highlight=property#classmethod|@classsmethod]] || Use `cls` instead of `self` || || builtin || [[https://docs.python.org/3/library/functions.html?highlight=property#staticmethod|@staticmethod]] || Defines methods without self handle || || stdlib || [[https://docs.python.org/3/library/functools.html?highlight=functools#functools.wraps|@functools.wraps]] || Retain modicum of meta infos (`__doc__`) of wrapped function || || stdlib || [[https://docs.python.org/3/library/functools.html?highlight=functools#functools.singledispatch|@functools.singledispatch]] || Allows for divergent implementations per @f.register() || || stdlib/backports || [[https://stackoverflow.com/questions/815110/is-there-a-decorator-to-simply-cache-function-return-values|@functools.lru_cache]] || Wrap computationally expensive functions || || stdlib || [[https://docs.python.org/3/library/functools.html?highlight=functools#functools.cmp_to_key|@functools.cmp_to_key]] || Transform an old-style comparison function to a key function. || || stdlib || [[https://docs.python.org/3/library/functools.html?highlight=functools#functools.total_ordering|@functools.total_ordering]] || Adds any of the missing lt,le,eq,ge,gt comparison dunder methods || || stdlib || [[https://docs.python.org/3/library/functools.html?highlight=functools#functools.partial|@functools.partial]] || Prepopulate a couple of function arguments || || stdlib || [[https://docs.python.org/3/library/contextlib.html?highlight=decorator#contextlib.contextmanager|@contextlib.contextmanager]] || Uses generator protocol `yield` to turn function into `with`-able context mananger || || stdlib || [[https://docs.python.org/3/library/dataclasses.html?highlight=decorator#dataclasses.dataclass|@dataclasses.dataclass]] || Adds various “dunder” methods to the class to streamline property access || || stdlib || [[https://docs.python.org/3/library/atexit.html?highlight=decorator#atexit.register|@atexit.register]] || Run as shutdown function || || stdlib || [[https://docs.python.org/3/library/abc.html?highlight=decorator#abc.ABCMeta.register|@abc.ABCMeta.register]] || Turn into abstract base class || || stdlib || [[https://docs.python.org/3/library/enum.html?highlight=decorator#enum.unique|@enum.unique]] || Guarantee unique members in enum class || || stdlib || [[https://docs.python.org/3/library/xmlrpc.server.html?highlight=decorator#xmlrpc.server.SimpleXMLRPCServer.register_function|@xmlrpc.….register_function]] || ... || || asyncio || [[https://docs.python.org/3/library/asyncio-task.html?highlight=asyncio%20coroutine#asyncio.coroutine|@coroutine]] || Outdated scheme for `async def`, deprecated in 3.8 || || asyncio || [[https://pypi.org/project/aiodecorator/|@throttle(2,1)]] || Reduce invocations per timeframe || || asyncio || [[https://hackernoon.com/python-async-decorator-to-reduce-debug-woes-nv2dg30q5|@exceptionCatcher…]] || Log exceptions more instantly || || asyncio || [[https://gist.github.com/Integralist/77d73b2380e4645b564c28c53fae71fb|@timeit]] || Basic benchmarking || || async || [[https://pypi.org/project/process-decorator/|@async_process]] || make func async and execute in other process || || testing || [[https://docs.python.org/3/library/unittest.mock.html#unittest.mock.patch|@unittest.mock.patch]] || Override function w/ signature || || testing || [[http://blog.dscpl.com.au/2015/03/using-wrapt-to-support-testing-of.html|@wrapt.patch_function_wrapper]] || Override function w/ signature || || decorator || [[https://pypi.org/project/decorator/|@decorator]] || Assists declaring signature-preserving and single dispatch decorators || || decorator || [[https://pypi.org/project/decorator-args/|@decorator_args]] || Ease parameterizing decorators themselvess || || decorator || [[https://github.com/Yelp/named_decorator|@named_decorator]] || Retain callees' function name to simplify tracebacks || || decorator || [[https://pypi.org/project/Easy_Decorator/|@dec.decorator(before=cb,after=cb)]] || Craft trivial enter/exit decorator || || collect || [[https://click.palletsprojects.com/en/7.x/commands/|@click.option("-d")]] || Argparse alternative || || collect || [[https://pypi.org/project/config-decorator/|@config_decorator.setting]] || Declarative dict structure for application settings || || collect || [[https://github.com/xtream1101/regex-decorator|@regex_decorator.listen]] || Register function callbacks for pattern matching || || typing || [[https://pypi.org/project/contract-decorator/|@contract({"param":gt(3)})]] || Exhaustive function parameter constraints || || flow handling || [[#A__main__|@__main__]] || Automatically run a function if invocation script || || flow handling || [[http://www.praddy.in/retry-decorator-whitelisted-exceptions/|@retry(times=2)]] || Reinvokes function a few times when encountering (temporary) exceptions, alt: [[https://pypi.org/project/retry-decorator/|pypi:retry-decorator]] || || monkeypatching || [[https://fossil.include-once.org/modseccfg/wiki/@inject|@inject(modules…)]] || Shorthand assignment to modules/objects || || monkeypatching || [[https://github.com/theatlantic/python-monkey-business|@monkeybiz.patch(fn)]] || Swap out function in object, retain reference to original || (Note: Not sure this is going anywhere. Relisting builtins is somewhat redundant, but topical. The focus is novel/interesting decorators in the wild. The categorization probably won't hold up.) |
A page for useful (or potentially abusive?) decorator ideas.
Category |
Decorator |
Summary |
builtin |
Turn function into propery accessor, also: @property.setter |
|
builtin |
Use cls instead of self |
|
builtin |
Defines methods without self handle |
|
stdlib |
Retain modicum of meta infos (__doc__) of wrapped function |
|
stdlib |
Allows for divergent implementations per @f.register() |
|
stdlib/backports |
Wrap computationally expensive functions |
|
stdlib |
Transform an old-style comparison function to a key function. |
|
stdlib |
Adds any of the missing lt,le,eq,ge,gt comparison dunder methods |
|
stdlib |
Prepopulate a couple of function arguments |
|
stdlib |
Uses generator protocol yield to turn function into with-able context mananger |
|
stdlib |
Adds various “dunder” methods to the class to streamline property access |
|
stdlib |
Run as shutdown function |
|
stdlib |
Turn into abstract base class |
|
stdlib |
Guarantee unique members in enum class |
|
stdlib |
... |
|
asyncio |
Outdated scheme for async def, deprecated in 3.8 |
|
asyncio |
Reduce invocations per timeframe |
|
asyncio |
Log exceptions more instantly |
|
asyncio |
Basic benchmarking |
|
async |
make func async and execute in other process |
|
testing |
Override function w/ signature |
|
testing |
Override function w/ signature |
|
decorator |
Assists declaring signature-preserving and single dispatch decorators |
|
decorator |
Ease parameterizing decorators themselvess |
|
decorator |
Retain callees' function name to simplify tracebacks |
|
decorator |
Craft trivial enter/exit decorator |
|
collect |
Argparse alternative |
|
collect |
Declarative dict structure for application settings |
|
collect |
Register function callbacks for pattern matching |
|
typing |
Exhaustive function parameter constraints |
|
flow handling |
Automatically run a function if invocation script |
|
flow handling |
Reinvokes function a few times when encountering (temporary) exceptions, alt: pypi:retry-decorator |
|
monkeypatching |
Shorthand assignment to modules/objects |
|
monkeypatching |
Swap out function in object, retain reference to original |
(Note: Not sure this is going anywhere. Relisting builtins is somewhat redundant, but topical. The focus is novel/interesting decorators in the wild. The categorization probably won't hold up.)
__main__
This decorator does not alter a function, but causes it to be executed if __name__ == '__main__'. This provides an experimental cleaner syntax to the traditional way of bootstrapping a python script. This should not be used on class methods.
The function gets a copied list of sys.argv arguments.