Python并不限制参数的名称,但是某些参数名称受约定严格控制,例如self
,cls
,args
和kwargs
。名称self
和cls
始终代表相同的概念,因此,在这些情况下,我很难看到令人信服的理由使人们偏离常规。但是,使用args
和kwargs
,我发现这种命名约定令人窒息。
说我有一个具有各种属性的类,可以通过将kwargs传递给其构造函数来进行设置:
class MyObj:
def __init__(self, **kwargs):
for propname in kwargs:
self.set_property(propname, kwargs[propname])
在这种情况下,仅将kwargs用作该类实例的可设置属性,因此对我而言,如下定义是有意义的:
class MyObj:
def __init__(self, **properties):
for propname in properties:
self.set_property(propname, properties[propname])
这样,仅需查看方法的签名即可了解kwarg的用途。
通常,我认为惯例是一件好事。但是,在我看来,始终使用args
和kwargs
是一个错失良机,无法向API用户传达有关函数/方法的args和kwargs的性质的有用信息。毕竟,使用单星号或双星号已经清楚地表明了它们未命名或已命名的事实。
有人在实际的多开发人员代码中使用args和kwargs的替代名称的例子吗?或者为这些构造使用其他变量名称是否太过严格?
如果不使用这些常规名称真的是一个可怕的想法,那是什么原因呢?
答案 0 :(得分:3)
我看不出有任何理由反对使用特定于上下文的名称,例如...
my_sum(*numbers)
,my_parser(*strings, **flags)
等
print
文档说*objects
。
zip
文档说*iterables
。
itertools.chain
在文档和文档字符串中使用*iterables
。
>>> from itertools import chain
>>> chain.__doc__.splitlines()[0]
'chain(*iterables) --> chain object'
collections.ChainMap
在文档和*maps
中使用__init__
。
>>> from collections import ChainMap
>>> from inspect import signature
>>> signature(ChainMap.__init__)
<Signature (self, *maps)>
请随时寻找更多示例。