Niquests 项目教程

Niquests 项目教程

niquests “Safest, Fastest, Easiest, and Most advanced” Python HTTP Client. Production Ready! Drop-in replacement for Requests. HTTP/1.1, HTTP/2, and HTTP/3 supported. With WebSocket, and SSE! Be free of Requests bondage now. 项目地址: https://gitcode.com/gh_mirrors/ni/niquests

1. 项目介绍

Niquests 是一个基于 Python 的 HTTP 客户端库，它是一个对 Requests 库的直接替代品，但提供了更多先进的特性。Niquests 支持 HTTP/1.1、HTTP/2 和 HTTP/3，同时具备 WebSocket 和 SSE（Server-Sent Events）的支持。它被认为是“最安全、最快、最简单和最先进”的 Python HTTP 客户端，适合生产环境使用。

2. 项目快速启动

首先，确保您的环境中已经安装了 Python 3.7 或更高版本。接下来，使用 pip 命令安装 Niquests：

python -m pip install niquests

安装完成后，您可以通过以下代码快速发送一个 HTTP GET 请求：

import niquests

response = niquests.get('https://one.one.one.one')
print(response.status_code)
print(response.text)

如果您想要使用异步请求，可以使用 aget 方法：

import niquests
import asyncio

async def main():
    response = await niquests.aget('https://one.one.one.one')
    print(response.status_code)
    print(await response.text())

asyncio.run(main())

3. 应用案例和最佳实践

DNS over HTTPS

Niquests 支持 DNS over HTTPS，可以在请求时自动使用：

import niquests

response = niquests.get('https://one.one.one.one', dns_over_https=True)
print(response.status_code)

流式下载

对于大文件下载，可以使用流式下载功能：

import niquests

response = niquests.get('https://example.com/largefile.zip', stream=True)
with open('largefile.zip', 'wb') as f:
    for chunk in response.iter_content(chunk_size=8192):
        f.write(chunk)

WebSocket

使用 Niquests 实现 WebSocket 连接：

import niquests

ws = niquests.WebSocket('wss://example.com/socket')
ws.connect()
ws.send('Hello, WebSocket!')
print(ws.recv())
ws.close()

4. 典型生态项目

以下是使用 Niquests 的几个典型生态项目：

• niquests-stats：用于展示 Niquests 的性能测试结果和统计信息。
• niquests-examples：包含 Niquests 的各种使用示例。
• niquests-contrib：社区贡献的各种 Niquests 相关插件和工具。

通过这些项目，您可以更好地了解 Niquests 的功能和实际应用。

niquests “Safest, Fastest, Easiest, and Most advanced” Python HTTP Client. Production Ready! Drop-in replacement for Requests. HTTP/1.1, HTTP/2, and HTTP/3 supported. With WebSocket, and SSE! Be free of Requests bondage now. 项目地址: https://gitcode.com/gh_mirrors/ni/niquests