xmind2testcase-lq 1.5.0.1__tar.gz

xmind2testcase_lq-1.5.0.1/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2019 Devin https://zhangchuzhao.site
+Copyright (c) 2017 Toby Qin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

xmind2testcase_lq-1.5.0.1/PKG-INFO

@@ -0,0 +1,132 @@
+Metadata-Version: 2.4
+Name: xmind2testcase-lq
+Version: 1.5.0.1
+Summary: XMind2TestCase 的定制分支：面向禅道导入的中文测试用例转换，用例编号前缀可配置
+Author: liqin
+License-Expression: MIT
+Project-URL: Homepage, https://gitee.com/QiLi1998/xmind2testcase-lq
+Project-URL: Repository, https://gitee.com/QiLi1998/xmind2testcase-lq
+Project-URL: 上游项目, https://github.com/zhuifengshen/xmind2testcase
+Keywords: xmind,testcase,zentao,testlink,思维导图,测试用例,xmind2testcase
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Natural Language :: Chinese (Simplified)
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: xmind
+Requires-Dist: flask
+Requires-Dist: arrow
+Dynamic: license-file
+
+# xmind2testcase-lq
+
+> **这是 [xmind2testcase](https://github.com/zhuifengshen/xmind2testcase) 的定制分支（fork），不是上游官方版本。**
+> 面向「XMind 思维导图 → 禅道（ZenTao）测试用例 CSV」这一条链路做了调整，
+> 并把原本写死在源码里的项目相关信息改成了可配置项。
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+## 与上游的主要差异
+
+| 方面 | 上游 `xmind2testcase` 1.5.0 | 本分支 `xmind2testcase-lq` |
+|---|---|---|
+| 导入包名 | `xmind2testcase` | `xmind2testcase_lq` |
+| 禅道 CSV 表头 | 9 列（所属模块 / 用例标题 / …） | **10 列**（用例编号 / 用例描述 / 测试类型 / 前置条件 / 操作步骤 / 期望结果 / 通过准则 / 实际输出 / 测试结论 / 测试用例优先级） |
+| 用例编号 | 无此列 | `<前缀>-<xmind文件名>-001`，**前缀可配置** |
+| 用例编号前缀 | — | 参数 `case_id_prefix` > 环境变量 `XMIND2TESTCASE_CASE_ID_PREFIX` > 空 |
+| 测试类型 | `1` / `2`（手动 / 自动） | 中文类型：正向功能 / 反向功能 / 接口 / 性能 / 界面 / 安全性 |
+| 优先级映射 | 高 / 中 / 低 | 一级 / 二级 / 三级 / 四级 |
+| 前置条件拼接 | 用 `\n----\n` 分隔 | 直接相连（逐条去空白） |
+| 期望结果 | 只取第一条 | 支持多条，逐条编号后用换行连接 |
+| 只取行数据 | 无 | 新增 `xmind_to_rows()`，不落盘 |
+| 日志文件 | 无（或写死路径） | 环境变量 `XMIND2TESTCASE_LOG` 控制，目录自动创建 |
+| `webtool` 包位置 | 顶层包 `webtool` | 收进 `xmind2testcase_lq.webtool`，不污染全局命名空间 |
+| CLI 命令 | `xmind2testcase` | `xmind2testcase-lq` |
+
+完整的逐文件差异见 [FORK_NOTES.md](FORK_NOTES.md)。
+
+## 安装
+
+```bash
+pip install xmind2testcase-lq
+```
+
+从源码安装：
+
+```bash
+git clone https://gitee.com/QiLi1998/xmind2testcase-lq.git
+cd xmind2testcase-lq
+pip install .
+```
+
+## 使用
+
+### 作为库调用
+
+```python
+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` 第一行是表头，其后每行是一条用例。
+
+### 通过环境变量配置
+
+适合不想改代码、或要走命令行的情况：
+
+```bash
+# Linux / macOS
+export XMIND2TESTCASE_CASE_ID_PREFIX="我的项目"
+
+# Windows PowerShell
+$env:XMIND2TESTCASE_CASE_ID_PREFIX = "我的项目"
+```
+
+```python
+rows = xmind_to_rows("用例.xmind")   # 自动读取上面的环境变量
+```
+
+### 命令行
+
+```bash
+xmind2testcase-lq 用例.xmind -csv
+xmind2testcase-lq 用例.xmind -csv --case-id-prefix=我的项目
+xmind2testcase-lq 用例.xmind              # 同时输出 json / xml / csv
+xmind2testcase-lq webtool 8000            # 启动本地 Web 转换工具
+```
+
+## 配置项
+
+全部通过环境变量控制，也可以用函数参数覆盖（参数优先级更高）。
+
+| 环境变量 | 作用 | 默认值 |
+|---|---|---|
+| `XMIND2TESTCASE_CASE_ID_PREFIX` | 用例编号前缀 | 空（编号不含前缀） |
+| `XMIND2TESTCASE_LOG` | 日志文件路径，父目录不存在时自动创建 | 空（只输出到控制台） |
+| `XMIND2TESTCASE_LOG_LEVEL` | 日志级别 | `INFO` |
+
+> 设计原则：**源码中不出现任何本机路径或具体项目名**，所有环境相关信息都走配置。
+
+## 已知问题
+
+- `xmind2testcase_lq.webtool` 会把 `running.log`、`uploads/`、`data.db3`
+  写在**包目录内**（沿用上游行为）。在只读的 site-packages 或受限环境下运行
+  `xmind2testcase-lq webtool` 可能失败。命令行转换功能不受影响。
+
+## 许可证与致谢
+
+本项目基于 MIT 许可证发布，完整许可证文本见 [LICENSE](LICENSE)。
+
+上游项目：[zhuifengshen/xmind2testcase](https://github.com/zhuifengshen/xmind2testcase)，
+版权归 Devin 与 Toby Qin 所有。本分支保留了原始的 MIT 版权声明，仅在
+上游 1.5.0 基础上做了上述定制改动。

xmind2testcase_lq-1.5.0.1/README.md

@@ -0,0 +1,110 @@
+# xmind2testcase-lq
+
+> **这是 [xmind2testcase](https://github.com/zhuifengshen/xmind2testcase) 的定制分支（fork），不是上游官方版本。**
+> 面向「XMind 思维导图 → 禅道（ZenTao）测试用例 CSV」这一条链路做了调整，
+> 并把原本写死在源码里的项目相关信息改成了可配置项。
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+## 与上游的主要差异
+
+| 方面 | 上游 `xmind2testcase` 1.5.0 | 本分支 `xmind2testcase-lq` |
+|---|---|---|
+| 导入包名 | `xmind2testcase` | `xmind2testcase_lq` |
+| 禅道 CSV 表头 | 9 列（所属模块 / 用例标题 / …） | **10 列**（用例编号 / 用例描述 / 测试类型 / 前置条件 / 操作步骤 / 期望结果 / 通过准则 / 实际输出 / 测试结论 / 测试用例优先级） |
+| 用例编号 | 无此列 | `<前缀>-<xmind文件名>-001`，**前缀可配置** |
+| 用例编号前缀 | — | 参数 `case_id_prefix` > 环境变量 `XMIND2TESTCASE_CASE_ID_PREFIX` > 空 |
+| 测试类型 | `1` / `2`（手动 / 自动） | 中文类型：正向功能 / 反向功能 / 接口 / 性能 / 界面 / 安全性 |
+| 优先级映射 | 高 / 中 / 低 | 一级 / 二级 / 三级 / 四级 |
+| 前置条件拼接 | 用 `\n----\n` 分隔 | 直接相连（逐条去空白） |
+| 期望结果 | 只取第一条 | 支持多条，逐条编号后用换行连接 |
+| 只取行数据 | 无 | 新增 `xmind_to_rows()`，不落盘 |
+| 日志文件 | 无（或写死路径） | 环境变量 `XMIND2TESTCASE_LOG` 控制，目录自动创建 |
+| `webtool` 包位置 | 顶层包 `webtool` | 收进 `xmind2testcase_lq.webtool`，不污染全局命名空间 |
+| CLI 命令 | `xmind2testcase` | `xmind2testcase-lq` |
+
+完整的逐文件差异见 [FORK_NOTES.md](FORK_NOTES.md)。
+
+## 安装
+
+```bash
+pip install xmind2testcase-lq
+```
+
+从源码安装：
+
+```bash
+git clone https://gitee.com/QiLi1998/xmind2testcase-lq.git
+cd xmind2testcase-lq
+pip install .
+```
+
+## 使用
+
+### 作为库调用
+
+```python
+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` 第一行是表头，其后每行是一条用例。
+
+### 通过环境变量配置
+
+适合不想改代码、或要走命令行的情况：
+
+```bash
+# Linux / macOS
+export XMIND2TESTCASE_CASE_ID_PREFIX="我的项目"
+
+# Windows PowerShell
+$env:XMIND2TESTCASE_CASE_ID_PREFIX = "我的项目"
+```
+
+```python
+rows = xmind_to_rows("用例.xmind")   # 自动读取上面的环境变量
+```
+
+### 命令行
+
+```bash
+xmind2testcase-lq 用例.xmind -csv
+xmind2testcase-lq 用例.xmind -csv --case-id-prefix=我的项目
+xmind2testcase-lq 用例.xmind              # 同时输出 json / xml / csv
+xmind2testcase-lq webtool 8000            # 启动本地 Web 转换工具
+```
+
+## 配置项
+
+全部通过环境变量控制，也可以用函数参数覆盖（参数优先级更高）。
+
+| 环境变量 | 作用 | 默认值 |
+|---|---|---|
+| `XMIND2TESTCASE_CASE_ID_PREFIX` | 用例编号前缀 | 空（编号不含前缀） |
+| `XMIND2TESTCASE_LOG` | 日志文件路径，父目录不存在时自动创建 | 空（只输出到控制台） |
+| `XMIND2TESTCASE_LOG_LEVEL` | 日志级别 | `INFO` |
+
+> 设计原则：**源码中不出现任何本机路径或具体项目名**，所有环境相关信息都走配置。
+
+## 已知问题
+
+- `xmind2testcase_lq.webtool` 会把 `running.log`、`uploads/`、`data.db3`
+  写在**包目录内**（沿用上游行为）。在只读的 site-packages 或受限环境下运行
+  `xmind2testcase-lq webtool` 可能失败。命令行转换功能不受影响。
+
+## 许可证与致谢
+
+本项目基于 MIT 许可证发布，完整许可证文本见 [LICENSE](LICENSE)。
+
+上游项目：[zhuifengshen/xmind2testcase](https://github.com/zhuifengshen/xmind2testcase)，
+版权归 Devin 与 Toby Qin 所有。本分支保留了原始的 MIT 版权声明，仅在
+上游 1.5.0 基础上做了上述定制改动。

xmind2testcase_lq-1.5.0.1/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["setuptools>=77", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "xmind2testcase-lq"
+dynamic = ["version"]
+description = "XMind2TestCase 的定制分支：面向禅道导入的中文测试用例转换，用例编号前缀可配置"
+readme = "README.md"
+requires-python = ">=3.8"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "liqin" }]
+keywords = ["xmind", "testcase", "zentao", "testlink", "思维导图", "测试用例", "xmind2testcase"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+    "Natural Language :: Chinese (Simplified)",
+    "Topic :: Software Development :: Testing",
+]
+dependencies = [
+    "xmind",
+    "flask",
+    "arrow",
+]
+
+[project.urls]
+Homepage = "https://gitee.com/QiLi1998/xmind2testcase-lq"
+Repository = "https://gitee.com/QiLi1998/xmind2testcase-lq"
+"上游项目" = "https://github.com/zhuifengshen/xmind2testcase"
+
+[project.scripts]
+xmind2testcase-lq = "xmind2testcase_lq.cli:cli_main"
+
+[tool.setuptools.dynamic]
+version = { attr = "xmind2testcase_lq.__about__.__version__" }
+
+[tool.setuptools.packages.find]
+include = ["xmind2testcase_lq*"]
+
+[tool.setuptools.package-data]
+"xmind2testcase_lq.webtool" = ["schema.sql", "templates/*", "static/css/*", "static/guide/*"]

xmind2testcase_lq-1.5.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

xmind2testcase_lq-1.5.0.1/xmind2testcase_lq/__about__.py

@@ -0,0 +1,15 @@
+__title__ = 'xmind2testcase-lq'
+__description__ = 'XMind2TestCase 的定制分支：面向禅道导入的中文测试用例转换，用例编号前缀可配置'
+__keywords__ = 'xmind, testcase, zentao, testlink, 思维导图, 测试用例, xmind2testcase'
+__url__ = 'https://gitee.com/QiLi1998/xmind2testcase-lq'
+__author__ = 'liqin'
+__author_email__ = ''
+__version__ = '1.5.0.1'
+__license__ = 'MIT'
+__cake__ = u'\u2728 \U0001f370 \u2728'
+
+# 上游溯源信息（MIT 许可证要求保留原始版权声明，见 LICENSE）
+__upstream_title__ = 'xmind2testcase'
+__upstream_version__ = '1.5.0'
+__upstream_url__ = 'https://github.com/zhuifengshen/xmind2testcase'
+__upstream_author__ = 'Devin'

xmind2testcase_lq-1.5.0.1/xmind2testcase_lq/cli.py

@@ -0,0 +1,117 @@
+#!/usr/bin/env python
+# _*_ coding:utf-8 _*_
+"""命令行入口。
+
+与上游的差异
+------------
+* 日志文件路径改为由环境变量 ``XMIND2TESTCASE_LOG`` 控制（见
+  :mod:`xmind2testcase_lq.config`），**不再写死本机绝对路径**；
+  未设置时只输出到控制台。
+* ``webtool`` 改为**延迟导入**。上游在模块顶层就 ``import webtool``，
+  而 ``webtool.application`` 在导入时会自行配置 root logger，
+  导致紧随其后的 ``logging.basicConfig`` 永远被跳过（哑配置）。
+  改为延迟导入后日志配置才真正生效，同时让不依赖 Flask 的场景可以更轻量地导入本模块。
+* 新增 ``--case-id-prefix=XXX`` 选项，等价于设置
+  ``XMIND2TESTCASE_CASE_ID_PREFIX``。
+"""
+import logging
+import sys
+from pathlib import Path
+
+from xmind2testcase_lq import config
+from xmind2testcase_lq.testlink import xmind_to_testlink_xml_file
+from xmind2testcase_lq.utils import get_absolute_path, xmind_testcase_to_json_file
+from xmind2testcase_lq.zentao import xmind_to_zentao_csv_file
+
+_log_file = config.resolve_log_file()
+if _log_file:
+    Path(_log_file).parent.mkdir(parents=True, exist_ok=True)
+    logging.basicConfig(
+        level=config.resolve_log_level(),
+        filename=_log_file,
+        filemode='a',
+        format=config.LOG_FORMAT,
+        datefmt=config.LOG_DATE_FORMAT,
+        force=True,
+    )
+
+using_doc = """
+    Xmind2Testcase is a tool to parse xmind file into testcase file, which will help you generate a testlink recognized
+    xml file or a zentao recognized cvs file, then you can import it into testlink or zentao.
+
+    Usage:
+     xmind2testcase-lq [path_to_xmind_file] [-csv] [-xml] [-json]
+     xmind2testcase-lq [webtool] [port_num]
+
+    Example:
+     xmind2testcase-lq /path/to/testcase.xmind        => output testcase.csv、testcase.xml、testcase.json
+     xmind2testcase-lq /path/to/testcase.xmind -csv   => output testcase.csv
+     xmind2testcase-lq /path/to/testcase.xmind -xml   => output testcase.xml
+     xmind2testcase-lq /path/to/testcase.xmind -json  => output testcase.json
+     xmind2testcase-lq webtool                        => launch the web testcase conversion tool locally: 127.0.0.1:5001
+     xmind2testcase-lq webtool 8000                   => launch the web testcase conversion tool locally: 127.0.0.1:8000
+
+    Options:
+     --case-id-prefix=<前缀>   用例编号前缀，例如 --case-id-prefix=我的项目
+                              等价于设置环境变量 XMIND2TESTCASE_CASE_ID_PREFIX
+    """
+
+
+def _pop_case_id_prefix(argv):
+    """从 argv 中摘出 --case-id-prefix=XXX，返回 (剩余参数, 前缀或 None)"""
+    rest, prefix = [], None
+    for arg in argv:
+        if arg.startswith('--case-id-prefix='):
+            prefix = arg.split('=', 1)[1]
+        else:
+            rest.append(arg)
+    return rest, prefix
+
+
+def cli_main():
+    argv, case_id_prefix = _pop_case_id_prefix(sys.argv)
+    prefix = config.resolve_case_id_prefix(case_id_prefix)
+
+    if len(argv) > 1 and argv[1].endswith('.xmind'):
+        xmind_file = get_absolute_path(argv[1])
+        logging.info('Start to convert XMind file: %s', xmind_file)
+
+        if len(argv) == 3 and argv[2] == '-json':
+            testlink_json_file = xmind_testcase_to_json_file(xmind_file)
+            logging.info('Convert XMind file to testcase json file successfully: %s', testlink_json_file)
+        elif len(argv) == 3 and argv[2] == '-xml':
+            testlink_xml_file = xmind_to_testlink_xml_file(xmind_file)
+            logging.info('Convert XMind file to testlink xml files successfully: %s', testlink_xml_file)
+        elif len(argv) == 3 and argv[2] == '-csv':
+            zentao_csv_file = xmind_to_zentao_csv_file(xmind_file, case_id_prefix=prefix)
+            logging.info('Convert XMind file to zentao csv file successfully: %s', zentao_csv_file)
+        else:
+            testlink_json_file = xmind_testcase_to_json_file(xmind_file)
+            testlink_xml_file = xmind_to_testlink_xml_file(xmind_file)
+            zentao_csv_file = xmind_to_zentao_csv_file(xmind_file, case_id_prefix=prefix)
+            logging.info('Convert XMind file successfully: \n'
+                         '1、 testcase json file(%s)\n'
+                         '2、 testlink xml file(%s)\n'
+                         '3、 zentao csv file(%s)',
+                         testlink_json_file,
+                         testlink_xml_file,
+                         zentao_csv_file)
+    elif len(argv) > 1 and argv[1] == 'webtool':
+        # 延迟导入：避免只用命令行转换功能时也拉起 Flask 及其日志配置
+        from xmind2testcase_lq.webtool.application import launch
+
+        if len(argv) == 3:
+            try:
+                port = int(argv[2])
+                launch(port=port)
+            except ValueError:
+                launch()
+        else:
+            launch()
+
+    else:
+        print(using_doc)
+
+
+if __name__ == '__main__':
+    cli_main()

xmind2testcase_lq-1.5.0.1/xmind2testcase_lq/config.py

@@ -0,0 +1,80 @@
+"""xmind2testcase_lq 的定制项集中配置。
+
+为什么需要这个模块
+------------------
+上游代码把两处**与具体环境绑定**的值直接写死在源码里，公开发布会有问题：
+
+* ``zentao.py`` 把用例编号前缀写死成某个内网项目名 —— 一旦发布到公共源，
+  这个名称就永久公开且无法撤回；
+* ``cli.py`` 把日志文件写死成本机绝对路径（``D:/...``）—— 换一台机器就不成立。
+
+本模块把这些值集中到一处，按 **显式参数 > 环境变量 > 通用默认值** 的顺序解析，
+源码中不再出现任何本机路径或内网业务信息。
+
+环境变量
+--------
+``XMIND2TESTCASE_CASE_ID_PREFIX``
+    用例编号前缀，默认空串。
+    设置后编号形如 ``<前缀>-<xmind文件名>-001``；未设置时形如 ``<xmind文件名>-001``。
+``XMIND2TESTCASE_LOG``
+    CLI 日志文件路径，默认空串（不写文件，只输出到控制台）。父目录不存在时自动创建。
+``XMIND2TESTCASE_LOG_LEVEL``
+    日志级别，默认 ``INFO``。
+
+用法
+----
+::
+
+    import os
+    os.environ["XMIND2TESTCASE_CASE_ID_PREFIX"] = "我的项目"
+    from xmind2testcase_lq.zentao import xmind_to_rows
+    rows = xmind_to_rows("用例.xmind")
+
+也可以绕开环境变量，直接传参（优先级更高）::
+
+    rows = xmind_to_rows("用例.xmind", case_id_prefix="我的项目")
+"""
+from __future__ import annotations
+
+import logging
+import os
+from typing import Optional
+
+ENV_CASE_ID_PREFIX = "XMIND2TESTCASE_CASE_ID_PREFIX"
+ENV_LOG_FILE = "XMIND2TESTCASE_LOG"
+ENV_LOG_LEVEL = "XMIND2TESTCASE_LOG_LEVEL"
+
+# 内置默认值：保持通用，不含任何业务信息
+DEFAULT_CASE_ID_PREFIX = ""
+DEFAULT_LOG_LEVEL = "INFO"
+
+# 与上游一致的日志格式
+LOG_FORMAT = "%(asctime)s  %(name)s  %(levelname)s  [%(module)s - %(funcName)s]: %(message)s"
+LOG_DATE_FORMAT = "%Y/%m/%d %H:%M:%S"
+
+
+def resolve_case_id_prefix(explicit: Optional[str] = None) -> str:
+    """解析用例编号前缀。显式参数 > 环境变量 > 空串。"""
+    if explicit is not None:
+        return explicit.strip()
+    return os.environ.get(ENV_CASE_ID_PREFIX, DEFAULT_CASE_ID_PREFIX).strip()
+
+
+def resolve_log_file(explicit: Optional[str] = None) -> str:
+    """解析日志文件路径。返回空串表示不写文件。"""
+    if explicit is not None:
+        return explicit.strip()
+    return os.environ.get(ENV_LOG_FILE, "").strip()
+
+
+def resolve_log_level(explicit: Optional[str] = None) -> int:
+    """解析日志级别，返回 ``logging`` 模块的整型常量；无法识别时回退 INFO。"""
+    raw = explicit if explicit is not None else os.environ.get(ENV_LOG_LEVEL, DEFAULT_LOG_LEVEL)
+    name = (raw or DEFAULT_LOG_LEVEL).strip().upper()
+    return getattr(logging, name, logging.INFO)
+
+
+def build_case_id(prefix: str, xmind_filename: str, case_index: int) -> str:
+    """拼装用例编号：``<前缀>-<xmind文件名>-<三位序号>``，前缀为空时自动省略。"""
+    parts = [p for p in (prefix.strip(), xmind_filename.strip(), f"{case_index:03d}") if p]
+    return "-".join(parts)

xmind2testcase_lq-1.5.0.1/xmind2testcase_lq/const.py

@@ -0,0 +1,28 @@
+#!/usr/bin/env python
+# _*_ coding:utf-8 _*_
+
+
+TAG_XML = 'xml'
+
+TAG_TESTSUITE = 'testsuite'
+TAG_DETAILS = 'details'
+
+TAG_TESTCASE = 'testcase'
+TAG_VERSION = 'version'
+TAG_SUMMARY = 'summary'
+TAG_PRECONDITIONS = 'preconditions'
+TAG_IMPORTANCE = 'importance'
+TAG_ESTIMATED_EXEC_DURATION = 'estimated_exec_duration'
+TAG_STATUS = 'status'
+TAG_IS_OPEN = 'is_open'
+TAG_ACTIVE = 'active'
+TAG_STEPS = 'steps'
+TAG_STEP = 'step'
+TAG_STEP_NUMBER = 'step_number'
+TAG_ACTIONS = 'actions'
+TAG_EXPECTEDRESULTS = 'expectedresults'
+TAG_EXECUTION_TYPE = 'execution_type'
+
+ATTR_NMAE = 'name'
+ATTR_ID = 'id'
+ATTR_INTERNALID = 'internalid'

xmind2testcase_lq-1.5.0.1/xmind2testcase_lq/metadata.py

@@ -0,0 +1,123 @@
+#!/usr/bin/env python
+# _*_ coding:utf-8 _*_
+
+"""
+testlink.testlink
+"""
+
+
+class TestSuite(object):
+
+    def __init__(self, name='', details='', testcase_list=None, sub_suites=None, statistics=None):
+        """
+        TestSuite
+        :param name: test suite name
+        :param details: test suite detail infomation
+        :param testcase_list: test case list
+        :param sub_suites: sub test suite list
+        :param statistics: testsuite statistics info {'case_num': 0, 'non_execution': 0, 'pass': 0, 'failed': 0, 'blocked': 0, 'skipped': 0}
+        """
+        self.name = name
+        self.details = details
+        self.testcase_list = testcase_list
+        self.sub_suites = sub_suites
+        self.statistics = statistics
+
+    def to_dict(self):
+        data = {
+            'name': self.name,
+            'details': self.details,
+            'testcase_list': [],
+            'sub_suites': []
+        }
+
+        if self.sub_suites:
+            for suite in self.sub_suites:
+                data['sub_suites'].append(suite.to_dict())
+
+        if self.testcase_list:
+            for case in self.testcase_list:
+                data['testcase_list'].append(case.to_dict())
+
+        if self.statistics:
+            data['statistics'] = self.statistics
+
+        return data
+
+
+class TestCase(object):
+
+    def __init__(self, name='', version=1, summary='', preconditions='', execution_type=1, importance=2, estimated_exec_duration=3, status=7, result=0, steps=None):
+        """
+        TestCase
+        :param name: test case name
+        :param version: test case version infomation
+        :param summary: test case summary infomation
+        :param preconditions: test case pre condition
+        :param execution_type: manual:1 or automate:2
+        :param importance: high:1, middle:2, low:3
+        :param estimated_exec_duration: estimated execution duration
+        :param status: draft:1, ready ro review:2, review in progress:3, rework:4, obsolete:5, future:6, final:7
+        :param result: non-execution:0, pass:1, failed:2, blocked:3, skipped:4
+        :param steps: test case step list
+        """
+        self.name = name
+        self.version = version
+        self.summary = summary
+        self.preconditions = preconditions
+        self.execution_type = execution_type
+        self.importance = importance
+        self.estimated_exec_duration = estimated_exec_duration
+        self.status = status
+        self.result = result
+        self.steps = steps
+
+    def to_dict(self):
+        data = {
+            'name': self.name,
+            'version': self.version,  # TODO(devin): get version content
+            'summary': self.summary,
+            'preconditions': self.preconditions,
+            'execution_type': self.execution_type,
+            'importance': self.importance,
+            'estimated_exec_duration': self.estimated_exec_duration,  # TODO(devin): get estimated content
+            'status': self.status,  # TODO(devin): get status content
+            'result': self.result,
+            'steps': []
+        }
+
+        if self.steps:
+            for step in self.steps:
+                data['steps'].append(step.to_dict())
+
+        return data
+
+
+class TestStep(object):
+
+    def __init__(self, step_number=1, actions='', expectedresults='', execution_type=1, result=0):
+        """
+        TestStep
+        :param step_number: test step number
+        :param actions: test step actions
+        :param expectedresults: test step expected results
+        :param execution_type: test step execution type
+        :param result: non-execution:0, pass:1, failed:2, blocked:3, skipped:4
+        """
+        self.step_number = step_number
+        self.actions = actions
+        self.expectedresults = expectedresults
+        self.execution_type = execution_type  # TODO(devin): get execution type content
+        self.result = result
+
+    def to_dict(self):
+        data = {
+            'step_number': self.step_number,
+            'actions': self.actions,
+            'expectedresults': self.expectedresults,
+            'execution_type': self.execution_type,
+            'result': self.result
+        }
+
+        return data
+