acls 1.0.2

Description:

acls 1.0.2

@cls - Class Made Aware to Decorator








The purpose of this library is to provide possibility to create decorators, especially in super classes, with current class cls as argument.
Everything are centered with our new cls module, keyword, magic, or what every you think it would be.
Getting Started
Installation
Install by pip from PyPI:
pip install acls

Example
A typical snippet looks like:
from functools import wraps
import cls


class Base(metaclass=cls.ClsMeta):
@cls
def decor(cls, decor_arg):
def wrap(func):
@wraps(func)
def wrapper(self):
# do something with `func`
retval = func(self)
# do something with `retval`
return retval
return wrapper
return wrap

class Extended(Base):
@cls.decor('some arg')
def func(self):
# do something
pass

The magic is that you can use @cls.decor in Extended class, which is inheritance from Base.
What is more, with in the decorator Base.decor, argument cls will be assigned with the correct current class.
In this example, it would simply be a reference to Extended.
This would be helpful if you want to make use of some class property here in the decorator.
Magic
Well, there is no magic. I created a delegator in class namespace to enable both class possible to use @cls.
So, it is not the module cls as we imported on the top.
I use this to make it more consistent looking, and fool some interpreters like pylint.
No offense, just want to make them less noisy.
Limitations
Unfortunately, This work is based on customizing python class creation.
I have to make use of __prepare__, which is introduced only to python 3.
That means there is no known possible backward compatibility with python 2 now.
The code is tested against python 3.5+.
Please let me know if you come up with an idea how to manipulate class creation in python 2.
There are a couple of issues, with which I am talking. Contributions are welcome.
Known issue

relying on length of arguments and callable() to support optional arguments in decorator
not compatible with @classmethod, or many other decorators
make pylint really noisy
no documents :see_no_evil:!

License
MIT License, Copyright (c) 2019 guoquan