@rage-against-the-pixel/unity-cli 3.0.1 → 4.0.0

package/dist/process-tracker.js

@@ -0,0 +1,213 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OwnedSpawnOptions = OwnedSpawnOptions;
+exports.ReadOwnedRoots = ReadOwnedRoots;
+exports.TrackOwnedProcess = TrackOwnedProcess;
+exports.ListProcesses = ListProcesses;
+exports.SelectOwnedProcesses = SelectOwnedProcesses;
+exports.ParseElapsedSeconds = ParseElapsedSeconds;
+exports.FindOwnedProcesses = FindOwnedProcesses;
+exports.IsExecutableNamed = IsExecutableNamed;
+exports.IsPathUnder = IsPathUnder;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const logging_1 = require("./logging");
+const utilities_1 = require("./utilities");
+const logger = logging_1.Logger.instance;
+/** Options that make a spawned process lead its own process group on macOS and Linux. */
+function OwnedSpawnOptions() {
+    return { detached: process.platform !== 'win32' };
+}
+function stateFilePath() {
+    return path.join((0, utilities_1.GetTempDir)(), 'unity-cli-owned-processes.json');
+}
+/** The processes recorded by this job's earlier and current commands. */
+function ReadOwnedRoots() {
+    try {
+        const roots = JSON.parse(fs.readFileSync(stateFilePath(), 'utf-8'));
+        return Array.isArray(roots)
+            ? roots.filter((root) => Number.isInteger(root?.pid) && Number.isFinite(root?.startedAt))
+            : [];
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Records a process this command started. Only done in CI, where cleanup runs.
+ * @param child The spawned process, started with {@link OwnedSpawnOptions}.
+ * @param startedAt When it was spawned, in milliseconds since the epoch.
+ */
+function TrackOwnedProcess(child, startedAt) {
+    if (process.env.CI !== 'true' || !child.pid) {
+        return;
+    }
+    try {
+        const roots = ReadOwnedRoots().filter(root => root.pid !== child.pid);
+        roots.push({ pid: child.pid, startedAt });
+        fs.writeFileSync(stateFilePath(), JSON.stringify(roots), { encoding: 'utf-8', mode: 0o600 });
+    }
+    catch (error) {
+        logger.debug(`Failed to record process ${child.pid}: ${error}`);
+    }
+}
+/** Lists running processes with their group, creation time and command line. */
+async function ListProcesses() {
+    const results = [];
+    try {
+        if (process.platform === 'win32') {
+            const output = await (0, utilities_1.Exec)('powershell', [
+                '-NoProfile',
+                '-Command',
+                'Get-CimInstance Win32_Process | ForEach-Object { $c = if ($_.CreationDate) { ([DateTimeOffset]$_.CreationDate).ToUnixTimeMilliseconds() } else { 0 }; "$($_.ProcessId)`t$($_.ParentProcessId)`t$c`t$($_.Name)`t$($_.ExecutablePath)`t$($_.CommandLine)" }'
+            ], { silent: true, showCommand: false });
+            for (const line of output.split(/\r?\n/)) {
+                const [pid, ppid, created, name, executable, ...commandLine] = line.split('\t');
+                if (pid && ppid && /^\d+$/.test(pid)) {
+                    results.push({
+                        pid: parseInt(pid, 10),
+                        ppid: parseInt(ppid, 10),
+                        createdAt: parseInt(created ?? '0', 10) || 0,
+                        name: name ?? '',
+                        executablePath: executable || undefined,
+                        commandLine: commandLine.join('\t'),
+                    });
+                }
+            }
+        }
+        else {
+            // etime is the elapsed time as [[dd-]hh:]mm:ss, which both macOS and Linux ps report
+            const output = await (0, utilities_1.Exec)('ps', ['-axo', 'pid=,ppid=,pgid=,etime=,args='], { silent: true, showCommand: false });
+            const now = Date.now();
+            for (const line of output.split('\n')) {
+                const match = /^\s*(\d+)\s+(\d+)\s+(\d+)\s+([\d:-]+)\s+(.*)$/.exec(line);
+                if (match) {
+                    results.push({
+                        pid: parseInt(match[1], 10),
+                        ppid: parseInt(match[2], 10),
+                        pgid: parseInt(match[3], 10),
+                        createdAt: now - ParseElapsedSeconds(match[4]) * 1000,
+                        name: match[5],
+                        commandLine: match[5],
+                    });
+                }
+            }
+        }
+    }
+    catch (error) {
+        logger.debug(`Failed to list processes: ${error}`);
+    }
+    return results.filter(proc => proc.pid !== process.pid);
+}
+/**
+ * The running processes that belong to the given roots: on macOS and Linux every member of their process groups, on
+ * Windows the roots and their descendants created after the root started.
+ * @param roots The processes unity-cli started.
+ * @param processes A process list from {@link ListProcesses}.
+ */
+function SelectOwnedProcesses(roots, processes) {
+    if (roots.length === 0) {
+        return [];
+    }
+    // a dead process's id can be reused by another job, so a member must be no older than the root it belongs to;
+    // ps reports whole seconds, hence the slack
+    const earliest = Math.min(...roots.map(root => root.startedAt)) - 2000;
+    if (process.platform !== 'win32') {
+        const groups = new Map(roots.map(root => [root.pid, root.startedAt - 2000]));
+        return processes.filter(proc => proc.pgid !== undefined && groups.has(proc.pgid) &&
+            (proc.createdAt === undefined || proc.createdAt >= groups.get(proc.pgid)));
+    }
+    const owned = new Map();
+    let frontier = new Set(roots.map(root => root.pid));
+    for (const proc of processes) {
+        if (frontier.has(proc.pid) && (proc.createdAt ?? 0) >= earliest) {
+            owned.set(proc.pid, proc);
+        }
+    }
+    while (frontier.size > 0) {
+        const next = new Set();
+        for (const proc of processes) {
+            if (!owned.has(proc.pid) && frontier.has(proc.ppid) && (proc.createdAt ?? 0) >= earliest) {
+                owned.set(proc.pid, proc);
+                next.add(proc.pid);
+            }
+        }
+        frontier = next;
+    }
+    return [...owned.values()];
+}
+/**
+ * Converts a ps elapsed time, [[dd-]hh:]mm:ss, to seconds.
+ * @param elapsed The etime value.
+ */
+function ParseElapsedSeconds(elapsed) {
+    const [days, clock] = elapsed.includes('-') ? elapsed.split('-', 2) : ['0', elapsed];
+    const parts = clock.split(':').map(part => parseInt(part, 10) || 0);
+    while (parts.length < 3) {
+        parts.unshift(0);
+    }
+    return (parseInt(days, 10) || 0) * 86400 + parts[0] * 3600 + parts[1] * 60 + parts[2];
+}
+/** The running processes this job's unity-cli commands started, and their helpers. */
+async function FindOwnedProcesses() {
+    const roots = ReadOwnedRoots();
+    return roots.length === 0 ? [] : SelectOwnedProcesses(roots, await ListProcesses());
+}
+/**
+ * Whether a process's executable is the named one, e.g. Unity.Licensing.Client.
+ * @param proc The process.
+ * @param name The executable file name, without .exe.
+ */
+function IsExecutableNamed(proc, name) {
+    const target = name.toLowerCase();
+    const executable = (proc.executablePath ?? proc.commandLine.split(' ')[0] ?? proc.name).toLowerCase();
+    return path.basename(executable).replace(/\.exe$/, '') === target || proc.name.toLowerCase().replace(/\.exe$/, '') === target;
+}
+/**
+ * Whether a path lies inside a directory, compared on whole path segments.
+ * @param candidate The path to check.
+ * @param directory The directory.
+ */
+function IsPathUnder(candidate, directory) {
+    const normalize = (value) => {
+        const resolved = path.resolve(value);
+        return process.platform === 'win32' || process.platform === 'darwin' ? resolved.toLowerCase() : resolved;
+    };
+    const root = normalize(directory);
+    const target = normalize(candidate);
+    return target === root || target.startsWith(root.endsWith(path.sep) ? root : root + path.sep);
+}
+//# sourceMappingURL=process-tracker.js.map

package/dist/process-tracker.js.map

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

package/dist/unity-cli.d.ts

@@ -0,0 +1,97 @@
+export interface UnityCliResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}
+/** The envelope every `--format json` result of the official CLI uses. */
+export interface UnityCliEnvelope<T = unknown> {
+    success: boolean;
+    command?: string;
+    data?: T;
+    errors?: {
+        code: string;
+        message: string;
+    }[];
+    warnings?: unknown[];
+}
+export interface UnityCliRunOptions {
+    /** Stream output to the console. Defaults to false. */
+    stream?: boolean;
+    /** Kill the CLI after this many milliseconds. */
+    timeoutMs?: number;
+    /** Values replaced with `*****` in logged output and the logged command. */
+    redactLiterals?: readonly string[];
+}
+/**
+ * A thin wrapper over Unity's official CLI (`unity`).
+ * @see https://docs.unity.com/en-us/cli
+ */
+export declare class UnityCli {
+    readonly executable: string;
+    readonly version: string;
+    private readonly logger;
+    constructor(executable: string, version: string);
+    /**
+     * Returns the official Unity CLI, installing it when it is missing or is not the requested version.
+     * @param version An exact version such as 1.0.0-beta.14, or `latest`. Defaults to UNITY_CLI_VERSION, then `latest`.
+     * Every install exports UNITY_CLI_VERSION, so later steps in the same job reuse the version the first one resolved.
+     */
+    static Get(version?: string | undefined): Promise<UnityCli>;
+    /**
+     * Finds an installed official Unity CLI from UNITY_CLI_PATH, the tool cache, the install script's default location, or the PATH.
+     * The PATH comes last, since other programs named unity live there, such as the Unity7 shell on Ubuntu desktops.
+     */
+    static Find(): Promise<UnityCli | undefined>;
+    /**
+     * Downloads an exact official Unity CLI release from Unity's CDN, verifies its SHA-256 and caches it.
+     * @param version An exact version such as 1.0.0-beta.14, or `latest`.
+     */
+    static Install(version?: string): Promise<UnityCli>;
+    /**
+     * Runs the CLI and returns its exit code and output without throwing on a non-zero exit code.
+     * @param args The arguments to pass to `unity`.
+     * @param options Run options.
+     */
+    Run(args: string[], options?: UnityCliRunOptions): Promise<UnityCliResult>;
+    /**
+     * Runs the CLI and throws when it exits with a non-zero exit code.
+     * @param args The arguments to pass to `unity`.
+     * @param options Run options. Output streams to the console unless `stream` is false.
+     */
+    Exec(args: string[], options?: UnityCliRunOptions): Promise<string>;
+    /**
+     * Runs the CLI with `--format json` and parses the result envelope from stdout.
+     * @param args The arguments to pass to `unity`.
+     * @param options Run options.
+     * @returns The exit code and the parsed envelope, if stdout held one.
+     */
+    RunJson<T = unknown>(args: string[], options?: UnityCliRunOptions): Promise<{
+        exitCode: number;
+        envelope: UnityCliEnvelope<T> | undefined;
+        stdout: string;
+        stderr: string;
+    }>;
+    /**
+     * Runs the CLI with `--format json` and returns `data`, throwing when the command fails.
+     * @param args The arguments to pass to `unity`.
+     * @param options Run options.
+     */
+    ExecJson<T = unknown>(args: string[], options?: UnityCliRunOptions): Promise<T>;
+    /** Gets the directory the CLI installs editors to. */
+    GetInstallPath(): Promise<string>;
+    /**
+     * Sets the directory the CLI installs editors to.
+     * @param installPath The directory to install editors to.
+     */
+    SetInstallPath(installPath: string): Promise<void>;
+    /**
+     * Gets the path to the Unity.Licensing.Client the CLI manages, downloading it first if needed.
+     * @returns The licensing client executable, or undefined when the CLI does not report one.
+     */
+    GetLicensingClientPath(): Promise<string | undefined>;
+}
+/**
+ * Finds the first absolute path in a CLI result, preferring well-known keys.
+ * @param value A parsed CLI JSON value.
+ */
+export declare function FindAbsolutePath(value: unknown): string | undefined;