xcodebuild-axi 0.1.9 → 0.1.11

package/dist/src/xccov.js

@@ -1,4 +1,7 @@
 import { execFile } from "node:child_process";
+import { existsSync, mkdtempSync, readdirSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
 import { AxiError } from "./errors.js";
 /**
  * Code coverage, read out of a result bundle with `xccov`.
@@ -18,15 +21,30 @@ function xccov(args) {
                     rejectPromise(new AxiError("That result bundle carries no coverage data", "RESULT_NOT_FOUND", ["Re-run the tests with `xcodebuild-axi test --coverage`"]));
                     return;
                 }
-                rejectPromise(new AxiError(firstLine(stderr) || "xccov failed", "RESULT_NOT_FOUND"));
+                rejectPromise(new AxiError(complaint(stderr) || "xccov failed", "RESULT_NOT_FOUND"));
                 return;
             }
             resolvePromise(stdout);
         });
     });
 }
+export function coverageSource(path) {
+    if (path.endsWith(".xccovreport"))
+        return "report";
+    if (path.endsWith(".xccovarchive"))
+        return "archive";
+    return "bundle";
+}
+/** The `view` flags that select the report inside whatever this path is. */
+function reportArgs(path) {
+    return coverageSource(path) === "bundle" ? ["view", "--report"] : ["view"];
+}
+/** The `view` flags that select the archive — raw counts, not percentages. */
+function archiveArgs(path) {
+    return coverageSource(path) === "bundle" ? ["view", "--archive"] : ["view"];
+}
 export async function readCoverage(resultPath, options = {}) {
-    const stdout = await xccov(["view", "--report", "--json", resultPath]);
+    const stdout = await xccov([...reportArgs(resultPath), "--json", resultPath]);
     let parsed;
     try {
         parsed = JSON.parse(stdout);
@@ -75,4 +93,162 @@ export function percent(fraction) {
 function firstLine(text) {
     return text.trim().split("\n")[0] ?? "";
 }
+/**
+ * xccov's refusals, minus the NSError wrapping.
+ *
+ * A bad path comes back as `Error: Error Domain=XCCovErrorDomain Code=0
+ * "Failed to load result bundle" UserInfo={NSLocalizedDescription=Failed to
+ * load result bundle, NSUnderlyingError=0x… {…}}` — 400 characters around a
+ * five-word answer that is already in there.
+ */
+function complaint(stderr) {
+    const line = firstLine(stderr).replace(/^Error:\s*/, "");
+    return line.match(/NSLocalizedDescription=([^,}]+)/)?.[1]?.trim() ?? line;
+}
+/**
+ * Per-function coverage for one file.
+ *
+ * The file is matched by name or by the path it had when the report was
+ * written, so it need not exist on disk — which is the point when the report
+ * came from CI.
+ */
+export async function readFunctions(path, file) {
+    const stdout = await xccov([
+        ...reportArgs(path),
+        "--functions-for-file",
+        file,
+        "--json",
+        path,
+    ]);
+    let parsed;
+    try {
+        parsed = JSON.parse(stdout);
+    }
+    catch {
+        throw new AxiError("xccov returned output that could not be read", "RESULT_NOT_FOUND");
+    }
+    return parsed.map((entry) => ({
+        file: entry.file ?? file,
+        functions: (entry.functions ?? []).map((fn) => ({
+            name: fn.name ?? "unknown",
+            lineNumber: fn.lineNumber ?? 0,
+            executionCount: fn.executionCount ?? 0,
+            lineCoverage: fn.lineCoverage ?? 0,
+            coveredLines: fn.coveredLines ?? 0,
+            executableLines: fn.executableLines ?? 0,
+        })),
+    }));
+}
+/**
+ * Per-line execution counts for one file, out of the archive rather than the
+ * report — the report knows percentages, the archive knows how many times
+ * each line ran.
+ */
+export async function readFileLines(path, file) {
+    const stdout = await xccov([
+        ...archiveArgs(path),
+        "--file",
+        file,
+        "--json",
+        path,
+    ]);
+    let parsed;
+    try {
+        parsed = JSON.parse(stdout);
+    }
+    catch {
+        throw new AxiError("xccov returned output that could not be read", "RESULT_NOT_FOUND");
+    }
+    return Object.values(parsed)
+        .flat()
+        .map((line) => ({
+        line: line.line ?? 0,
+        isExecutable: line.isExecutable === true,
+        executionCount: line.executionCount ?? 0,
+    }));
+}
+/** Every file the archive holds counts for, which is what `--file` accepts. */
+export async function readArchiveFiles(path) {
+    const stdout = await xccov([...archiveArgs(path), "--file-list", path]);
+    return stdout
+        .split("\n")
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0);
+}
+/**
+ * Two coverage reports measured against each other.
+ *
+ * `xccov diff` refuses to run without `--json` — its own text form was
+ * removed — so there is only one shape to read.
+ */
+export async function readCoverageDiff(before, after) {
+    const stdout = await xccov(["diff", "--json", before, after]);
+    try {
+        return JSON.parse(stdout);
+    }
+    catch {
+        throw new AxiError("xccov returned a diff that could not be read", "RESULT_NOT_FOUND");
+    }
+}
+/**
+ * Combine the coverage of several runs into one report and archive.
+ *
+ * `xccov merge` takes report/archive **pairs**, not result bundles, so each
+ * bundle is unpacked with `xcresulttool export coverage` first. That two-step
+ * is the whole reason merging coverage across shards is something people give
+ * up on.
+ */
+export async function mergeCoverage(paths, outReport, outArchive) {
+    const pairs = [];
+    for (const path of paths) {
+        if (coverageSource(path) !== "bundle") {
+            pairs.push(path);
+            continue;
+        }
+        const exported = mkdtempSync(join(tmpdir(), "axi-xccov-"));
+        await exportCoverage(path, exported);
+        const report = findExported(exported, "CoverageReport");
+        const archive = findExported(exported, "CoverageArchive");
+        if (!report || !archive) {
+            throw new AxiError(`No coverage to merge in ${path}`, "RESULT_NOT_FOUND", ["Re-run those tests with `xcodebuild-axi test --coverage`"]);
+        }
+        pairs.push(report, archive);
+    }
+    await xccov([
+        "merge",
+        "--outReport",
+        outReport,
+        "--outArchive",
+        outArchive,
+        ...pairs,
+    ]);
+}
+function findExported(dir, suffix) {
+    const match = readdirSync(dir).find((entry) => entry.endsWith(suffix));
+    return match ? join(dir, match) : undefined;
+}
+function exportCoverage(path, outputPath) {
+    if (!existsSync(path)) {
+        throw new AxiError(`No result bundle at ${path}`, "RESULT_NOT_FOUND", [
+            "Run `xcodebuild-axi test --coverage` first — it prints the bundle path it wrote",
+        ]);
+    }
+    return new Promise((resolvePromise, rejectPromise) => {
+        execFile("xcrun", [
+            "xcresulttool",
+            "export",
+            "coverage",
+            "--path",
+            path,
+            "--output-path",
+            outputPath,
+        ], { maxBuffer: MAX_BUFFER_BYTES, encoding: "utf-8" }, (error, _stdout, stderr) => {
+            if (error) {
+                rejectPromise(new AxiError(firstLine(stderr) || `Could not read coverage out of ${path}`, "RESULT_NOT_FOUND", ["Re-run those tests with `xcodebuild-axi test --coverage`"]));
+                return;
+            }
+            resolvePromise();
+        });
+    });
+}
 //# sourceMappingURL=xccov.js.map

package/dist/src/xccov.js.map

@@ -1 +1 @@
-{"version":3,"file":"xccov.js","sourceRoot":"","sources":["../../src/xccov.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"xccov.js","sourceRoot":"","sources":["../../src/xccov.ts"],"names":[],"mappings":"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"}

package/dist/src/xcodebuild.d.ts

@@ -54,6 +54,24 @@ export declare function globalArtifactDir(): string;
  * into the name so two checkouts of the same repo do not collide.
  */
 export declare function artifactDir(project: ProjectContext): string;
+/**
+ * Where something exported out of a result bundle lands.
+ *
+ * Keyed on the bundle rather than on the project, because `result` takes an
+ * arbitrary path and may be pointed at a bundle from anywhere — including a
+ * CI artifact in a checked-out repository, which is exactly the tree that must
+ * not be dirtied by asking what is in it.
+ */
+export declare function exportDir(bundlePath: string, kind: string): string;
+/**
+ * Where a merged bundle lands when the caller did not say.
+ *
+ * Hashed over every input rather than just the first, so merging a different
+ * set of shards does not quietly overwrite the last merge of a different set.
+ */
+export declare function mergedBundlePath(paths: string[]): string;
+/** Where a merged coverage report and archive land when nobody said. */
+export declare function mergedCoveragePath(paths: string[]): string;
 /**
  * Strip xcodebuild's fixed preamble.
  *

package/dist/src/xcodebuild.js

@@ -2,7 +2,7 @@ import { execFile, spawn } from "node:child_process";
 import { createHash } from "node:crypto";
 import { createWriteStream, mkdirSync, rmSync } from "node:fs";
 import { homedir } from "node:os";
-import { join } from "node:path";
+import { basename, join } from "node:path";
 import { AxiError, xcodeNotInstalledError } from "./errors.js";
 const MAX_METADATA_BYTES = 8 * 1024 * 1024;
 /** Override the wrapped binary. Unset keeps the PATH lookup. */
@@ -118,6 +118,43 @@ export function artifactDir(project) {
         .slice(0, 8);
     return join(homedir(), "Library", "Caches", "xcodebuild-axi", `${project.name}-${hash}`);
 }
+/**
+ * Where something exported out of a result bundle lands.
+ *
+ * Keyed on the bundle rather than on the project, because `result` takes an
+ * arbitrary path and may be pointed at a bundle from anywhere — including a
+ * CI artifact in a checked-out repository, which is exactly the tree that must
+ * not be dirtied by asking what is in it.
+ */
+export function exportDir(bundlePath, kind) {
+    const hash = createHash("sha256")
+        .update(bundlePath)
+        .digest("hex")
+        .slice(0, 8);
+    const stem = basename(bundlePath).replace(/\.xcresult$/, "");
+    return join(homedir(), "Library", "Caches", "xcodebuild-axi", "exports", `${stem}-${hash}`, kind);
+}
+/**
+ * Where a merged bundle lands when the caller did not say.
+ *
+ * Hashed over every input rather than just the first, so merging a different
+ * set of shards does not quietly overwrite the last merge of a different set.
+ */
+export function mergedBundlePath(paths) {
+    const hash = createHash("sha256")
+        .update(paths.join("\n"))
+        .digest("hex")
+        .slice(0, 8);
+    return join(homedir(), "Library", "Caches", "xcodebuild-axi", "exports", `merged-${hash}`, "merged.xcresult");
+}
+/** Where a merged coverage report and archive land when nobody said. */
+export function mergedCoveragePath(paths) {
+    const hash = createHash("sha256")
+        .update(paths.join("\n"))
+        .digest("hex")
+        .slice(0, 8);
+    return join(homedir(), "Library", "Caches", "xcodebuild-axi", "exports", `coverage-${hash}`, "merged.xccovreport");
+}
 /**
  * Strip xcodebuild's fixed preamble.
  *

package/dist/src/xcodebuild.js.map

@@ -1 +1 @@
-{"version":3,"file":"xcodebuild.js","sourceRoot":"","sources":["../../src/xcodebuild.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"xcodebuild.js","sourceRoot":"","sources":["../../src/xcodebuild.ts"],"names":[],"mappings":"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"}

package/dist/src/xcresult.d.ts

@@ -36,7 +36,11 @@ export interface TestSummary {
 export interface TestNode {
     nodeType?: string;
     name?: string;
+    /** `Target/Suite/testName()`, the identifier `--only` and `--test` take. */
+    nodeIdentifier?: string;
     result?: string;
+    /** Pre-formatted by xcresulttool, e.g. `0.028s`. */
+    duration?: string;
     sourceLocation?: {
         filePath?: string;
         lineNumber?: number;
@@ -49,6 +53,90 @@ export interface TestDetails {
     testResult?: string;
     testRuns?: TestNode[];
 }
+/** `get test-results tests` — the whole tree of what ran. */
+export interface TestTree {
+    devices?: TestDevice[];
+    testNodes?: TestNode[];
+}
+/** `get test-results activities` — what one test did, step by step. */
+export interface ActivityNode {
+    title?: string;
+    startTime?: number;
+    attachments?: unknown[];
+    childActivities?: ActivityNode[];
+}
+export interface TestActivities {
+    testIdentifier?: string;
+    testName?: string;
+    testRuns?: {
+        device?: TestDevice;
+        activities?: ActivityNode[];
+    }[];
+}
+/** `get test-results insights` — Xcode's own diagnosis of a run. */
+export interface TestInsights {
+    commonFailureInsights?: Insight[];
+    failureDistributionInsights?: Insight[];
+    longestTestRunsInsights?: Insight[];
+}
+export interface Insight {
+    category?: string;
+    impact?: string;
+    text?: string;
+    testIdentifier?: string;
+    testName?: string;
+    totalDuration?: number;
+    count?: number;
+}
+/** `get test-results metrics` — what a performance test measured. */
+export interface TestMetric {
+    testIdentifier?: string;
+    testName?: string;
+    measurements?: {
+        displayName?: string;
+        unit?: string;
+        average?: number;
+        baselineAverage?: number;
+        maxPercentRelativeStandardDeviation?: number;
+    }[];
+}
+/** `get content-availability` — what is in the bundle at all. */
+export interface ContentAvailability {
+    hasCoverage?: boolean;
+    hasDiagnostics?: boolean;
+    hasTestResults?: boolean;
+    logs?: string[];
+}
+/** `get log` — the build or action log, as a tree of timed sections. */
+export interface LogSection {
+    title?: string;
+    result?: string;
+    duration?: number;
+    startTime?: number;
+    messages?: {
+        title?: string;
+        shortTitle?: string;
+    }[];
+    subsections?: LogSection[];
+    commandInvocationDetails?: {
+        commandDetails?: string;
+        exitCode?: number;
+    };
+}
+/** `metadata get` — the bundle's own storage details. */
+export interface BundleMetadata {
+    dateCreated?: string;
+    directoryImportMode?: string;
+    externalLocations?: unknown[];
+    storage?: {
+        backend?: string;
+        compression?: string;
+    };
+    version?: {
+        major?: number;
+        minor?: number;
+    };
+}
 export interface RawIssue {
     issueType?: string;
     message?: string;
@@ -102,7 +190,135 @@ export declare function failureLocation(details: TestDetails): {
     file: string;
     line: number | "";
 };
+/** Every test the run knows about, as the tree Xcode groups them into. */
+export declare function readTests(path: string): Promise<TestTree>;
+/**
+ * What one test actually did, step by step.
+ *
+ * The summary says a test failed and `test-details` says where; this is the
+ * trail of what it had done by then, which is the only thing that explains a
+ * UI test that failed three screens into a flow.
+ */
+export declare function readActivities(path: string, testIdentifier: string): Promise<TestActivities>;
+/** Xcode's own diagnosis of a run: what failed together, and what was slow. */
+export declare function readInsights(path: string): Promise<TestInsights>;
+/** What a performance test measured, and what it measured last time. */
+export declare function readMetrics(path: string, testIdentifier?: string): Promise<TestMetric[]>;
+/**
+ * What the bundle actually holds.
+ *
+ * Worth one subprocess because the alternative is finding out by asking for
+ * coverage and reading the failure — an error that looks like a broken tool
+ * rather than like an answer.
+ */
+export declare function readContentAvailability(path: string): Promise<ContentAvailability>;
+/** The build, action or console log, as the timed tree the bundle stores. */
+export declare function readLog(path: string, type: string): Promise<LogSection>;
+/** The bundle's own metadata — when it was written, and in what format. */
+export declare function readBundleMetadata(path: string): Promise<BundleMetadata>;
 export declare function readBuildResults(path: string): Promise<BuildResults>;
+/** What `xcresulttool compare` answers: one run measured against another. */
+export interface Differential {
+    summary?: DifferentialSummary;
+    testFailures?: {
+        introduced?: TestFailureDelta[];
+        resolved?: TestFailureDelta[];
+    };
+    testsExecuted?: {
+        added?: TestReference[];
+        removed?: TestReference[];
+    };
+    buildWarnings?: IssueDelta;
+    analyzerIssues?: IssueDelta;
+}
+export interface DifferentialSummary {
+    testFailures?: CountDelta;
+    buildWarnings?: CountDelta;
+    analyzerIssues?: CountDelta;
+    testsExecuted?: {
+        itemsInBaseline?: number;
+        itemsInCurrent?: number;
+        added?: number;
+        removed?: number;
+    };
+}
+export interface CountDelta {
+    itemsInBaseline?: number;
+    itemsInCurrent?: number;
+    introduced?: number;
+    resolved?: number;
+}
+export interface TestReference {
+    name?: string;
+    testIdentifier?: string;
+}
+export interface TestFailureDelta {
+    associatedTest?: TestReference;
+    failureMessage?: string;
+}
+export interface IssueDelta {
+    introduced?: DifferentialIssue[];
+    resolved?: DifferentialIssue[];
+}
+export interface DifferentialIssue {
+    message?: string;
+    producingTarget?: string;
+    issueType?: string;
+}
+/** What an `xcresulttool export` can be asked for. */
+export declare const EXPORT_KINDS: readonly ["attachments", "diagnostics", "metrics", "evaluations"];
+export type ExportKind = (typeof EXPORT_KINDS)[number];
+export interface ExportRequest {
+    path: string;
+    kind: ExportKind;
+    outputPath: string;
+    /** Narrow to one test case or suite. Not accepted by `diagnostics`. */
+    testId?: string;
+    /** Glob against the attachment filename. `attachments` only. */
+    filter?: string;
+    /** Only what a failure produced. `attachments` and `evaluations` only. */
+    onlyFailures?: boolean;
+}
+/** One test's row in an exported `manifest.json`. */
+export interface ExportedAttachment {
+    exportedFileName?: string;
+    suggestedHumanReadableName?: string;
+    isAssociatedWithFailure?: boolean;
+}
+export interface AttachmentManifestEntry {
+    testIdentifier?: string;
+    attachments?: ExportedAttachment[];
+}
+export interface MetricsManifestEntry {
+    testIdentifier?: string;
+    metricsFiles?: string[];
+}
+/**
+ * Write part of a bundle out to a directory.
+ *
+ * Unlike every other read here this one produces files rather than JSON, and
+ * it narrates: exporting attachments from a 40-test run prints "Skipped export
+ * for <test>: no matching attachments" once per test, which is the answer
+ * nobody asked for repeated forty times. The prose is dropped and the caller
+ * reports what actually landed on disk instead.
+ */
+export declare function exportBundle(request: ExportRequest): Promise<void>;
+/**
+ * One run measured against another.
+ *
+ * Not routed through `xcresulttool()` because `compare` takes the bundle as a
+ * positional rather than as `--path`, and rejects `--compact` outright. It
+ * also answers a bare `null` rather than an error when the two bundles have
+ * nothing comparable in them — a build bundle against a test one — which is an
+ * answer the caller has to be able to tell apart from a clean comparison.
+ */
+export declare function readComparison(path: string, baselinePath: string): Promise<Differential | null>;
+/**
+ * Combine bundles into one, which is how a sharded test run gets a single
+ * verdict. Writes a bundle rather than printing one, so the caller reports the
+ * path and then reads it back like any other.
+ */
+export declare function mergeBundles(paths: string[], outputPath: string): Promise<void>;
 /**
  * Pull `file`, `line` and `col` out of a diagnostic's sourceURL.
  *