xmind2testcase-lq

这是 xmind2testcase 的定制分支（fork），不是上游官方版本。 面向「XMind 思维导图 → 禅道（ZenTao）测试用例 CSV」这一条链路做了调整， 并把原本写死在源码里的项目相关信息改成了可配置项。

与上游的主要差异

完整的逐文件差异见 FORK_NOTES.md。

安装

pip install xmind2testcase-lq

从源码安装：

git clone https://gitee.com/QiLi1998/xmind2testcase-lq.git
cd xmind2testcase-lq
pip install .

使用

作为库调用

from xmind2testcase_lq.zentao import xmind_to_rows, xmind_to_zentao_csv_file

# 不设置前缀：编号形如 登录功能-001
rows = xmind_to_rows("用例.xmind")

# 显式指定前缀：编号形如 我的项目-登录功能-001
rows = xmind_to_rows("用例.xmind", case_id_prefix="我的项目")

# 直接落盘成 CSV
csv_path = xmind_to_zentao_csv_file("用例.xmind", case_id_prefix="我的项目")

rows 第一行是表头，其后每行是一条用例。

通过环境变量配置

适合不想改代码、或要走命令行的情况：

# Linux / macOS
export XMIND2TESTCASE_CASE_ID_PREFIX="我的项目"

# Windows PowerShell
$env:XMIND2TESTCASE_CASE_ID_PREFIX = "我的项目"

rows = xmind_to_rows("用例.xmind")   # 自动读取上面的环境变量

命令行

xmind2testcase-lq 用例.xmind -csv
xmind2testcase-lq 用例.xmind -csv --case-id-prefix=我的项目
xmind2testcase-lq 用例.xmind              # 同时输出 json / xml / csv
xmind2testcase-lq webtool 8000            # 启动本地 Web 转换工具

配置项

全部通过环境变量控制，也可以用函数参数覆盖（参数优先级更高）。

设计原则：源码中不出现任何本机路径或具体项目名，所有环境相关信息都走配置。

已知问题

• xmind2testcase_lq.webtool 会把 running.log、uploads/、data.db3 写在包目录内（沿用上游行为）。在只读的 site-packages 或受限环境下运行 xmind2testcase-lq webtool 可能失败。命令行转换功能不受影响。

许可证与致谢

本项目基于 MIT 许可证发布，完整许可证文本见 LICENSE。

上游项目：zhuifengshen/xmind2testcase， 版权归 Devin 与 Toby Qin 所有。本分支保留了原始的 MIT 版权声明，仅在 上游 1.5.0 基础上做了上述定制改动。