# 导入线程池执行器（concurrent.futures 是Python标准库的并发工具）
from concurrent.futures import ThreadPoolExecutor
# 导入requests库，用于发送HTTP请求
import requests
# 导入time模块，用于计算程序运行耗时
import time

# 定义需要请求的URL列表（这里用httpbin的延迟接口模拟网络请求耗时）
urls = [
    "https://httpbin.org/delay/1",  # 每个接口会延迟1秒再返回响应
    "https://httpbin.org/delay/1",
    "https://httpbin.org/delay/1",
]

# 定义单个线程要执行的任务函数：请求URL并返回状态码
# :param url: 要请求的目标地址
# :return: HTTP响应状态码（如200表示请求成功）
def fetch_url(url: str) -> int:
    # 发送GET请求，设置超时时间为5秒（防止请求卡住）
    resp = requests.get(url, timeout=5)
    # 返回响应状态码
    return resp.status_code

# 记录程序开始执行的时间
start = time.time()

# ====================== 线程池执行并发任务 ======================
# 使用with上下文管理器创建线程池，自动管理线程池的创建和销毁
# max_workers=5：表示线程池最多同时运行5个工作线程（这里3个任务，足够并发执行）
with ThreadPoolExecutor(max_workers=5) as executor:
    # executor.map：将urls列表中的每个元素依次传给fetch_url函数，并发执行
    # 1. 会自动为每个任务分配线程执行
    # 2. 结果会按输入urls的顺序返回（即使任务完成顺序不同）
    # 3. 返回的是迭代器，转成list方便直接查看结果
    results = list(executor.map(fetch_url, urls))

# 计算程序总耗时（当前时间 - 开始时间）
elapsed = time.time() - start

# 打印所有请求的结果（每个请求的状态码）
print(f"结果: {results}")
# 打印总耗时（保留2位小数）
# 注：这里耗时≈1s，而不是3s，因为3个请求是并发执行的，总耗时由最慢的请求决定
print(f"耗时: {elapsed:.2f}s")