Skip to main content

Decorator utility that operates on black magic

Project description

Collection of metaprogramming modules that operate on black magic!

Currently the only available module is:

  • black_magic.decorator


To the extent possible under law, Thomas Gläßle has waived all copyright and related or neighboring rights to black-magic. This work is published from: Germany.

To the extent possible under law, the person who associated CC0 with black-magic has waived all copyright and related or neighboring rights to black-magic.

You should have received a copy of the CC0 legalcode along with this work. If not, see


This is intended to become a more modern and flexible replacement for the the well known decorator module. This module benefits an API for more flexible usage. The behaviour of the decorator module can easily be duplicated.


You can use it just like the standard functools.wraps function:

>>> from black_magic.decorator import wraps

>>> x = []
>>> def real(a:int, b=x) -> "Returns b":
...     return b

>>> @wraps(real)
... def fake(*args, **kwargs):
...     print("Fake!")
...     return real(*args, **kwargs)

This will not only update the docstring of the fake function to look like the original but generate a wrapper function that has exactly the same signature:

>>> assert fake(1) is x   # check object-identity of default-parameter!

>>> from inspect import getfullargspec
>>> assert getfullargspec(fake) == getfullargspec(real)

If you want to get real crazy you can even use ast exprs:

>>> import ast
>>> fake = wraps(real)(ast.Num(n=1))
>>> fake(0)

Under the hood

Q: This uses ugly eval code, right?

A: No, it uses abstract syntax trees to do its dynamic code generation.


This module has been tested to work on python{2.6, 2.7, 3.2, 3.3} and PyPy1.9 using Travis.

Project details

Download files

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

Files for black-magic, version 0.0.3
Filename, size File type Python version Upload date Hashes
Filename, size black-magic-0.0.3.tar.gz (10.3 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page