batch-data-test-tool 1.1.0

一个用于批量处理数据并发送HTTP请求的Python工具包

批量数据测试工具 (Batch Data Test Tool)

一个用于批量处理数据并发送HTTP请求的Python工具包。支持CSV和Excel文件读取，提供交互式Jupyter界面，方便进行批量API测试。

功能特性

• 📊 数据文件支持: 支持CSV和Excel文件读取
• 🔄 批量处理: 批量发送HTTP请求并处理响应
• 🎛️ 交互式界面: 基于Jupyter Widgets的友好用户界面
• 📈 数据预览: 实时预览处理结果
• 💾 智能保存: 支持自定义文件名，自动保存到output目录
• 🛠️ 灵活配置: 支持JSON配置文件，动态选择API接口
• 🔧 参数映射: 支持数据列与API参数的动态映射
• ⚡ 实时更新: API配置切换时自动更新参数选择器

安装

基础安装

pip install batch-data-test-tool

推荐安装（包含JupyterLab）

pip install batch-data-test-tool jupyterlab

💡 推荐使用JupyterLab：该工具专为Jupyter环境设计，提供最佳的用户体验

快速开始

使用前准备

1. 确保data目录存在

   mkdir data
   

   ⚠️ 如果data目录不存在，程序会报错

2. 配置config.json 在项目根目录创建config.json文件，配置您的API接口：

   [
       {
           "api_name": "我的API接口",
           "api_url": "http://your-api-endpoint.com/api",
           "headers": {
               "Content-Type": "application/json",
               "User-Agent": "BatchDataTestTool/1.0"
           },
           "params": {
               "conversation_text": "${conversation_text}",
               "sessionId": "default_session",
               "userKey": "app-10000"
           }
       }
   ]
   

3. 准备测试数据 将您的CSV或Excel文件放入data/目录

在JupyterLab中使用

from batch_data_test_tool import cola_start

# 启动交互式界面
cola_start()

作为命令行工具使用

batch-test-tool

使用流程

完整使用步骤

1. 准备环境

   # 创建必要目录
   mkdir data
   
   # 安装包
   pip install batch-data-test-tool
   

2. 配置API接口 创建config.json文件，配置您的API：

   [
       {
           "api_name": "我的API接口",
           "api_url": "http://your-api-endpoint.com/api",
           "headers": {
               "Content-Type": "application/json",
               "User-Agent": "BatchDataTestTool/1.0"
           },
           "params": {
               "conversation_text": "${conversation_text}",
               "sessionId": "default_session",
               "userKey": "app-10000"
           }
       }
   ]
   

3. 准备测试数据 将CSV或Excel文件放入data/目录

4. 启动JupyterLab

   jupyter lab
   

5. 使用工具

   from batch_data_test_tool import cola_start
   cola_start()
   

界面操作步骤

启动cola_start()后，按以下步骤操作：

1. Step001: 选择数据文件 - 从data/目录选择CSV或Excel文件
2. API配置 - 从config.json中选择预配置的API接口
3. Step002: 读取数据 - 点击"读取数据"按钮加载文件
4. Step003: 数据预览 - 查看数据前5行
5. Step004: 选择数据列 - 将数据列映射到API参数（自动根据config.json生成）
6. Step005: 批量处理 - 发送HTTP请求并处理响应
7. Step006: 选择保存列 - 选择要保存的结果列
8. Step007: 保存数据 - 自定义文件名保存到output/目录

许可证

本项目采用 MIT 许可证。详见 LICENSE 文件。

贡献

欢迎提交Issue和Pull Request！

更新日志

v1.1.0

• ✨ 新增功能:
  • 支持JSON配置文件，可配置多个API接口
  • 动态参数映射，支持数据列与API参数的灵活映射
  • API配置切换时自动更新参数选择器
  • 自定义文件名保存功能
  • 自动创建output目录并保存结果文件
• 🎯 界面优化:
  • 新增API配置选择器
  • 动态列选择器，根据API配置自动调整
  • 自定义文件名输入框
• 📁 文件管理:
  • 结果文件自动保存到output目录
  • 支持时间序列命名和自定义命名

支持

如果您遇到任何问题或有建议，请：

1. 查看 文档
2. 搜索 已知问题
3. 创建新的 Issue