# 导入time模块，用于获取时间、程序休眠，实现计时功能
import time

# ====================== 【冗余写法】未使用装饰器的原始函数 ======================
# 缺点：每个函数都要重复写 开始时间、计算耗时 代码，冗余且难以维护
def get_posts():
    start = time.time()  # 记录函数开始执行时间
    print(f"耗时 {time.time()-start:.3f}s")  # 计算并打印执行耗时

def get_user():
    start = time.time()  # 记录函数开始执行时间
    print(f"耗时 {time.time()-start:.3f}s")  # 计算并打印执行耗时

# ====================== 【核心】定义计时装饰器 ======================
# 装饰器本质：接收一个函数作为参数，返回一个包装后的新函数
# 作用：不修改原函数代码，给函数额外增加「计时」功能
def timer(func):
    # 定义内层包装函数：*args, **kwargs 可以接收任意参数，让装饰器通用
    def wrapper(*args, **kwargs):
        # 1. 执行原函数前：记录开始时间
        start = time.time()
        # 2. 调用被装饰的原函数，并接收函数的返回值
        result = func(*args, **kwargs)
        # 3. 原函数执行后：计算耗时，保留3位小数打印
        print(f"耗时 {time.time()-start:.3f}s")
        # 4. 返回原函数的执行结果（保证原函数功能不受影响）
        return result
    # 返回包装好的新函数
    return wrapper

# ====================== 【使用装饰器】优雅给函数添加计时功能 ======================
# @timer 是Python装饰器语法糖
# 等价于：get_posts = timer(get_posts)
@timer
def get_posts():
    time.sleep(0.1)  # 模拟接口/数据请求耗时，休眠0.1秒
    return ["帖子1", "帖子2"]  # 原函数的业务逻辑：返回帖子列表

# 给get_user函数也添加计时功能
@timer
def get_user():
    time.sleep(0.05)  # 模拟请求耗时，休眠0.05秒
    return ["用户1", "用户2"]  # 原函数的业务逻辑：返回用户列表

# ====================== 主程序执行 ======================
# 判断是否是直接运行本文件（Python主程序入口规范）
if __name__ == "__main__":
    get_posts()  # 调用被装饰后的函数，自动执行计时+原功能
    get_user()   # 调用被装饰后的函数，自动执行计时+原功能