Haha ! En tant qu'enseignant qui enseigne le python, j'ai découvert que les étudiants ont du mal à comprendre les décorateurs de python au début, peut-être parce que les décorateurs sont vraiment difficiles à comprendre. Pour maîtriser les décorateurs, vous devez comprendre certains concepts de fonctionformuleprogrammation, et bien sûr comprendre certaines fonctionnalités de la syntaxe liées à la définition et à l'appel de fonctions en python.
Je ne peux pas simplifier les décorateurs, mais grâce à une analyse étape par étape, je pourrai peut-être vous rendre plus confiant dans votre compréhension des décorateurs. Parce que le décorateur est très compliqué, cet article sera très long (j'ai dit qu'il était très long, mais comment oserais-je dire autant de bêtises blablabla... Je ne vais pas continuer la traduction et l'omettre pour les préliminaires)
En python, les fonctions sont définies via le mot-clé def
, le nom de la fonction et la liste de paramètres facultatifs. Renvoyez la valeur via le mot-clé <a href="//m.sbmmt.com/wiki/135.html" target="_blank">return<code><a href="//m.sbmmt.com/wiki/135.html" target="_blank">return</a>
. Prenons un exemple pour illustrer comment définir et appeler une fonction simple :
>>> def foo(): ... return 1 >>> foo() 1
Le corps de la méthode (bien sûr il en va de même pour plusieurs lignes) est requis, exprimé par une indentation, et des doubles crochets sont ajoutés après le nom de la méthode ()
peut appeler la fonction
En python, la fonction créera une nouvelle portée. Les développeurs Python peuvent dire que les fonctions ont leur propre espace de noms , ce qui signifie presque la même chose. Cela signifie que lorsqu'une variable est rencontrée dans une fonction, la fonction la recherchera d'abord dans son propre espace de noms. Écrivons une fonction simple pour voir la différence entre 本地作用域
et 全局作用域
:
>>> a_string = "This is a global variable" >>> def foo(): ... print locals() >>> print globals() {..., 'a_string': 'This is a global variable'} >>> foo() # 2 {}
La fonction intégrée globals
renvoie un nom de variableDictionnaire de pesée (par souci de propreté et de clarté, j'ai omis certaines variables créées par python). Dans le n°2, j'ai appelé la fonction pour imprimer le contenu à l'intérieur de la fonction foo
. Nous pouvons voir que la fonction 本地作用域
a son propre espace de noms indépendant, bien qu'il n'y ait temporairement rien dans l'espace de noms. foo
pour lui permettre d'imprimer des variables dans la portée globale, c'est aussi possible : foo
>>> a_string = "This is a global variable" >>> def foo(): ... print a_string # 1 >>> foo() This is a global variable
, bien sûr. Il est introuvable dans le a_string
de la fonction, il sera donc recherché dans le scope supérieur. 本地作用域
Mais d'un autre côté, si on attribue une valeur à la variable globale à l'intérieur de la fonction, le résultat est différent de ce que l'on pensait :
>>> a_string = "This is a global variable" >>> def foo(): ... a_string = "test" # 1 ... print locals() >>> foo() {'a_string': 'test'} >>> a_string # 2 'This is a global variable'
les types de données (comme list, dict, etc.) peuvent même être modifiés) mais l'affectation ne peut pas. Au n°1 à l'intérieur de la fonction, nous avons en fait une variable locale et 新创建
une variable du même nom dans la portée globale. Nous pouvons arriver à cette conclusion en imprimant le contenu de l'espace de noms local. On peut également voir que la valeur de la variable 隐藏
imprimée en #2 n'a pas changé. a_string
>>> def foo(): ... x = 1 >>> foo() >>> print x # 1 Traceback (most recent call last): ... NameError: name 'x' is not defined
(bien que ce soit la raison pour laquelle NameError a été levée), elle est également liée à python et 作用域规则
autres Elle est liée au mécanisme d'appel de fonction implémentation en langage de programmation. A ce moment d'exécution, il n'existe pas de syntaxe valide permettant d'obtenir la valeur de la variable , car elle n'existe pas à ce moment ! L'espace de noms de la fonction x
commence au début de l'appel de fonction et est détruit à la fin. foo
>>> def foo(x): ... print locals() >>> foo(1) {'x': 1}
Les paramètres de la fonction peuvent être obligatoires ou facultatifs 位置参数
. 命名,默认参数
>>> def foo(x, y=0): # 1 ... return x - y >>> foo(3, 1) # 2 2 >>> foo(3) # 3 3 >>> foo() # 4 Traceback (most recent call last): ... TypeError: foo() takes at least 1 argument (0 given) >>> foo(y=1, x=3) # 5 2
在#1处我们定义了函数foo
,它有一个位置参数x
和一个命名参数y
。在#2处我们能够通过常规的方式来调用函数,尽管有一个命名参数,但参数依然可以通过位置传递给函数。在调用函数的时候,对于命名参数y
我们也可以完全不管就像#3处所示的一样。如果命名参数没有接收到任何值的话,python会自动使用声明的默认值也就是0
。需要注意的是我们不能省略第一个位置参数x
, 否则的话就会像#5处所示发生错误。
目前还算简洁清晰吧, 但是接下来可能会有点令人困惑。python支持函数调用时的命名参数(个人觉得应该是命名实参)。看看#5处的函数调用,我们传递的是两个命名实参,这个时候因为有名称标识,参数传递的顺序也就不用在意了。
当然相反的情况也是正确的:函数的第二个形参是y
,但是我们通过位置的方式传递值给它。在#2处的函数调用foo(3,1)
,我们把3
传递给了第一个参数,把1
传递给了第二个参数,尽管第二个参数是一个命名参数。
桑不起,感觉用了好大一段才说清楚这么一个简单的概念:函数的参数可以有名称
和位置
。这意味着在函数的定义和调用的时候会稍稍在理解上有点儿不同。我们可以给只定义了位置参数的函数传递命名参数(实参),反之亦然!如果觉得不够可以查看官方文档
Python允许创建嵌套函数。这意味着我们可以在函数里面定义函数而且现有的作用域和变量生存周期依旧适用。
>>> def outer(): ... x = 1 ... def inner(): ... print x # 1 ... inner() # 2 ... >>> outer() 1
这个例子有一点儿复杂,但是看起来也还行。想一想在#1发生了什么:python解释器需找一个叫x
的本地变量,查找失败之后会继续在上层的作用域里面寻找,这个上层的作用域定义在另外一个函数里面。对函数outer
来说,变量x
是一个本地变量,但是如先前提到的一样,函数inner
可以访问封闭的作用域(至少可以读和修改)。在#2处,我们调用函数inner
,非常重要的一点是,inner
也仅仅是一个遵循python变量解析规则的变量名,python解释器会优先在outer
的作用域里面对变量名inner
查找匹配的变量.
显而易见,在python里函数和其他东西一样都是对象。(此处应该大声歌唱)啊!包含变量的函数,你也并不是那么特殊!
>>> issubclass(int, object) # all objects in Python inherit from a common baseclass True >>> def foo(): ... pass >>> foo.class # 1 <type 'function'> >>> issubclass(foo.class, object) True
你也许从没有想过,你定义的函数居然会有属性。没办法,函数在python里面就是对象,和其他的东西一样,也许这样描述会太学院派太官方了点:在python里,函数只是一些普通的值而已和其他的值一毛一样。这就是说你尅一把函数想参数一样传递给其他的函数或者说从函数了里面返回函数!如果你从来没有这么想过,那看看下面这个例子:
>>> def add(x, y): ... return x + y >>> def sub(x, y): ... return x - y >>> def apply(func, x, y): # 1 ... return func(x, y) # 2 >>> apply(add, 2, 1) # 3 3 >>> apply(sub, 2, 1) 1
这个例子对你来说应该不会很奇怪。add
和sub
是非常普通的两个python函数,接受两个值,返回一个计算后的结果值。在#1处你们能看到准备接收一个函数的变量只是一个普通的变量而已,和其他变量一样。在#2处我们调用传进来的函数:“()
代表着调用的操作并且调用变量包含的值。在#3处,你们也能看到传递函数并没有什么特殊的语法。” 函数的名称只是很其他变量一样的表标识符而已。
你们也许看到过这样的行为:“python把频繁要用的操作变成函数作为参数进行使用,像通过传递一个函数给内置排序函数的<a href="//m.sbmmt.com/wiki/1051.html" target="_blank">key</a>
参数从而来自定义排序规则。那把函数当做返回值回事这样的情况呢:
>>> def outer(): ... def inner(): ... print "Inside inner" ... return inner # 1 ... >>> foo = outer() #2 >>> foo <function inner at 0x...> >>> foo() Inside inner
这个例子看起来也许会更加的奇怪。在#1处我把恰好是函数标识符的变量inner
作为返回值返回出来。这并没有什么特殊的语法:”把函数inner
返回出来,否则它根本不可能会被调用到。“还记得变量的生存周期吗?每次函数outer
被调用的时候,函数inner
都会被重新定义,如果它不被当做变量返回的话,每次执行过后它将不复存在。
在#2处我们捕获住返回值 - 函数inner
,将它存在一个新的变量foo
里。我们能够看到,当对变量foo
进行求值,它确实包含函数inner
,而且我们能够对他进行调用。初次看起来可能会觉得有点奇怪,但是理解起来并不困难是吧。坚持住,因为奇怪的转折马上就要来了(嘿嘿嘿嘿,我笑的并不猥琐!)
我们先不急着定义什么是闭包,先来看看一段代码,仅仅是把上一个例子简单的调整了一下:
>>> def outer(): ... x = 1 ... def inner(): ... print x # 1 ... return inner >>> foo = outer() >>> foo.func_closure (<cell at 0x...: int object at 0x...>,)
在上一个例子中我们了解到,inner
作为一个函数被outer
返回,保存在一个变量foo
,并且我们能够对它进行调用foo()
。不过它会正常的运行吗?我们先来看看作用域规则。
所有的东西都在python的作用域规则下进行工作:“x
是函数outer
里的一个局部变量。当函数inner
在#1处打印x
的时候,python解释器会在inner
内部查找相应的变量,当然会找不到,所以接着会到封闭作用域里面查找,并且会找到匹配。
但是从变量的生存周期来看,该怎么理解呢?我们的变量x
是函数outer
的一个本地变量,这意味着只有当函数outer
正在运行的时候才会存在。根据我们已知的python运行模式,我们没法在函数outer
返回之后继续调用函数inner
,在函数inner
被调用的时候,变量x
早已不复存在,可能会发生一个运行时错误。
万万没想到,返回的函数inner
居然能够正常工作。Python支持一个叫做函数闭包
的特性,用人话来讲就是,嵌套定义在非全局作用域
里面的函数能够记住它在被定义的时候它所处的封闭命名空间。这能够通过查看函数的func_closure
属性得出结论,这个属性里面包含封闭作用域里面的值(只会包含被捕捉到的值,比如x
,如果在outer
里面还定义了其他的值,封闭作用域里面是不会有的)
记住,每次函数outer
被调用的时候,函数inner
都会被重新定义。现在变量x
的值不会变化,所以每次返回的函数inner
会是同样的逻辑,假如我们稍微改动一下呢?
>>> def outer(x): ... def inner(): ... print x # 1 ... return inner >>> print1 = outer(1) >>> print2 = outer(2) >>> print1() 1 >>> print2() 2
从这个例子中你能够看到闭包
- 被函数记住的封闭作用域 - 能够被用来创建自定义的函数,本质上来说是一个硬编码的参数
。事实上我们并不是传递参数1
或者2
给函数inner
,我们实际上是创建了能够打印各种数字的各种自定义版本。
闭包单独拿出来就是一个非常强大的功能, 在某些方面,你也许会把它当做一个类似于面向对象的技术:outer
像是给inner
服务的构造器,x
像一个私有变量。使用闭包的方式也有很多:你如果熟悉python内置排序方法的参数key
,你说不定已经写过一个lambda
方法在排序一个列表的列表的时候基于第二个元素而不是第一个。现在你说不定也可以写一个itemgetter
方法,接收一个索引值来返回一个完美的函数,传递给排序函数的参数key
。
不过,我们现在不会用闭包做这么low的事(⊙o⊙)…!相反,让我们再爽一次
,写一个高大上的装饰器
!
装饰器其实就是一个闭包,把一个函数当做参数然后返回一个替代版函数。我们一步步从简到繁来瞅瞅:
>>> def outer(some_func): ... def inner(): ... print "before some_func" ... ret = some_func() # 1 ... return ret + 1 ... return inner >>> def foo(): ... return 1 >>> decorated = outer(foo) # 2 >>> decorated() before some_func 2
仔细看看上面这个装饰器的例子。们定义了一个函数outer
,它只有一个some_func
的参数,在他里面我们定义了一个嵌套的函数inner
。inner
会打印一串字符串,然后调用some_func
,在#1处得到它的返回值。在outer
每次调用的时候some_func
的值可能会不一样,但是不管some_func
的之如何,我们都会调用它。最后,inner
返回some_func() + 1
的值 - 我们通过调用在#2处存储在变量decorated
里面的函数能够看到被打印出来的字符串以及返回值2
,而不是期望中调用函数foo
得到的返回值1
。
我们可以认为变量decorated
是函数foo
的一个装饰版本,一个加强版本。事实上如果打算写一个有用的装饰器的话,我们可能会想愿意用装饰版本完全取代原先的函数foo
,这样我们总是会得到我们的”加强版“foo
。想要达到这个效果,完全不需要学习新的语法,简单地赋值给变量foo
就行了:
>>> foo = outer(foo) >>> foo # doctest: +ELLIPSIS <function inner at 0x...>
现在,任何怎么调用都不会牵扯到原先的函数foo
,都会得到新的装饰版本的foo
,现在我们还是来写一个有用的装饰器。
想象我们有一个库,这个库能够提供类似坐标的对象,也许它们仅仅是一些x和y的坐标对。不过可惜的是这些坐标对象不支持数学运算符,而且我们也不能对源代码进行修改,因此也就不能直接加入运算符的支持。我们将会做一系列的数学运算,所以我们想要能够对两个坐标对象进行合适加减运算的函数,这些方法很容易就能写出:
>>> class Coordinate(object): ... def init(self, x, y): ... self.x = x ... self.y = y ... def repr(self): ... return "Coord: " + str(self.dict) >>> def add(a, b): ... return Coordinate(a.x + b.x, a.y + b.y) >>> def sub(a, b): ... return Coordinate(a.x - b.x, a.y - b.y) >>> one = Coordinate(100, 200) >>> two = Coordinate(300, 200) >>> add(one, two) Coord: {'y': 400, 'x': 400}
如果不巧我们的加减函数同时也需要一些边界检查的行为那该怎么办呢?搞不好你只能够对正的坐标对象进行加减操作,任何返回的值也都应该是正的坐标。所以现在的期望是这样:
>>> one = Coordinate(100, 200) >>> two = Coordinate(300, 200) >>> three = Coordinate(-100, -100) >>> sub(one, two) Coord: {'y': 0, 'x': -200} >>> add(one, three) Coord: {'y': 100, 'x': 0}
我们期望在不更改坐标对象one, two, three
的前提下one
减去two
的值是{x: 0, y: 0}
,one
加上three
的值是{x: 100, y: 200}
。与其给每个方法都加上参数和返回值边界检查的逻辑,我们来写一个边界检查的装饰器!
>>> def wrapper(func): ... def checker(a, b): # 1 ... if a.x < 0 or a.y < 0: ... a = Coordinate(a.x if a.x > 0 else 0, a.y if a.y > 0 else 0) ... if b.x < 0 or b.y < 0: ... b = Coordinate(b.x if b.x > 0 else 0, b.y if b.y > 0 else 0) ... ret = func(a, b) ... if ret.x < 0 or ret.y < 0: ... ret = Coordinate(ret.x if ret.x > 0 else 0, ret.y if ret.y > 0 else 0) ... return ret ... return checker >>> add = wrapper(add) >>> sub = wrapper(sub) >>> sub(one, two) Coord: {'y': 0, 'x': 0} >>> add(one, three) Coord: {'y': 200, 'x': 100}
这个装饰器能想先前的装饰器例子一样进行工作,返回一个经过修改的函数,但是在这个例子中,它能够对函数的输入参数和返回值做一些非常有用的检查和格式化工作,将负值的x
和 y
替换成0
。
显而易见,通过这样的方式,我们的代码变得更加简洁:将边界检查的逻辑隔离到单独的方法中,然后通过装饰器包装的方式应用到我们需要进行检查的地方。另外一种方式通过在计算方法的开始处和返回值之前调用边界检查的方法也能够达到同样的目的。但是不可置否的是,使用装饰器能够让我们以最少的代码量达到坐标边界检查的目的。事实上,如果我们是在装饰自己定义的方法的话,我们能够让装饰器应用的更加有逼格。
Python2.4支持使用标识符@
将装饰器应用在函数上,只需要在函数的定义前加上@
和装饰器的名称。在上一节的例子里我们是将原本的方法用装饰后的方法代替:
>>> add = wrapper(add)
这种方式能够在任何时候对任意方法进行包装。但是如果我们自定义一个方法,我们可以使用@
进行装饰:
>>> @wrapper ... def add(a, b): ... return Coordinate(a.x + b.x, a.y + b.y)
需要明白的是,这样的做法和先前简单的用包装方法替代原有方法是一毛一样的, python只是加了一些语法糖让装饰的行为更加的直接明确和优雅一点。
我们已经完成了一个有用的装饰器,但是由于硬编码的原因它只能应用在一类具体的方法上,这类方法接收两个参数,传递给闭包捕获的函数。如果我们想实现一个能够应用在任何方法上的装饰器要怎么做呢?再比如,如果我们要实现一个能应用在任何方法上的类似于计数器的装饰器,不需要改变原有方法的任何逻辑。这意味着装饰器能够接受拥有任何签名的函数作为自己的被装饰方法,同时能够用传递给它的参数对被装饰的方法进行调用。
非常巧合的是Python正好有支持这个特性的语法。可以阅读 Python Tutorial 获取更多的细节。当定义函数的时候使用了*
,意味着那些通过位置传递的参数将会被放在带有*
前缀的变量中, 所以:
>>> def one(*args): ... print args # 1 >>> one() () >>> one(1, 2, 3) (1, 2, 3) >>> def two(x, y, *args): # 2 ... print x, y, args >>> two('a', 'b', 'c') a b ('c',)
第一个函数one
只是简单地讲任何传递过来的位置参数全部打印出来而已,你们能够看到,在代码#1处我们只是引用了函数内的变量args
, *args
仅仅只是用在函数定义的时候用来表示位置参数应该存储在变量args
里面。Python允许我们制定一些参数并且通过args
捕获其他所有剩余的未被捕捉的位置参数,就像#2处所示的那样。*
操作符在函数被调用的时候也能使用。意义基本是一样的。当调用一个函数的时候,一个用*
标志的变量意思是变量里面的内容需要被提取出来然后当做位置参数被使用。同样的,来看个例子:
>>> def add(x, y): ... return x + y >>> lst = [1,2] >>> add(lst[0], lst[1]) # 1 3 >>> add(*lst) # 2 3
#1处的代码和#2处的代码所做的事情其实是一样的,在#2处,python为我们所做的事其实也可以手动完成。这也不是什么坏事,*args
要么是表示调用方法大的时候额外的参数可以从一个可迭代列表中取得,要么就是定义方法的时候标志这个方法能够接受任意的位置参数。
接下来提到的**
会稍多更复杂一点,**
代表着键值对的参数字典,和*
所代表的意义相差无几,也很简单对不对:
>>> def foo(**kwargs): ... print kwargs >>> foo() {} >>> foo(x=1, y=2) {'y': 2, 'x': 1}
当我们定义一个函数的时候,我们能够用**kwargs
来表明,所有未被捕获的关键字参数都应该存储在kwargs
的字典中。如前所诉,args
he kwargs
并不是python语法的一部分,但在定义函数的时候,使用这样的变量名算是一个不成文的约定。和*
一样,我们同样可以在定义或者调用函数的时候使用**
。
>>> dct = {'x': 1, 'y': 2} >>> def bar(x, y): ... return x + y >>> bar(**dct) 3
有了这招新的技能,我们随随便便就可以写一个能够记录下传递给函数参数的装饰器了。先来个简单地把日志输出到界面的例子:
>>> def logger(func): ... def inner(*args, **kwargs): #1 ... print "Arguments were: %s, %s" % (args, kwargs) ... return func(*args, **kwargs) #2 ... return inner
请注意我们的函数inner
,它能够接受任意数量和类型的参数并把它们传递给被包装的方法,这让我们能够用这个装饰器来装饰任何方法。
>>> @logger ... def foo1(x, y=1): ... return x * y >>> @logger ... def foo2(): ... return 2 >>> foo1(5, 4) Arguments were: (5, 4), {} 20 >>> foo1(1) Arguments were: (1,), {} 1 >>> foo2() Arguments were: (), {} 2
随便调用我们定义的哪个方法,相应的日志也会打印到输出窗口,和我们预期的一样。
原文地址:Understanding Python Decorators in 12 Easy Steps!
Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!