Add Compose

Package.swift

@@ -58,6 +58,8 @@ let package = Package(
         .package(url: "https://github.com/swift-server/async-http-client.git", from: "1.20.1"),
         .package(url: "https://github.com/orlandos-nl/DNSClient.git", from: "2.4.1"),
         .package(url: "https://github.com/Bouke/DNS.git", from: "1.2.0"),
+        .package(url: "https://github.com/jpsim/Yams.git", from: "5.0.6"),
+        .package(url: "https://github.com/onevcat/Rainbow", .upToNextMajor(from: "4.0.0")),
         scDependency,
     ],
     targets: [
@@ -76,6 +78,8 @@ let package = Package(
                 "ContainerClient",
                 "ContainerPlugin",
                 "ContainerLog",
+                "Yams",
+                "Rainbow",
             ],
             path: "Sources/CLI"
         ),

Sources/CLI/Application.swift

@@ -56,6 +56,7 @@ struct Application: AsyncParsableCommand {
             CommandGroup(
                 name: "Container",
                 subcommands: [
+                    ComposeCommand.self,
                     ContainerCreate.self,
                     ContainerDelete.self,
                     ContainerExec.self,

Sources/CLI/Compose/Codable Structs/Build.swift

@@ -0,0 +1,52 @@
+//===----------------------------------------------------------------------===//
+// Copyright © 2025 Apple Inc. and the container project authors. All rights reserved.
+//
+// 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.
+//===----------------------------------------------------------------------===//
+
+//
+//  Build.swift
+//  container-compose-app
+//
+//  Created by Morris Richman on 6/17/25.
+//
+
+
+/// Represents the `build` configuration for a service.
+struct Build: Codable, Hashable {
+    /// Path to the build context
+    let context: String
+    /// Optional path to the Dockerfile within the context
+    let dockerfile: String?
+    /// Build arguments
+    let args: [String: String]?
+
+    /// Custom initializer to handle `build: .` (string) or `build: { context: . }` (object)
+    init(from decoder: Decoder) throws {
+        let container = try decoder.singleValueContainer()
+        if let contextString = try? container.decode(String.self) {
+            self.context = contextString
+            self.dockerfile = nil
+            self.args = nil
+        } else {
+            let keyedContainer = try decoder.container(keyedBy: CodingKeys.self)
+            self.context = try keyedContainer.decode(String.self, forKey: .context)
+            self.dockerfile = try keyedContainer.decodeIfPresent(String.self, forKey: .dockerfile)
+            self.args = try keyedContainer.decodeIfPresent([String: String].self, forKey: .args)
+        }
+    }
+
+    enum CodingKeys: String, CodingKey {
+        case context, dockerfile, args
+    }
+}

Sources/CLI/Compose/Codable Structs/Config.swift

@@ -0,0 +1,55 @@
+//===----------------------------------------------------------------------===//
+// Copyright © 2025 Apple Inc. and the container project authors. All rights reserved.
+//
+// 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.
+//===----------------------------------------------------------------------===//
+
+//
+//  Config.swift
+//  container-compose-app
+//
+//  Created by Morris Richman on 6/17/25.
+//
+
+
+/// Represents a top-level config definition (primarily for Swarm).
+struct Config: Codable {
+    /// Path to the file containing the config content
+    let file: String?
+    /// Indicates if the config is external (pre-existing)
+    let external: ExternalConfig?
+    /// Explicit name for the config
+    let name: String?
+    /// Labels for the config
+    let labels: [String: String]?
+
+    enum CodingKeys: String, CodingKey {
+        case file, external, name, labels
+    }
+
+    /// Custom initializer to handle `external: true` (boolean) or `external: { name: "my_cfg" }` (object).
+    init(from decoder: Decoder) throws {
+        let container = try decoder.container(keyedBy: CodingKeys.self)
+        file = try container.decodeIfPresent(String.self, forKey: .file)
+        name = try container.decodeIfPresent(String.self, forKey: .name)
+        labels = try container.decodeIfPresent([String: String].self, forKey: .labels)
+
+        if let externalBool = try? container.decodeIfPresent(Bool.self, forKey: .external) {
+            external = ExternalConfig(isExternal: externalBool, name: nil)
+        } else if let externalDict = try? container.decodeIfPresent([String: String].self, forKey: .external) {
+            external = ExternalConfig(isExternal: true, name: externalDict["name"])
+        } else {
+            external = nil
+        }
+    }
+}

Sources/CLI/Compose/Codable Structs/Deploy.swift

@@ -0,0 +1,35 @@
+//===----------------------------------------------------------------------===//
+// Copyright © 2025 Apple Inc. and the container project authors. All rights reserved.
+//
+// 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.
+//===----------------------------------------------------------------------===//
+
+//
+//  Deploy.swift
+//  container-compose-app
+//
+//  Created by Morris Richman on 6/17/25.
+//
+
+
+/// Represents the `deploy` configuration for a service (primarily for Swarm orchestration).
+struct Deploy: Codable, Hashable {
+    /// Deployment mode (e.g., 'replicated', 'global')
+    let mode: String?
+    /// Number of replicated service tasks
+    let replicas: Int?
+    /// Resource constraints (limits, reservations)
+    let resources: DeployResources?
+    /// Restart policy for tasks
+    let restart_policy: DeployRestartPolicy?
+}

Sources/CLI/Compose/Codable Structs/DeployResources.swift

@@ -0,0 +1,31 @@
+//===----------------------------------------------------------------------===//
+// Copyright © 2025 Apple Inc. and the container project authors. All rights reserved.
+//
+// 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.
+//===----------------------------------------------------------------------===//
+
+//
+//  DeployResources.swift
+//  container-compose-app
+//
+//  Created by Morris Richman on 6/17/25.
+//
+
+
+/// Resource constraints for deployment.
+struct DeployResources: Codable, Hashable {
+    /// Hard limits on resources
+    let limits: ResourceLimits?
+    /// Guarantees for resources
+    let reservations: ResourceReservations?
+}

Sources/CLI/Compose/Codable Structs/DeployRestartPolicy.swift

@@ -0,0 +1,35 @@
+//===----------------------------------------------------------------------===//
+// Copyright © 2025 Apple Inc. and the container project authors. All rights reserved.
+//
+// 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.
+//===----------------------------------------------------------------------===//
+
+//
+//  DeployRestartPolicy.swift
+//  container-compose-app
+//
+//  Created by Morris Richman on 6/17/25.
+//
+
+
+/// Restart policy for deployed tasks.
+struct DeployRestartPolicy: Codable, Hashable {
+    /// Condition to restart on (e.g., 'on-failure', 'any')
+    let condition: String?
+    /// Delay before attempting restart
+    let delay: String?
+    /// Maximum number of restart attempts
+    let max_attempts: Int?
+    /// Window to evaluate restart policy
+    let window: String?
+}

Sources/CLI/Compose/Codable Structs/DeviceReservation.swift

@@ -0,0 +1,35 @@
+//===----------------------------------------------------------------------===//
+// Copyright © 2025 Apple Inc. and the container project authors. All rights reserved.
+//
+// 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.
+//===----------------------------------------------------------------------===//
+
+//
+//  DeviceReservation.swift
+//  container-compose-app
+//
+//  Created by Morris Richman on 6/17/25.
+//
+
+
+/// Device reservations for GPUs or other devices.
+struct DeviceReservation: Codable, Hashable {
+    /// Device capabilities
+    let capabilities: [String]?
+    /// Device driver
+    let driver: String?
+    /// Number of devices
+    let count: String?
+    /// Specific device IDs
+    let device_ids: [String]?
+}

Sources/CLI/Compose/Codable Structs/DockerCompose.swift

@@ -0,0 +1,60 @@
+//===----------------------------------------------------------------------===//
+// Copyright © 2025 Apple Inc. and the container project authors. All rights reserved.
+//
+// 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.
+//===----------------------------------------------------------------------===//
+
+//
+//  DockerCompose.swift
+//  container-compose-app
+//
+//  Created by Morris Richman on 6/17/25.
+//
+
+
+/// Represents the top-level structure of a docker-compose.yml file.
+struct DockerCompose: Codable {
+    /// The Compose file format version (e.g., '3.8')
+    let version: String?
+    /// Optional project name
+    let name: String?
+    /// Dictionary of service definitions, keyed by service name
+    let services: [String: Service]
+    /// Optional top-level volume definitions
+    let volumes: [String: Volume]?
+    /// Optional top-level network definitions
+    let networks: [String: Network]?
+    /// Optional top-level config definitions (primarily for Swarm)
+    let configs: [String: Config]?
+    /// Optional top-level secret definitions (primarily for Swarm)
+    let secrets: [String: Secret]?
+
+    init(from decoder: Decoder) throws {
+        let container = try decoder.container(keyedBy: CodingKeys.self)
+        version = try container.decodeIfPresent(String.self, forKey: .version)
+        name = try container.decodeIfPresent(String.self, forKey: .name)
+        services = try container.decode([String: Service].self, forKey: .services)
+
+        if let volumes = try container.decodeIfPresent([String: Optional<Volume>].self, forKey: .volumes) {
+            let safeVolumes: [String : Volume] = volumes.mapValues { value in
+                value ?? Volume()
+            }
+            self.volumes = safeVolumes
+        } else {
+            self.volumes = nil
+        }
+        networks = try container.decodeIfPresent([String: Network].self, forKey: .networks)
+        configs = try container.decodeIfPresent([String: Config].self, forKey: .configs)
+        secrets = try container.decodeIfPresent([String: Secret].self, forKey: .secrets)
+    }
+}

Sources/CLI/Compose/Codable Structs/ExternalConfig.swift

@@ -0,0 +1,31 @@
+//===----------------------------------------------------------------------===//
+// Copyright © 2025 Apple Inc. and the container project authors. All rights reserved.
+//
+// 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.
+//===----------------------------------------------------------------------===//
+
+//
+//  ExternalConfig.swift
+//  container-compose-app
+//
+//  Created by Morris Richman on 6/17/25.
+//
+
+
+/// Represents an external config reference.
+struct ExternalConfig: Codable {
+    /// True if the config is external
+    let isExternal: Bool
+    /// Optional name of the external config if different from key
+    let name: String?
+}