Python ellipsis 的用法详解
背景
在Python的基本类型中单例模式的值有三个None类型的None,NotImplemented类型的NotImplemented,Ellipsis类型的...。
None已经用的烂大街了,NotImplemented也比较常用,唯独...在江湖上只知它是三巨头之一,但不知其用法。
Ellipsis
Ellipsis在python中代表“省略”,用现在的流形语来表达就是“老铁,不要在意这些细节!”。哪什么时候要告诉别人不要在意这些细节呢?其中的一个场景就是随机值。
用于文档测试
假设我们编写了一个类,要想知道这个有没有语法层面的错误,只要简单的调用一下就能测试出来。为了把这个测试自动化,于是做成了文档测试。
#!/usr/bin/evnpython3 classPerson(object): """人类类型 Parameters: ---------- name:str age:int Return: ------ >>>Person()""" name='' age=0 def__init__(self,name:str='tom',age:int=10)->'Person': """初始化 """ self.name=name self.age=age defsay_hello(self)->str: """返回打招呼信息 """ returnf"HelloMynameis{self.name}."
当我们运行测试用例时会报错,原因是每次创建的对象,它的内存地址并不等于测试用例中指定的哪个,而我们的用例上写死了。诚然这个问题用unittest可以解决,但是这个不是这里要讲的。
python3-mdoctestmain.py-v Trying: Person() Expecting:********************************************************************** File"/private/tmp/main.py",line12,inmain.Person Failedexample: Person() Expected: Got: 3itemshadnotests: main main.Person.__init__ main.Person.say_hello ********************************************************************** 1itemshadfailures: 1of1inmain.Person 1testsin4items. 0passedand1failed. ***TestFailed***1failures.
哪如何才能告诉doctest这位老铁不要在意返回值细节呢?答案是加上Ellipsis这个指令,改造后的代码如下。
#!/usr/bin/evnpython3 classPerson(object): """人类类型 Parameters: ---------- name:str age:int Return: ------ >>>Person()#doctest:+ELLIPSIS""" name='' age=0 def__init__(self,name:str='tom',age:int=10)->'Person': """初始化 """ self.name=name self.age=age defsay_hello(self)->str: """返回打招呼信息 """ returnf"HelloMynameis{self.name}."
运行测试用例这下可以通过了。
python3-mdoctestmain.py-v Trying: Person()#doctest:+ELLIPSIS Expecting:ok 3itemshadnotests: main main.Person.__init__ main.Person.say_hello 1itemspassedalltests: 1testsinmain.Person 1testsin4items. 1passedand0failed. Testpassed.
其它
如果我们是为模块添加测试用例,那么可以这样做,会方便一些。
#!/usr/bin/evnpython3 classPerson(object): """人类类型 Parameters: ---------- name:str age:int Return ------ >>>Person()#doctest:+ELLIPSIS <...Personobjectat0x...> """ name='' age=0 def__init__(self,name:str='tom',age:int=10)->'Person': """初始化 """ self.name=name self.age=age defsay_hello(self)->str: """返回打招呼信息 """ returnf"HelloMynameis{self.name}." if__name__=="__main__": #因为在模块在被import的时候__name__直接等于模块名不等于“__main__”,所以在作为模块被导入时并不会执行测试用例 #如果想执行测试用例直接执行模块就行 importdoctest doctest.testmod()
以上就是Pythonellipsis的用法详解的详细内容,更多关于Pythonellipsis的资料请关注毛票票其它相关文章!