JMeterTools 简介
JMeterTools 是一个由 Python 编写的开源项目，旨在帮助测试人员快速生成 JMeter 测试脚本。通过简单的 Python API，用户可以方便地定义测试计划、线程组、HTTP 请求等，可以结合接口自动化测试项目，将接口自动化测试转换为接口性能测试。
项目地址：https://gitee.com/zhangkx_z/JMeterTools
JMeterTools 的安装与使用
安装
JMeterTools 的安装非常简单，由于它是 Python 项目，你只需要确保你的环境中已安装 Python，并且已经配置好了 Python 的包管理工具 pip。
pip install JMeterTools
使用
初始化 JMeter 脚本
使用 JMeterTools 的第一步是初始化一个 JMeter 脚本对象。这可以通过导入 JMeter 类并调用其 get 方法来完成。
from jmetertools import JMeter
jmeter_script = JMeter.get()
创建 HashTree
在 JMeter 的 XML 结构中，hashTree 是组织测试元素（如测试计划、线程组、取样器等）的基本容器。你需要为这些元素创建一个 hashTree。
import xml.etree.ElementTree as ET
hash_tree = ET.SubElement(jmeter_script, 'hashTree')
添加测试计划
测试计划是整个 JMeter 测试场景的基础。你可以通过 JMeterTestPlan 类来创建一个测试计划，并将其添加到 hashTree 中。
from jmetertools import JMeter
test_plan = JMeter.JMeterTestPlan()
test_plan_element = test_plan.get(hash_tree)
添加线程组
线程组用于模拟并发用户。你可以通过 JMeterThreadGroup 类创建一个线程组，并配置其属性（如线程数、循环次数等）。
from jmetertools import JMeter
thread_group_tree = ET.SubElement(hash_tree, 'hashTree')
thread_group = JMeter.JMeterThreadGroup().get(thread_group_tree)
# 假设配置为 10 个用户，循环 1 次
thread_group.set_num_threads(10)
thread_group.set_loops(1)
添加 HTTP 请求取样器
HTTP 请求取样器是 JMeter 中最常用的组件之一，用于模拟对 HTTP 服务器的请求。
from jmetertools import JMeter
http_sampler = JMeter.JMeterHttpSampler()
http_sampler.set_method('post')
http_sampler.set_protocol('http')
http_sampler.set_domain('127.0.0.1')
http_sampler.set_port('8080')
http_sampler.set_contentEncoding('UTF-8')
http_sampler.set_postBodyRaw({"test1": "test2"})
http_sampler.set_params({'test': 123})
http_sampler.set_files({'file': 'test.txt'})
http_sampler.get(hash_tree) # 注意这里通常应该添加到线程组下的 hashTree
注意：在实际使用中，HTTP 请求取样器应该被添加到线程组下的 hashTree 中，上述代码为了简化示例，直接添加到了根 hashTree 下。
其他测试模块
其他测试模块参考代码中core目录下，__JMeter开头的python文件，参数设置方式在代码中的注释详细的介绍了。
示例：
总结
优势
提高测试计划创建的效率和灵活性：通过编程方式定义测试计划，可以快速适应测试需求的变化，提高测试计划的创建效率。
减少错误风险：自动化生成JMX文件减少了手动编写过程中的错误风险。
支持复杂测试场景：JMeterTools提供的API支持高度定制化的测试计划，能够满足复杂的测试需求。
JMeterTools是一个具有创新意义的开源项目，它通过Python API为Apache JMeter性能测试脚本的自动化生成提供了新的解决方案。
