# 导入Python内置的异步IO库，用于编写异步代码
import asyncio

# ------------------- 定义协程函数 -------------------
# async def 是固定语法，用于定义【协程函数】
# 协程函数是异步编程的核心，调用后不会立即执行，返回协程对象
async def fetch_data(name: str) -> str:
    """模拟异步请求数据的协程函数"""
    # 打印请求开始的提示
    print(f"{name} 开始请求...")
    
    # await 关键字：只能在协程函数内使用
    # 作用：挂起当前协程，等待异步操作完成，期间事件循环可以执行其他任务
    # asyncio.sleep(1)：模拟异步的IO等待（如网络请求、数据库查询），非阻塞等待1秒
    await asyncio.sleep(1)
    
    # 等待结束后，打印请求完成提示
    print(f"{name} 请求完成")
    
    # 返回请求到的数据
    return f"{name} 的数据"

# ------------------- 定义主协程函数 -------------------
async def main():
    """主协程函数：程序的入口协程"""
    # 调用协程函数 + await：执行协程并等待结果
    # 这里演示【单个协程的同步执行】（依次等待完成）
    result = await fetch_data("A")
    
    # 打印协程执行完成后的返回结果
    print(result)

# ------------------- 启动异步程序 -------------------
# asyncio.run()：Python3.7+ 提供的顶层API
# 作用：创建事件循环 → 运行主协程 → 程序结束后关闭循环
asyncio.run(main())