Niquests是一款全新的、高性能的Python HTTP客户端，目标是成为requests API的“直接替代品”，同时提供异步支持和性能优化。
🚀 无缝替换：从requests零成本迁移
Niquests最大的优势之一是API与requests高度兼容。如果熟悉requests.get()和requests.post()，那么使用Niquests将毫无障碍。安装后，可以几乎原封不动地迁移现有代码，立刻获得性能提升。
# 安装命令：pip install niquests
import niquests as requests # 直接替代import requests# 使用和requests一模一样的API发起请求
response = requests.get('https://httpbin.org/get')
print(f'请求状态码: {response.status_code}')
print(f'响应内容类型: {response.headers["content-type"]}')
print(f'响应体长度: {len(response.content)} 字节')
⚡ 异步支持：轻松驾驭高并发场景
Niquests原生支持异步操作，性能远超同步的requests。只需使用async with语法，就能轻松发起异步请求，适合需要同时处理大量HTTP调用的爬虫或API客户端场景。
import asyncio
import niquestsasync def fetch_multiple_pages():urls = ['https://echo.free.beeceptor.com/your-path?key=value','https://jsonplaceholder.typicode.com/posts',]async with niquests.AsyncSession() as session:tasks = [session.get(url) for url in urls]responses = await asyncio.gather(*tasks)for i, resp in enumerate(responses):print(f'URL {i} 耗时: {resp.elapsed.total_seconds(): .2f} 秒')# 运行异步函数
asyncio.run(fetch_multiple_pages())
🔧 高级功能：连接池、HTTP/2与更精细的控制
Niquests在幕后做了大量优化。它内置高效的连接池，支持HTTP/2协议（可大幅提升性能），并提供了更精细的配置选项。可以轻松创建可复用的Session对象来管理Cookie和连接，优化多次请求的性能。
import niquests
from urllib3.util import Timeoutsession = niquests.Session(pool_connections=10,pool_maxsize=10,timeout=Timeout(5.0, 30.0) # 连接 5s，读取 30s
)
session.http2 = Trueresp = session.get('https://httpbin.org/json')
print(f'使用的HTTP协议版本: {resp.http_version}')
print(f'本次连接是否复用: {not resp.raw._original_response.isclosed()}')
运行结果： 使用的HTTP协议版本:HTTP/2 本次连接是否复用:False
🛡️ 请求重试与稳定性增强
在网络请求中，处理临时性故障（如连接超时、服务器错误）至关重要。Niquests内置了强大的重试机制，允许自定义重试策略（如对特定状态码重试、设置退避间隔），这比手动实现重试逻辑要可靠和简洁得多。
import niquests
from niquests import Session
from urllib3.util import Retry# 定义重试策略：总共重试3次，针对状态码500和超时错误
retry_strategy = Retry(total=3,status_forcelist=[500, 502, 503, 504],allowed_methods=['GET', 'POST']
)
# 将重试策略适配到会话
session = Session()
session.mount('https://', niquests.adapters.HTTPAdapter(max_retries=retry_strategy))try:resp = session.get('https://httpbin.org/status/500')print(f'最终状态码: {resp.status_code}')
except Exception as e:print(f'请求最终失败: {type(e).__name__}')
运行结果： 请求最终失败:MaxRetryError （在重试3次均收到500错误后，最终抛出异常）