container/Tests/IntegrationTests/Run/TestCLIRunLifecycle.swift

//===----------------------------------------------------------------------===//
// Copyright © 2026 Apple Inc. and the container project authors.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//   https://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
//===----------------------------------------------------------------------===//

import Foundation
import Testing

/// Concurrent lifecycle tests for `container run` / `start` / `exec`.
@Suite
struct TestCLIRunLifecycle {
    @Test func testRunFailureCleanup() async throws {
        try await ContainerFixture.with { f in
            let image = try f.copyWarmupImage(ContainerFixture.warmupImages[0])
            let name = "\(f.testID)-c"

            // First attempt with an invalid user — must fail.
            let failResult = try f.run([
                "run", "--rm", "--name", name, "-d",
                "--user", f.testID,  // f.testID won't exist in /etc/passwd
                image, "sleep", "infinity",
            ])
            #expect(failResult.status != 0, "expected run to fail with invalid user")

            // Second attempt with the same name and no user — must succeed.
            try await f.withContainer(image: image) { containerName in
                _ = try f.doExec(containerName, cmd: ["date"])
            }
        }
    }

    @Test func testStartIdempotent() async throws {
        try await ContainerFixture.with { f in
            let image = try f.copyWarmupImage(ContainerFixture.warmupImages[0])
            try await f.withContainer(image: image) { name in
                let result = try f.run(["start", name])
                #expect(result.status == 0, "expected start to succeed on already running container")
                #expect(
                    result.output.trimmingCharacters(in: .whitespacesAndNewlines) == name,
                    "expected output to be container name")
                _ = try f.inspectContainer(name)
            }
        }
    }

    @Test func testStartIdempotentAttachFails() async throws {
        try await ContainerFixture.with { f in
            let image = try f.copyWarmupImage(ContainerFixture.warmupImages[0])
            try await f.withContainer(image: image) { name in
                let result = try f.run(["start", "-a", name])
                #expect(
                    result.status != 0,
                    "expected start with attach to fail on already running container")
                #expect(result.error.contains("attach is currently unsupported on already running containers"))
            }
        }
    }

    @Test func testRunInvalidExecutable() async throws {
        try await ContainerFixture.with { f in
            let image = try f.copyWarmupImage(ContainerFixture.warmupImages[0])
            let name = "\(f.testID)-c"
            f.addCleanup { try f.doRemoveIfExists(name, force: true, ignoreFailure: true) }
            let result = try f.run(["run", "--rm", "--name", name, "-d", image, "foobarbaz"])
            #expect(result.status != 0, "running invalid executable must fail, not hang")
        }
    }

    @Test func testExecInvalidExecutable() async throws {
        try await ContainerFixture.with { f in
            let image = try f.copyWarmupImage(ContainerFixture.warmupImages[0])
            try await f.withContainer(image: image) { name in
                let result = try f.run(["exec", name, "foobarbaz"])
                #expect(result.status != 0, "executing invalid executable must fail, not hang")
            }
        }
    }

    @Test func testSSHForwarding() async throws {
        try await ContainerFixture.with { f in
            let image = try f.copyWarmupImage(ContainerFixture.warmupImages[0])

            let socketPath = try f.makeFakeSSHAgentSocket()

            // Run container with --ssh; SSH_AUTH_SOCK must be in the CLI process environment.
            let name = "\(f.testID)-c"
            f.addCleanup { try? f.doStop(name) }
            try f.run(
                ["run", "--rm", "--name", name, "-d", "--ssh", image, "sleep", "infinity"],
                env: ["SSH_AUTH_SOCK": socketPath]
            ).check()
            try await f.waitForContainerRunning(name)

            let sshSockValue = try f.doExec(name, cmd: ["sh", "-c", "echo $SSH_AUTH_SOCK"])
            #expect(
                sshSockValue.trimmingCharacters(in: .whitespacesAndNewlines)
                    == "/var/host-services/ssh-auth.sock",
                "expected SSH_AUTH_SOCK to point to guest socket path")

            let socketCheck = try f.doExec(
                name, cmd: ["sh", "-c", "[ -S /var/host-services/ssh-auth.sock ] && echo exists || echo missing"])
            #expect(
                socketCheck.trimmingCharacters(in: .whitespacesAndNewlines) == "exists",
                "expected forwarded SSH socket to exist in container")

            try f.doStop(name)
        }
    }
}