【译】Python装饰方法漫谈(一)

讲在开始


一直对Python中Decorator这个理念理解的不是很透彻,搜罗学习资料的时候发现了stackoverflow上一个略长略长但讲述清楚详尽的答案。准备利用最近的空闲时间翻译出来整理一下,当个搬运工。原答案链接在这里

上面是问题链接,这个链接直接跳到答案部分 ⬇️

http://stackoverflow.com/a/1594484

原答案代码2.7版本下可以全部运行成功,我将其中的代码用3.5版本重写,并改正了一些没有遵循PEP8规范的代码,以便自己学习理解的更深入一些

Kulbear:因为大学在国外上的,整个CS的教育背景基本是全英文,有些词翻译的可能不是很专业。现在还记得当初大一时候看书不知assignment statement是赋值语句。如果有翻译的错误,请随时指出。

基础


一切函数(Function)皆为对象(Object)

作为理解装饰器(Decorator)的重要前提,首先你要明白:Python中所有的函数都是对象

让我们来看一个简单的例子:

# -*- coding: utf-8 -*-
def shout(word="yes"):
    return word.capitalize() + "!"


print(shout())
# 输出 : Yes!

# 既然一切函数都是对象,那么你可以像赋值其他对象到一个变量一样,
# 将函数赋值给变量,如下
scream = shout

# 需要注意的是,我们没有在函数后面加上():我们并不是在调用这个函数,
# 而是在将函数shout“放入”变量scream中。
# 这意味着你可以通过scream来调用shout函数,如下
print(scream())
# 输出 : Yes!

# 此外,即使现在你删除了shout,你仍然可以通过scream调用这个函数
del shout
try:
    print(shout())
except NamError as e:
    print(e)
    # 输出 : name 'shout' is not defined

print(scream())
# 输出 : Yes!

好,牢记这一点,我们稍后还会回顾。

另一个你需要知道的特性是:在Python里,函数可以定义在另一个函数里

# -*- coding: utf-8 -*-
def talk():
    # 现在让我们在这里定义一个whisper函数 ...
    def whisper(word="yes"):
        return word.lower() + "..."

    # 直接调用whisper函数
    print(whisper())


# 你**每次**调用talk函数的时候,whisper函数都会被重新定义
# 并随后在talk内部被调用
talk()
# 输出 : yes...

# 但很明显,whisper函数在talk函数之外是undefined的
try:
    print(whisper())
except NameError as e:
    print(e)
    # 输出 : name 'whisper' is not defined
    # 牢记,Python中函数皆为对象

函数引用(Function Reference)

很高兴你持续读到了这里,有趣的才刚刚开始(讲道理,这句话我觉得很老外的语气...)

你已经明白了函数皆为对象这点,因此我们可以总结出,对于一个函数,它:

  • 可以被赋给变量
  • 可以再另一个函数中被定义

因此,一个函数可以返回(return)另一个函数

# -*- coding: utf-8 -*-
def scream(word="yes"):
    # 在原答案中没有这个函数,应该是来源于上面的代码片段
    # 这里我添加上以便每个文件可以独立执行
    return word.capitalize() + "!"


def get_talk(kind="shout"):
    def shout(word="yes"):
        return word.capitalize() + "!"

    def whisper(word="yes"):
        return word.lower() + "..."

    if kind == "shout":
        # 由于我们要返回的是函数这个对象,所以不使用(),
        return shout
    else:
        return whisper

# 如何使用?

# 获取一个函数,并把他复制给变量talk
talk = get_talk()

print(talk)
# 输出 : <function shout at 0xb7ea817c>

print(talk())
# 输出 : Yes!

# 也可以直接调用
print(get_talk("whisper")())
# 输出 : yes...


def do_something_before(func):
    print("I do something before then I call the function you gave me")
    print(func())


do_something_before(scream)
# 输出:
# I do something before then I call the function you gave me
# Yes!

好了,万事俱备,只欠东风了,理解装饰器所需要的知识点你应该已经全部具备了。

You see, decorators are “wrappers”, which means that they let you execute code before and after the function they decorate without modifying the function itself.

动手写一个装饰器吧

简单来说,装饰器就是一个接受其他函数为参数的函数

def my_shiny_new_decorator(a_function_to_decorate):
    # 这个函数“包装”了上面传入的函数,并且在被包装的函数前后
    # 当前函数可以添加执行一些别的代码
    def the_wrapper_around_the_original_function():
        # 被包装的函数之前要执行的代码部分
        print("Before the function runs")

        # 调用传入的函数a_function_to_decorate
        # 因为是调用,所以要带有()
        a_function_to_decorate()

        # 被包装的函数之后要执行的代码部分
        print("After the function runs")

    # 此时, "a_function_to_decorate" 从未被执行过.
    # 我们返回“包装”用的这个函数 "the_wrapper_around_the_original_function"
    return the_wrapper_around_the_original_function


# 现在,创建一个之后不做更改的函数
def a_stand_alone_function():
    print("I am a stand alone function")


a_stand_alone_function()
# 输出 : I am a stand alone function

# 现在,你可以通过装饰器来扩展上面这个函数
a_stand_alone_function_decorated = my_shiny_new_decorator(a_stand_alone_function)
a_stand_alone_function_decorated()
# 输出 :
# Before the function runs
# I am a stand alone function
# After the function runs

# 或者
a_stand_alone_function = my_shiny_new_decorator(a_stand_alone_function)
a_stand_alone_function()
# 输出 :
# Before the function runs
# I am a stand alone function
# After the function runs

很Pythonic的调用方法

@my_shiny_new_decorator
def another_stand_alone_function():
    print("Leave me alone")


another_stand_alone_function()
# 输出 :
# Before the function runs
# Leave me alone
# After the function runs

后记


And guess what? That’s EXACTLY what decorators do!

这只是原答案的基础部分,做出了十分基础详尽的讲解。

阅读下一篇?

http://www.jianshu.com/p/5f1149145c6d

哪里翻译的不好不详尽的请随时指出。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,723评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,485评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,998评论 0 344
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,323评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,355评论 5 374
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,079评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,389评论 3 400
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,019评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,519评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,971评论 2 325
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,100评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,738评论 4 324
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,293评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,289评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,517评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,547评论 2 354
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,834评论 2 345

推荐阅读更多精彩内容

  • 本文转自http://mingxinglai.com/cn/2015/08/python-decorator/ [...
    Jlan阅读 548评论 0 5
  • Python装饰器的高级用法(翻译) 原文地址https://www.codementor.io/python/t...
    城南道阅读 4,805评论 1 22
  • 要点: 函数式编程:注意不是“函数编程”,多了一个“式” 模块:如何使用模块 面向对象编程:面向对象的概念、属性、...
    victorsungo阅读 1,468评论 0 6
  • 本文为《爬着学Python》系列第四篇文章。从本篇开始,本专栏在顺序更新的基础上,会有不规则的更新。 在Pytho...
    SyPy阅读 2,489评论 4 11
  • 我不想占有世间任何一样东西. 江山风月,本无常主,闲者便是主人. 这是怎样一种情怀?又怎样可以做到这样一种情怀? ...
    于安然阅读 169评论 0 0