# Author: Aaron Fan


"""
装饰器（别名：语法糖）：
定义：
    本质是函数（装饰其它函数），就是为其它函数添加一些附件的功能
原则：
    1、不能修改被装饰的函数的源代码
    2、不能修改被装饰的函数的调用方式
    3、装饰器存在对被装饰的函数是完全透明的（就是被装饰的函数完全感觉不到装饰器的存在）

实现装饰器的只是储备：
1、函数就是变量
2、高阶函数
3、嵌套函数

高阶函数 + 嵌套函数 == 装饰器
"""
import time


def timer(func):
    """
    一个最简单的装饰器：高阶函数 + 嵌套函数 == 装饰器
    计算一个函数的执行时间
    """
    def deco(*args,**kwargs):
        start_time = time.time()
        func(*args,**kwargs)  #这里运行传进来的实参（一个被装饰的函数）的函数体，这个示例中是指test1和test2
        stop_time = time.time()
        print("The func run time is %s" % (stop_time - start_time))
    return deco #返回deco的内存地址


@timer  # 给test1这个函数，添加一个装饰器，等同于 test1=timer(test1)=deco
        # 注意timer的return是deco，所以test1=timer(test1)，就是调用timer函数，并把deco的内存地址赋值给test1
        # 所以以后都会不在直接执行这个用def定义的最原始的test1()这个函数
        # 程序后面的所调用的test1()，其实执行的是deco()，通过deco来执行test1里面的函数体
        # 这里的deco()仅仅是timer()的一个嵌套函数，相当于timer的局部变量是无法直接在全局引用的
        # 但是timer这个高阶函数，返回了deco的内存地址，所以通过test1=timer(test1)之后，test1就等于deco的内存地址了，就可以直接使用test1()了
            #此时这个test()其实就是deco()，而不再是最原始的定的那个def test()
def test1():
    time.sleep(1)
    print("in the test1")


@timer
def test2(name1,name2):
    time.sleep(1)
    print("in the test2")
    print(name1,name2)


test1() #这个现在执行的其实已经不是test1这个函数了，而是执行的deco函数
test2(‘James‘,‘Aaron‘)

python3-装饰器