@git.zone/tsrust 1.9.0 → 1.10.0

package/dist_ts/mod_matrix/classes.matrixcommandrunner.js

@@ -0,0 +1,266 @@
+import * as childProcess from 'node:child_process';
+import * as fs from 'node:fs';
+const defaultCommandTimeoutMs = 60 * 60 * 1000;
+const forceKillDelayMs = 10 * 1000;
+const maximumCapturedOutputBytes = 16 * 1024 * 1024;
+export class MatrixCommandRunner {
+    environment;
+    constructor(environment = process.env) {
+        this.environment = environment;
+    }
+    async execute(commandArg, argsArg, optionsArg = {}) {
+        if ([optionsArg.heartbeatStdin === true, optionsArg.input !== undefined, !!optionsArg.inputFile]
+            .filter(Boolean)
+            .length > 1) {
+            throw new Error('A matrix command can use only one stdin source');
+        }
+        if (optionsArg.capture && optionsArg.outputFile) {
+            throw new Error('A matrix command cannot capture stdout and write it to a file');
+        }
+        if (optionsArg.outputFile &&
+            (!Number.isSafeInteger(optionsArg.maximumOutputBytes) ||
+                (optionsArg.maximumOutputBytes || 0) <= 0)) {
+            throw new Error('A matrix output file requires a positive byte limit');
+        }
+        const capture = optionsArg.capture === true;
+        let inputFileDescriptor;
+        let outputFileDescriptor;
+        let child;
+        try {
+            if (optionsArg.inputFile) {
+                inputFileDescriptor = fs.openSync(optionsArg.inputFile, fs.constants.O_RDONLY | fs.constants.O_NOFOLLOW);
+            }
+            if (optionsArg.outputFile) {
+                outputFileDescriptor = fs.openSync(optionsArg.outputFile, fs.constants.O_WRONLY |
+                    fs.constants.O_CREAT |
+                    fs.constants.O_EXCL |
+                    fs.constants.O_NOFOLLOW, 0o600);
+            }
+            const stdinMode = inputFileDescriptor ??
+                (optionsArg.heartbeatStdin || optionsArg.input !== undefined ? 'pipe' : 'ignore');
+            const stdoutMode = optionsArg.outputFile ? 'pipe' : capture ? 'pipe' : 'inherit';
+            child = childProcess.spawn(commandArg, argsArg, {
+                cwd: optionsArg.cwd || process.cwd(),
+                env: optionsArg.environment || this.environment,
+                stdio: [stdinMode, stdoutMode, capture ? 'pipe' : 'inherit'],
+                detached: true,
+            });
+        }
+        catch (error) {
+            if (inputFileDescriptor !== undefined)
+                fs.closeSync(inputFileDescriptor);
+            if (outputFileDescriptor !== undefined)
+                fs.closeSync(outputFileDescriptor);
+            throw error;
+        }
+        if (inputFileDescriptor !== undefined)
+            fs.closeSync(inputFileDescriptor);
+        let stdout = '';
+        let stderr = '';
+        let capturedOutputBytes = 0;
+        let timedOut = false;
+        let outputLimitExceeded = false;
+        let outputFileBytes = 0;
+        let outputFileError;
+        let forwardedSignal;
+        let forwardedSignalCount = 0;
+        let spawnError;
+        let stdinError;
+        let forceKillTimer;
+        let heartbeatTimer;
+        const killProcessGroup = (signalArg) => {
+            if (!child.pid)
+                return;
+            try {
+                process.kill(-child.pid, signalArg);
+            }
+            catch {
+                try {
+                    child.kill(signalArg);
+                }
+                catch {
+                    // The process may already have exited.
+                }
+            }
+        };
+        const terminateProcessGroup = (signalArg) => {
+            killProcessGroup(signalArg);
+            if (!forceKillTimer) {
+                forceKillTimer = setTimeout(() => killProcessGroup('SIGKILL'), forceKillDelayMs);
+            }
+        };
+        const processGroupExists = () => {
+            if (!child.pid)
+                return false;
+            try {
+                process.kill(-child.pid, 0);
+                return true;
+            }
+            catch (error) {
+                if (error.code === 'ESRCH')
+                    return false;
+                throw error;
+            }
+        };
+        const waitForProcessGroupExit = async (timeoutMsArg) => {
+            const deadline = Date.now() + timeoutMsArg;
+            while (processGroupExists() && Date.now() < deadline) {
+                await new Promise((resolve) => setTimeout(resolve, 100));
+            }
+            return !processGroupExists();
+        };
+        const ensureProcessGroupStopped = async () => {
+            if (!processGroupExists())
+                return;
+            terminateProcessGroup('SIGTERM');
+            if (!(await waitForProcessGroupExit(forceKillDelayMs + 1000))) {
+                killProcessGroup('SIGKILL');
+                if (!(await waitForProcessGroupExit(2000))) {
+                    throw new Error(`${commandArg} left a live descendant process group`);
+                }
+            }
+        };
+        const signalHandlers = new Map();
+        for (const signal of ['SIGINT', 'SIGTERM', 'SIGHUP']) {
+            const handler = () => {
+                forwardedSignal = signal;
+                forwardedSignalCount += 1;
+                if (forwardedSignalCount === 1)
+                    terminateProcessGroup(signal);
+                else
+                    killProcessGroup('SIGKILL');
+            };
+            signalHandlers.set(signal, handler);
+            process.on(signal, handler);
+        }
+        const timeout = setTimeout(() => {
+            timedOut = true;
+            terminateProcessGroup('SIGTERM');
+        }, optionsArg.timeoutMs || defaultCommandTimeoutMs);
+        if (optionsArg.heartbeatStdin) {
+            child.stdin?.on('error', () => {
+                // Process close handles a lost heartbeat channel.
+            });
+            const sendHeartbeat = () => {
+                if (!child.stdin?.destroyed)
+                    child.stdin?.write('heartbeat\n');
+            };
+            sendHeartbeat();
+            heartbeatTimer = setInterval(sendHeartbeat, 1000);
+        }
+        else if (optionsArg.input !== undefined) {
+            child.stdin?.on('error', (errorArg) => {
+                stdinError = errorArg;
+                terminateProcessGroup('SIGTERM');
+            });
+            child.stdin?.end(optionsArg.input);
+        }
+        const captureChunk = (targetArg, chunkArg) => {
+            capturedOutputBytes += chunkArg.length;
+            if (capturedOutputBytes > maximumCapturedOutputBytes) {
+                outputLimitExceeded = true;
+                terminateProcessGroup('SIGTERM');
+                return;
+            }
+            if (targetArg === 'stdout')
+                stdout += chunkArg.toString('utf8');
+            else
+                stderr += chunkArg.toString('utf8');
+        };
+        if (optionsArg.outputFile) {
+            child.stdout?.on('data', (chunkArg) => {
+                if (outputLimitExceeded || outputFileError || outputFileDescriptor === undefined)
+                    return;
+                if (outputFileBytes + chunkArg.length > (optionsArg.maximumOutputBytes || 0)) {
+                    outputLimitExceeded = true;
+                    terminateProcessGroup('SIGTERM');
+                    return;
+                }
+                try {
+                    let offset = 0;
+                    while (offset < chunkArg.length) {
+                        offset += fs.writeSync(outputFileDescriptor, chunkArg, offset, chunkArg.length - offset);
+                    }
+                    outputFileBytes += chunkArg.length;
+                }
+                catch (error) {
+                    outputFileError = error;
+                    terminateProcessGroup('SIGTERM');
+                }
+            });
+        }
+        else {
+            child.stdout?.on('data', (chunkArg) => captureChunk('stdout', chunkArg));
+        }
+        child.stderr?.on('data', (chunkArg) => captureChunk('stderr', chunkArg));
+        child.once('error', (errorArg) => {
+            spawnError = errorArg;
+        });
+        return new Promise((resolve, reject) => {
+            child.once('close', (codeArg, signalArg) => {
+                void (async () => {
+                    try {
+                        if (outputFileDescriptor !== undefined) {
+                            try {
+                                fs.fsyncSync(outputFileDescriptor);
+                                fs.closeSync(outputFileDescriptor);
+                                outputFileDescriptor = undefined;
+                            }
+                            catch (error) {
+                                outputFileError = error;
+                            }
+                        }
+                        await ensureProcessGroupStopped();
+                        const exitCode = codeArg ?? -1;
+                        if (timedOut) {
+                            throw new Error(`${commandArg} exceeded its command timeout`);
+                        }
+                        if (outputLimitExceeded) {
+                            throw new Error(`${commandArg} exceeded the captured output limit`);
+                        }
+                        if (forwardedSignal) {
+                            throw new Error(`${commandArg} was interrupted by ${forwardedSignal}`);
+                        }
+                        if (spawnError)
+                            throw spawnError;
+                        if (stdinError)
+                            throw stdinError;
+                        if (outputFileError)
+                            throw outputFileError;
+                        if (!(optionsArg.allowedExitCodes || [0]).includes(exitCode)) {
+                            if (capture && stdout)
+                                process.stdout.write(stdout);
+                            if (capture && stderr)
+                                process.stderr.write(stderr);
+                            throw new Error(`${commandArg} exited with ${signalArg ? `signal ${signalArg}` : `status ${exitCode}`}`);
+                        }
+                        resolve({ stdout, stderr, exitCode });
+                    }
+                    catch (error) {
+                        reject(error);
+                    }
+                    finally {
+                        clearTimeout(timeout);
+                        if (forceKillTimer)
+                            clearTimeout(forceKillTimer);
+                        if (heartbeatTimer)
+                            clearInterval(heartbeatTimer);
+                        child.stdin?.end();
+                        if (outputFileDescriptor !== undefined) {
+                            try {
+                                fs.closeSync(outputFileDescriptor);
+                            }
+                            catch {
+                                // Preserve the command's primary error.
+                            }
+                        }
+                        for (const [signal, handler] of signalHandlers) {
+                            process.off(signal, handler);
+                        }
+                    }
+                })();
+            });
+        });
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5tYXRyaXhjb21tYW5kcnVubmVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvbW9kX21hdHJpeC9jbGFzc2VzLm1hdHJpeGNvbW1hbmRydW5uZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLFlBQVksTUFBTSxvQkFBb0IsQ0FBQztBQUNuRCxPQUFPLEtBQUssRUFBRSxNQUFNLFNBQVMsQ0FBQztBQTZCOUIsTUFBTSx1QkFBdUIsR0FBRyxFQUFFLEdBQUcsRUFBRSxHQUFHLElBQUksQ0FBQztBQUMvQyxNQUFNLGdCQUFnQixHQUFHLEVBQUUsR0FBRyxJQUFJLENBQUM7QUFDbkMsTUFBTSwwQkFBMEIsR0FBRyxFQUFFLEdBQUcsSUFBSSxHQUFHLElBQUksQ0FBQztBQUdwRCxNQUFNLE9BQU8sbUJBQW1CO0lBQ1Y7SUFBcEIsWUFBb0IsY0FBaUMsT0FBTyxDQUFDLEdBQUc7UUFBNUMsZ0JBQVcsR0FBWCxXQUFXLENBQWlDO0lBQUcsQ0FBQztJQUU3RCxLQUFLLENBQUMsT0FBTyxDQUNsQixVQUFrQixFQUNsQixPQUFpQixFQUNqQixhQUFvQyxFQUFFO1FBRXRDLElBQ0UsQ0FBQyxVQUFVLENBQUMsY0FBYyxLQUFLLElBQUksRUFBRSxVQUFVLENBQUMsS0FBSyxLQUFLLFNBQVMsRUFBRSxDQUFDLENBQUMsVUFBVSxDQUFDLFNBQVMsQ0FBQzthQUN6RixNQUFNLENBQUMsT0FBTyxDQUFDO2FBQ2YsTUFBTSxHQUFHLENBQUMsRUFDYixDQUFDO1lBQ0QsTUFBTSxJQUFJLEtBQUssQ0FBQyxnREFBZ0QsQ0FBQyxDQUFDO1FBQ3BFLENBQUM7UUFDRCxJQUFJLFVBQVUsQ0FBQyxPQUFPLElBQUksVUFBVSxDQUFDLFVBQVUsRUFBRSxDQUFDO1lBQ2hELE1BQU0sSUFBSSxLQUFLLENBQUMsK0RBQStELENBQUMsQ0FBQztRQUNuRixDQUFDO1FBQ0QsSUFDRSxVQUFVLENBQUMsVUFBVTtZQUNyQixDQUFD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

package/dist_ts/mod_matrix/classes.nativematrixbuilder.d.ts

@@ -0,0 +1,64 @@
+import { type IArtifactAssemblyResult } from '../mod_artifact/index.js';
+import { type ITsrustConfig } from '../mod_cli/helpers.targets.js';
+import { type IMatrixCommandRunner } from './classes.matrixcommandrunner.js';
+import { type TMatrixHost } from './helpers.matrixconfig.js';
+export interface INativeMatrixBuilderOptions {
+    workspace: string;
+    config: ITsrustConfig;
+    environment?: NodeJS.ProcessEnv;
+    commandRunner?: IMatrixCommandRunner;
+}
+export interface INativeMatrixCheckResult {
+    workers: TMatrixHost[];
+    targets: string[];
+}
+export interface INativeMatrixBuildResult extends INativeMatrixCheckResult {
+    gitCommit: string;
+    assembly: IArtifactAssemblyResult;
+}
+export declare class NativeMatrixBuilder {
+    private readonly workspace;
+    private readonly environment;
+    private readonly commandRunner;
+    private readonly plan;
+    constructor(optionsArg: INativeMatrixBuilderOptions);
+    check(): Promise<INativeMatrixCheckResult>;
+    build(): Promise<INativeMatrixBuildResult>;
+    private checkResult;
+    private assertForwardEnvironmentGrant;
+    private workerEnvironment;
+    private transportEnvironment;
+    private remainingBuildTimeout;
+    private assertInstalledTsrustVersion;
+    private assertPlanMatchesCommit;
+    private remoteWorkerEnvironmentFunction;
+    private assertBundleCompatibleSource;
+    private checkLocalWorker;
+    private checkLocalToolchain;
+    private checkLocalExecution;
+    private checkLocalLinuxCrossExecution;
+    private resolveSshWorker;
+    private checkSshWorker;
+    private remoteToolchainCapabilityCommand;
+    private remoteRootValidationCommands;
+    private remoteOwnershipValidationCommands;
+    private remoteExecutionProbeCommands;
+    private readBinaryTargets;
+    private detectRustDirectory;
+    private readProjectIdentity;
+    private assertProjectIdentityUnchanged;
+    private ensureLocalRunParent;
+    private buildLocalWorker;
+    private workerTsrustArgs;
+    private assertWorkerSource;
+    private assertArtifactDirectory;
+    private smokeLocalArtifacts;
+    private describeRemoteWorkspace;
+    private createRemoteWorkspace;
+    private buildSshWorker;
+    private remoteSmokeCommands;
+    private cleanupRemoteWorkspace;
+    private runRemoteTransferScript;
+    private runRemoteLoginScript;
+    private runRemoteOwnedScript;
+}