dsh-flakefinder 0.1.0 → 0.2.0

package/README.en.md

@@ -18,7 +18,7 @@ A DeepSeek Harness plugin for test stability: run tests repeatedly, classify fla
 | `flaky_quarantine` | Write flaky cases to `.flakefinder.json` | yes (approval) |
 | `flaky_clear` | Remove recovered cases from the manifest | yes (approval) |
 
-Frameworks: vitest / jest / node:test, auto-detected in that order.
+Frameworks: vitest / jest / pytest / node:test, auto-detected in that order.
 
 ## Install
 
@@ -38,7 +38,7 @@ Agent:
 
 ## Config
 
-See `cordis.patch.yml`; defaults: `defaultRuns=5`, `maxRuns=20`, `timeoutMs=120000`, `writeApproval=true`.
+See `cordis.patch.yml`; defaults: `defaultRuns=5`, `maxRuns=20`, `timeoutMs=120000`, `writeApproval=true`, `pythonPath=python` (`python3` on Linux/macOS; used for pytest runs).
 
 ## Development
 

package/README.md

@@ -2,7 +2,7 @@
 
 > 让 agent 分清「代码坏了」还是「测试在抽风」。
 
-DeepSeek Harness 测试稳定性插件：重复运行测试并识别 flaky 用例，历史留档、隔离清单、写操作审批门。零运行时依赖。
+DeepSeek Harness 测试稳定性插件：支持 vitest / jest / pytest / node:test，重复运行测试并识别 flaky 用例，历史留档、隔离清单、写操作审批门。零运行时依赖。
 
 ![license](https://img.shields.io/npm/l/dsh-flakefinder) ![stars](https://img.shields.io/github/stars/STARDUSTLC666/dsh-flakefinder?style=social)
 
@@ -22,8 +22,9 @@ DeepSeek Harness 测试稳定性插件：重复运行测试并识别 flaky 用
 
 - vitest：读取 `node_modules/vitest/vitest.mjs`，使用 JSON reporter
 - jest：读取 `node_modules/jest/bin/jest.js`，使用 `--json --outputFile`
+- pytest：`python -m pytest --junitxml`，解析 JUnit XML（内置能力，无需 pytest 插件）
 - node:test：`node --test --test-reporter=tap`，解析 TAP
-- `framework: auto` 按 vitest → jest → node:test 自动探测
+- `framework: auto` 按 vitest → jest → pytest → node:test 自动探测
 
 ## 安装
 
@@ -62,6 +63,7 @@ Agent：
 | `writeApproval` | `true` | 隔离清单写操作是否走审批门 |
 | `dataDir` | `DSH_HOME/.dsh-flakefinder` | 历史存储目录 |
 | `quarantineFile` | `<cwd>/.flakefinder.json` | 隔离清单路径 |
+| `pythonPath` | `DSH_FLAKEFINDER_PYTHON` 或 `python`/`python3` | pytest 使用的 Python 解释器 |
 
 ## 隔离清单格式
 
@@ -85,7 +87,7 @@ Agent：
 
 - Node >= 22.13，TypeScript，零运行时依赖
 - 测试进程走 DSH 官方 subprocess 服务，argv 数组、无 shell
-- 全量单测 30+：解析、判定、存储、审批门、注册与 manifest
+- 全量单测 35+：解析、判定、存储、审批门、pytest 计划、注册与 manifest
 - `pnpm test`：构建 + `node --test`
 
 ## 发布门禁

package/cordis.patch.yml

@@ -10,6 +10,7 @@
 #       writeApproval: true     # quarantine/clear 是否走审批门（默认 true）
 #       dataDir: ''             # 历史存储目录（默认 DSH_HOME/.dsh-flakefinder）
 #       quarantineFile: ''      # 隔离清单（默认项目根 .flakefinder.json）
+      pythonPath: ''          # pytest 使用的 Python 解释器（默认 python/python3）
 #
 - insert:
     - id: flakefinder

package/lib/args.d.ts

@@ -4,8 +4,8 @@
  *
  * @module dsh-flakefinder/args
  */
-export type Framework = 'auto' | 'vitest' | 'jest' | 'node';
-export type ReportKind = 'json' | 'tap';
+export type Framework = 'auto' | 'vitest' | 'jest' | 'pytest' | 'node';
+export type ReportKind = 'json' | 'tap' | 'junit';
 export interface TestPlan {
     framework: Exclude<Framework, 'auto'>;
     reportKind: ReportKind;
@@ -18,4 +18,4 @@ export declare function readFramework(raw: unknown): Framework;
 /** 在 cwd 里探测本地框架 CLI 入口；显式指定时缺失会给出中文指引。 */
 export declare function detectFramework(cwd: string, requested: Framework): Exclude<Framework, 'auto'>;
 /** 构建一次测试运行的执行计划。runIndex 仅用于给临时报告文件命名。 */
-export declare function buildPlan(cwd: string, target: string, requested: Framework, runIndex: number): TestPlan;
+export declare function buildPlan(cwd: string, target: string, requested: Framework, runIndex: number, pythonPath?: string): TestPlan;

package/lib/args.js

@@ -13,14 +13,27 @@ import { assertTarget } from './config.js';
 export function readFramework(raw) {
     if (raw === undefined || raw === null)
         return 'auto';
-    if (raw === 'auto' || raw === 'vitest' || raw === 'jest' || raw === 'node')
+    if (raw === 'auto' || raw === 'vitest' || raw === 'jest' || raw === 'pytest' || raw === 'node')
         return raw;
-    throw new Error('framework 只支持 auto / vitest / jest / node，收到：' + String(raw));
+    throw new Error('framework 只支持 auto / vitest / jest / pytest / node，收到：' + String(raw));
 }
 function localEntry(cwd, ...parts) {
     const full = path.join(cwd, ...parts);
     return fs.existsSync(full) ? full : null;
 }
+function hasPytestConfig(cwd) {
+    if (fs.existsSync(path.join(cwd, 'pytest.ini')) || fs.existsSync(path.join(cwd, 'tox.ini')))
+        return true;
+    const pyproject = path.join(cwd, 'pyproject.toml');
+    if (!fs.existsSync(pyproject))
+        return false;
+    try {
+        return /\[tool\.pytest(\.ini_options)?\]/.test(fs.readFileSync(pyproject, 'utf8'));
+    }
+    catch {
+        return false;
+    }
+}
 /** 在 cwd 里探测本地框架 CLI 入口；显式指定时缺失会给出中文指引。 */
 export function detectFramework(cwd, requested) {
     const vitest = localEntry(cwd, 'node_modules', 'vitest', 'vitest.mjs');
@@ -38,10 +51,12 @@ export function detectFramework(cwd, requested) {
         return 'vitest';
     if (jest !== null)
         return 'jest';
+    if (hasPytestConfig(cwd))
+        return 'pytest';
     return 'node';
 }
 /** 构建一次测试运行的执行计划。runIndex 仅用于给临时报告文件命名。 */
-export function buildPlan(cwd, target, requested, runIndex) {
+export function buildPlan(cwd, target, requested, runIndex, pythonPath = 'python') {
     const safeTarget = assertTarget(target);
     const framework = detectFramework(cwd, requested);
     const token = crypto.randomBytes(6).toString('hex');
@@ -71,6 +86,16 @@ export function buildPlan(cwd, target, requested, runIndex) {
             label: 'jest run ' + safeTarget,
         };
     }
+    if (framework === 'pytest') {
+        const reportPath = path.join(os.tmpdir(), 'dsh-flakefinder-pytest-' + process.pid + '-' + String(runIndex) + '-' + token + '.xml');
+        return {
+            framework,
+            reportKind: 'junit',
+            reportPath,
+            argv: [pythonPath, '-m', 'pytest', safeTarget, '-q', '--junitxml=' + reportPath],
+            label: 'pytest ' + safeTarget,
+        };
+    }
     return {
         framework: 'node',
         reportKind: 'tap',

package/lib/config.d.ts

@@ -19,6 +19,8 @@ export interface FlakeConfig {
     dataDir?: string;
     /** 项目隔离清单路径（默认 cwd/.flakefinder.json）。 */
     quarantineFile?: string;
+    /** Python 解释器命令（pytest 框架使用，默认 DSH_FLAKEFINDER_PYTHON 或 python/python3）。 */
+    pythonPath?: string;
 }
 /** 解析后的配置。 */
 export interface ResolvedFlakeConfig {
@@ -29,6 +31,7 @@ export interface ResolvedFlakeConfig {
     writeApproval: boolean;
     dataDir: string;
     quarantineFile: string;
+    pythonPath: string;
 }
 /** 解析并校验配置，非法值抛出中文错误。 */
 export declare function resolveConfig(config: FlakeConfig | undefined | null, cwd?: string): ResolvedFlakeConfig;

package/lib/config.js

@@ -46,7 +46,10 @@ export function resolveConfig(config, cwd = process.cwd()) {
     const quarantineFile = typeof cfg.quarantineFile === 'string' && cfg.quarantineFile.trim() !== ''
         ? path.resolve(cwd, cfg.quarantineFile.trim())
         : path.join(cwd, '.flakefinder.json');
-    return { defaultRuns, maxRuns, timeoutMs, graceMs, writeApproval, dataDir, quarantineFile };
+    const pythonPath = typeof cfg.pythonPath === 'string' && cfg.pythonPath.trim() !== ''
+        ? cfg.pythonPath.trim()
+        : (process.env.DSH_FLAKEFINDER_PYTHON?.trim() || (process.platform === 'win32' ? 'python' : 'python3'));
+    return { defaultRuns, maxRuns, timeoutMs, graceMs, writeApproval, dataDir, quarantineFile, pythonPath };
 }
 function readRuns(label, value, lo, hi) {
     if (typeof value !== 'number' || !Number.isFinite(value))

package/lib/parse.d.ts

@@ -23,5 +23,7 @@ export interface NormalizedRun {
 }
 /** vitest 与 jest 的 JSON 结构高度接近，这里统一读取。 */
 export declare function parseJsonReport(text: string, framework: string): NormalizedRun;
+/** 解析 pytest 的 JUnit XML 报告。 */
+export declare function parseJunitReport(text: string): NormalizedRun;
 /** 解析 node:test 的 TAP 输出；子测试行忽略，只保留顶层用例。 */
 export declare function parseTapReport(text: string): NormalizedRun;

package/lib/parse.js

@@ -72,6 +72,33 @@ function reportedCount(reported, fallback) {
         return Math.round(reported);
     return fallback;
 }
+function attrOf(tag, name) {
+    const m = new RegExp(name + '="([^"]*)"').exec(tag);
+    return m === null ? '' : m[1];
+}
+/** 解析 pytest 的 JUnit XML 报告。 */
+export function parseJunitReport(text) {
+    const tests = [];
+    const block = /<testcase\b([^>]*)>([\s\S]*?)<\/testcase\s*>/gi;
+    const single = /<testcase\b([^>]*)\/>/gi;
+    for (const m of text.matchAll(block)) {
+        const tag = m[1];
+        const body = m[2];
+        const classname = attrOf(tag, 'classname') || '(pytest)';
+        const name = attrOf(tag, 'name') || '(unnamed)';
+        const status = /<(?:failure|error)\b/.test(body) ? 'failed' : /<skipped\b/.test(body) ? 'skipped' : 'passed';
+        tests.push({ id: classname + ' > ' + name, file: classname, name, status, durationMs: Math.max(0, Number(attrOf(tag, 'time')) || 0) });
+    }
+    for (const m of text.matchAll(single)) {
+        const tag = m[1];
+        const classname = attrOf(tag, 'classname') || '(pytest)';
+        const name = attrOf(tag, 'name') || '(unnamed)';
+        tests.push({ id: classname + ' > ' + name, file: classname, name, status: 'passed', durationMs: Math.max(0, Number(attrOf(tag, 'time')) || 0) });
+    }
+    const failed = tests.filter(item => item.status === 'failed').length;
+    const skipped = tests.filter(item => item.status === 'skipped').length;
+    return { framework: 'pytest', success: failed === 0, total: tests.length, passed: tests.length - failed - skipped, failed, skipped, tests };
+}
 /** 解析 node:test 的 TAP 输出；子测试行忽略，只保留顶层用例。 */
 export function parseTapReport(text) {
     const tests = [];

package/lib/runner.js

@@ -4,7 +4,7 @@
  * @module dsh-flakefinder/runner
  */
 import fs from 'node:fs/promises';
-import { parseJsonReport, parseTapReport } from './parse.js';
+import { parseJsonReport, parseJunitReport, parseTapReport } from './parse.js';
 const COLLECT_BYTES = 4 * 1024 * 1024;
 /** 用 DSH subprocess 服务构造 ProcessRunner。 */
 export function createSubprocessRunner(spawn, graceMs, defaultTimeoutMs) {
@@ -73,13 +73,13 @@ export async function executePlan(runner, plan, index, timeoutMs) {
             durationMs,
             exitCode: result.exitCode,
             stderr: result.stderr,
-            error: plan.framework + ' 没有写出 JSON 报告（' + fileError + '）。进程退出码：' + String(result.exitCode ?? 'null') + '；stderr：' + stderrTail(result.stderr),
+            error: plan.framework + ' 没有写出报告文件（' + fileError + '）。进程退出码：' + String(result.exitCode ?? 'null') + '；stderr：' + stderrTail(result.stderr),
         };
     }
     try {
         return {
             index,
-            report: parseJsonReport(fileText, plan.framework),
+            report: plan.reportKind === 'junit' ? parseJunitReport(fileText) : parseJsonReport(fileText, plan.framework),
             durationMs,
             exitCode: result.exitCode,
             stderr: result.stderr,

package/lib/tools.js

@@ -104,10 +104,10 @@ const detectSchema = {
 export function buildFlakeTools(cfg, runner, store) {
     const detect = {
         name: 'flaky_detect',
-        description: '重复运行测试多次并判定稳定性：stable-pass（全过）/ stable-fail（全挂）/ flaky（时好时坏）。支持 vitest / jest / node:test，自动探测本地框架。结果写入历史供 flaky_report 分析。',
+        description: '重复运行测试多次并判定稳定性：stable-pass（全过）/ stable-fail（全挂）/ flaky（时好时坏）。支持 vitest / jest / pytest / node:test，自动探测本地框架。结果写入历史供 flaky_report 分析。',
         parameters: compileParameters({
             target: { type: 'string', required: true, description: '测试文件、目录或 glob（相对当前工作区）。不能以 - 开头。' },
-            framework: { type: 'string', description: 'auto（默认，自动探测 vitest→jest→node:test）/ vitest / jest / node。' },
+            framework: { type: 'string', description: 'auto（默认，自动探测 vitest→jest→pytest→node:test）/ vitest / jest / pytest / node。' },
             runs: { type: 'integer', description: '重复次数，默认取配置 defaultRuns。' },
         }),
         output: {
@@ -123,7 +123,7 @@ export function buildFlakeTools(cfg, runner, store) {
             const target = assertTarget(requiredString(args, 'target', '测试目标'));
             const requested = readFramework(args.framework);
             const runs = resolveRuns(args.runs, cfg);
-            const plans = Array.from({ length: runs }, (_, index) => buildPlan(process.cwd(), target, requested, index));
+            const plans = Array.from({ length: runs }, (_, index) => buildPlan(process.cwd(), target, requested, index, cfg.pythonPath));
             const framework = plans[0]?.framework ?? 'node';
             const executed = [];
             for (let index = 0; index < plans.length; index += 1) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-flakefinder",
-  "version": "0.1.0",
-  "description": "DSH 测试稳定性插件：flaky_detect/history/quarantine/clear/report 五工具，重复运行测试并识别不稳定用例，SQLite-free JSON 历史与隔离清单，零运行时依赖。",
+  "version": "0.2.0",
+  "description": "DSH 测试稳定性插件：flaky_detect/history/quarantine/clear/report 五工具，支持 vitest/jest/pytest/node:test，重复运行测试并识别不稳定用例，JSON 历史与隔离清单，零运行时依赖。",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -37,7 +37,8 @@
     "plugin",
     "testing",
     "flaky-test",
-    "quality"
+    "quality",
+    "dsh-plugin"
   ],
   "license": "MIT",
   "engines": {