@augment-vir/node 31.43.3 → 31.45.0

package/src/docker/docker-image.ts

@@ -1,61 +0,0 @@
-import {wrapString} from '@augment-vir/common';
-import {ensureError} from '@augment-vir/core';
-import {runShellCommand} from '../augments/terminal/shell.js';
-
-export async function updateImage(
-    /** @example 'alpine:3.20.2' */
-    imageName: string,
-    platform?: string,
-) {
-    if (await isImageInLocalRegistry(imageName)) {
-        /** If image already exists then we don't need to update it. */
-        return;
-    }
-
-    const command = [
-        'docker',
-        'pull',
-        ...(platform
-            ? [
-                  '--platform',
-                  platform,
-              ]
-            : []),
-        wrapString({value: imageName, wrapper: "'"}),
-    ].join(' ');
-
-    await runShellCommand(command, {
-        rejectOnError: true,
-    });
-}
-
-export async function isImageInLocalRegistry(
-    /** @example 'alpine:3.20.2' */
-    imageName: string,
-): Promise<boolean> {
-    const output = await runShellCommand(`docker inspect '${imageName}'`);
-
-    return output.exitCode === 0;
-}
-
-export async function removeImageFromLocalRegistry(
-    /** @example 'alpine:3.20.2' */
-    imageName: string,
-) {
-    try {
-        await runShellCommand(`docker image rm '${imageName}'`, {
-            rejectOnError: true,
-        });
-    } catch (caught) {
-        const error = ensureError(caught);
-
-        if (error.message.includes('No such image:')) {
-            /** Ignore the case where the image has already been deleted. */
-            return;
-        }
-
-        /** An edge case that I don't know how to intentionally trigger. */
-        /* node:coverage ignore next 2 */
-        throw error;
-    }
-}

package/src/docker/docker-startup.ts

@@ -1,49 +0,0 @@
-import {waitUntil} from '@augment-vir/assert';
-import {currentOperatingSystem, OperatingSystem} from '../augments/os/operating-system.js';
-import {runShellCommand} from '../augments/terminal/shell.js';
-
-export async function isDockerRunning() {
-    const output = await runShellCommand('docker info');
-
-    return output.exitCode === 0;
-}
-
-const startDockerCommands: Record<OperatingSystem, string> = {
-    /**
-     * Officially supported for the following distros:
-     *
-     * - [Ubuntu](https://docs.docker.com/desktop/install/ubuntu/#launch-docker-desktop)
-     * - [Debian](https://docs.docker.com/desktop/install/debian/#launch-docker-desktop)
-     * - [Fedora](https://docs.docker.com/desktop/install/fedora/#launch-docker-desktop)
-     * - [Arch](https://docs.docker.com/desktop/install/archlinux/#launch-docker-desktop)
-     */
-    [OperatingSystem.Linux]: 'systemctl --user start docker-desktop',
-    [OperatingSystem.Mac]: 'open -a Docker',
-    [OperatingSystem.Windows]: String.raw`/c/Program\ Files/Docker/Docker/Docker\ Desktop.exe`,
-};
-
-export async function startDocker() {
-    const command = startDockerCommands[currentOperatingSystem];
-
-    /* node:coverage disable */
-    if (await isDockerRunning()) {
-        /** Docker is already running. Nothing to do. */
-        return;
-    }
-
-    await waitUntil.isTrue(
-        async () => {
-            await runShellCommand(command, {rejectOnError: true});
-            return isDockerRunning();
-        },
-        {
-            interval: {
-                seconds: 1,
-            },
-            timeout: {
-                minutes: 1,
-            },
-        },
-        'Failed to start Docker.',
-    );
-}

package/src/docker/run-docker-test.mock.ts

@@ -1,26 +0,0 @@
-import {type MaybePromise} from '@augment-vir/common';
-import {isOperatingSystem, OperatingSystem} from '../augments/os/operating-system.js';
-
-export function dockerTest(callback: () => MaybePromise<void>) {
-    if (!isOperatingSystem(OperatingSystem.Linux) && process.env.CI) {
-        /**
-         * We cannot test Docker on macOS GitHub Actions runners.
-         *
-         * @see
-         * - https://github.com/actions/runner-images/issues/8104
-         * - https://github.com/douglascamata/setup-docker-macos-action?tab=readme-ov-file#arm64-processors-m1-m2-m3-series-used-on-macos-14-images-are-unsupported
-         * - https://github.com/actions/runner-images/issues/2150
-         * - https://github.com/actions/runner/issues/1456
-         */
-        /**
-         * We cannot test Docker on Windows GitHub Actions runners because Docker cannot run in
-         * Linux container mode on Windows GitHub Actions runners.
-         *
-         * @see
-         * - https://github.com/orgs/community/discussions/25491#discussioncomment-3248089
-         */
-        return () => {};
-    }
-
-    return callback;
-}