Python Hyper 项目教程

Python Hyper 项目教程

hyper HTTP/2 for Python. 项目地址: https://gitcode.com/gh_mirrors/hyper/hyper

1. 项目目录结构及介绍

Python Hyper 项目的目录结构如下：

hyper/
├── hyper/
│   ├── __init__.py
│   ├── client.py
│   ├── connection.py
│   ├── exceptions.py
│   ├── http20/
│   │   ├── __init__.py
│   │   ├── frame.py
│   │   ├── hpack.py
│   │   ├── stream.py
│   │   └── settings.py
│   ├── request.py
│   ├── response.py
│   └── utils.py
├── tests/
│   ├── __init__.py
│   ├── test_client.py
│   ├── test_connection.py
│   ├── test_http20.py
│   └── test_utils.py
├── setup.py
├── README.md
└── requirements.txt

目录结构介绍

• hyper/: 项目的核心代码目录，包含了所有与 HTTP/2 协议相关的实现。

  • __init__.py: 初始化文件，使得 hyper 成为一个 Python 包。
  • client.py: 客户端实现，用于发送 HTTP/2 请求。
  • connection.py: 连接管理模块，处理与服务器的连接。
  • exceptions.py: 自定义异常类。
  • http20/: HTTP/2 协议的具体实现。
    • __init__.py: 初始化文件。
    • frame.py: 定义了 HTTP/2 帧的结构。
    • hpack.py: HPACK 压缩算法实现。
    • stream.py: 流管理模块。
    • settings.py: 处理 HTTP/2 的设置帧。
  • request.py: 请求对象的实现。
  • response.py: 响应对象的实现。
  • utils.py: 工具函数和辅助类。

• tests/: 测试代码目录，包含了项目的单元测试。

  • __init__.py: 初始化文件。
  • test_client.py: 客户端测试。
  • test_connection.py: 连接管理测试。
  • test_http20.py: HTTP/2 协议实现测试。
  • test_utils.py: 工具函数测试。

• setup.py: 项目的安装脚本。

• README.md: 项目说明文档。

• requirements.txt: 项目依赖列表。

2. 项目的启动文件介绍

在 Python Hyper 项目中，没有明确的“启动文件”，因为该项目是一个库，而不是一个独立的应用程序。然而，如果你想要使用 Hyper 发送 HTTP/2 请求，你可以通过导入 hyper.client 模块来启动客户端。

from hyper import HTTP20Connection

# 创建一个 HTTP/2 连接
conn = HTTP20Connection('www.example.com')

# 发送 GET 请求
response = conn.request('GET', '/')

# 获取响应
resp = conn.get_response()

print(resp.status)
print(resp.read())

在这个示例中，HTTP20Connection 类是项目的核心启动点，用于创建与服务器的 HTTP/2 连接并发送请求。

3. 项目的配置文件介绍

Python Hyper 项目没有传统的配置文件（如 .ini 或 .yaml 文件），但你可以通过代码来配置一些参数。例如，你可以配置连接的超时时间、SSL 证书等。

from hyper import HTTP20Connection

# 配置连接参数
conn = HTTP20Connection(
    'www.example.com',
    port=443,
    secure=True,
    ssl_context=None,
    force_proto='h2'
)

# 发送请求
response = conn.request('GET', '/')
resp = conn.get_response()

print(resp.status)
print(resp.read())

在这个示例中，HTTP20Connection 的参数可以用来配置连接的端口、是否使用 SSL、SSL 上下文以及强制使用 HTTP/2 协议等。

总结

Python Hyper 项目是一个用于实现 HTTP/2 协议的 Python 库。通过了解其目录结构、启动文件和配置方式，你可以更好地理解和使用这个项目。

hyper HTTP/2 for Python. 项目地址: https://gitcode.com/gh_mirrors/hyper/hyper