alexliesenfeld/httpmock Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

httpmock

镜像概述和主要用途

httpmock是一个功能丰富的HTTP模拟库，主要用于Rust应用的测试场景，同时支持独立模式部署。它允许开发者模拟HTTP服务的行为，以测试应用在不同HTTP响应下的表现。通过Docker镜像可快速部署独立模拟服务器，适用于多语言环境的系统测试或端到端测试，模拟各类外部HTTP API、数据存储或认证服务。

核心功能和特性

• 简洁流畅的API：提供直观的链式调用接口，简化模拟规则定义
• 全面的请求匹配：支持HTTP方法、路径、查询参数、请求头、请求体等多维度匹配
• 并行测试支持：可在并行测试环境中稳定运行，避免测试干扰
• 灵活的响应配置：支持自定义状态码、响应头、响应体及网络延迟模拟
• 多格式支持：内置JSON、serde序列化、正则表达式(Regex)和Cookie匹配
• 双向API：同时提供同步和异步接口，适应不同测试场景
• 高级验证与调试：支持请求调用次数验证、详细错误信息输出
• 独立模式：可通过Docker镜像部署为独立服务，支持跨语言/跨进程使用
• 文件配置：支持通过YAML文件定义模拟规则，无需编写代码

使用场景和适用范围

• Rust应用测试：单元测试、集成测试中模拟外部HTTP依赖服务
• 系统测试：为多组件系统提供稳定的模拟HTTP服务
• 端到端测试：模拟第三方API或微服务，确保测试环境一致性
• 开发环境：在本地开发中快速搭建模拟后端服务，无需依赖真实环境
• 跨语言测试：为非Rust应用（如Java、Python等）提供HTTP模拟服务

使用方法和配置说明

1. Rust项目集成

添加依赖

在Cargo.toml中添加：

toml
[dev-dependencies]
httpmock = "0.6"

基本使用示例

rust
use httpmock::prelude::*;

// 启动轻量级模拟服务器
let server = MockServer::start();

// 创建模拟规则
let hello_mock = server.mock(|when, then| {
    when.method(GET)
        .path("/translate")
        .query_param("word", "hello");
    then.status(200)
        .header("content-type", "text/html; charset=UTF-8")
        .body("Привет");
});

// 发送测试请求（模拟应用代码）
let response = isahc::get(server.url("/translate?word=hello")).unwrap();

// 验证模拟规则被调用
hello_mock.assert();

// 验证响应状态
assert_eq!(response.status(), 200);

2. 独立模式（Docker部署）

基本Docker运行命令

bash
docker run -p 8080:8080 alexliesenfeld/httpmock

自定义端口

bash
docker run -p 9090:9090 -e HTTPMOCK_PORT=9090 alexliesenfeld/httpmock

使用YAML配置文件

bash
docker run -p 8080:8080 -v ./mocks:/mocks alexliesenfeld/httpmock --config /mocks

Docker Compose配置示例

yaml
version: '3'
services:
  httpmock:
    image: alexliesenfeld/httpmock
    ports:
      - "8080:8080"
    environment:
      - HTTPMOCK_PORT=8080
    volumes:
      - ./mocks:/mocks
    command: --config /mocks

3. YAML文件配置示例

创建mocks/example.yaml文件：

yaml
- name: hello_mock
  request:
    method: GET
    path: /translate
    query_params:
      word: hello
  response:
    status: 200
    headers:
      content-type: text/html; charset=UTF-8
    body: "Привет"
    delay: 100ms  # 模拟100ms网络延迟

4. 环境变量配置

更多资源

• 官方文档
• GitHub仓库
• Docker镜像
• 示例代码

许可证

MIT许可证。详情参见项目许可证。