python - Python中具有自定义文档字符串的方法和属性别名
问题描述
我已经实现了以下装饰器:
class alias(object):
"""
A decorator for implementing method aliases.
"""
def __init__(self, *aliases):
self.aliases = set(aliases)
def __call__(self, obj):
if type(obj) == property:
obj.fget._aliases = self.aliases
else:
obj._aliases = self.aliases
return obj
def aliased(aliased_class):
"""
A decorator for enabling method aliases.
"""
aliased_class_dict = aliased_class.__dict__.copy()
aliased_class_set = set(aliased_class_dict)
for name, method in aliased_class_dict.items():
aliases = None
if (type(method) == property) and hasattr(method.fget, '_aliases'):
aliases = method.fget._aliases
elif hasattr(method, '_aliases'):
aliases = method._aliases
if aliases:
for a in aliases - aliased_class_set:
setattr(aliased_class, a, method)
return aliased_class
下面是我如何使用它们来创建属性和方法的可调用别名的示例:
@aliased
class MyClass(object):
@alias('a')
@property
def alpha(self) -> float:
"""
Returns the value of alpha.
"""
return 2.5
@alias('agt')
def alpha_greater_than(value) -> bool:
"""
Checks whether alpha is greater than the given value.
"""
return self.alpha > value
mc = MyClass()
result = mc.agt(3.0)
# ...
现在我正在打包我的项目并构建文档。目前,别名方法和属性“继承”原始实体的相同文档字符串。我想知道是否可以在装饰器级别操作别名实体的文档字符串,使它们看起来像:
此方法/属性是 X 的别名。
解决方案
您可以直接操作X.__doc__
,例如:
if aliases:
for a in aliases - aliased_class_set:
method.__doc__ = "This function is an alias of %s." % a
setattr(aliased_class, a, method)
但问题是原始参考X
也会受到影响。所以你最好使用包装器:
def aliased(aliased_class):
"""
A decorator for enabling method aliases.
"""
def wrapper(func):
@functools.wraps(func)
def inner(*args, **kwargs):
return func(*args, **kwargs)
return inner
aliased_class_dict = aliased_class.__dict__.copy()
aliased_class_set = set(aliased_class_dict)
for name, method in aliased_class_dict.items():
aliases = None
if (type(method) == property) and hasattr(method.fget, '_aliases'):
aliases = method.fget._aliases
elif hasattr(method, '_aliases'):
aliases = method._aliases
if aliases:
for a in aliases - aliased_class_set:
wrapped_method = wrapper(method)
wrapped_method.__doc__ = "This function is an alias of %s." % a
setattr(aliased_class, a, wrapped_method)
return aliased_class
并测试:
print(mc.alpha_greater_than.__doc__)
print(mc.agt.__doc__)
输出:
Checks whether alpha is greater than the given value.
This function is an alias of agt.
推荐阅读
- java - 无法为字段设置随机枚举
- python - matplotlib cutsom 样式表:用换行符格式化日期
- c# - 启动一次标头并发送每个 HTTP 请求
- linux - 在 Unix Shell 中制作和使用库
- php - 不要在数据透视表中插入值(Laravel 5.8)
- spring-security - Spring Oauth2 Client,自动刷新过期的access_token
- pytorch - Pytorch:涉及端到端雅可比范数的自定义损失
- visual-studio - VS2019 - 代码样式 - 在新行上强制执行表达式主体
- c++ - 如何在 C++ 中的“.bin”文件中编写结构数组?
- python - 根据其他列的唯一字符串创建一个带有数字的新列