Add container compose MVP for multi-service workflows

Package.swift

@@ -55,6 +55,7 @@ let package = Package(
         .package(url: "https://github.com/apple/swift-protobuf.git", from: "1.29.0"),
         .package(url: "https://github.com/apple/swift-system.git", from: "1.4.0"),
         .package(url: "https://github.com/grpc/grpc-swift.git", from: "1.26.0"),
+        .package(url: "https://github.com/jpsim/Yams.git", from: "5.1.3"),
         .package(url: "https://github.com/swift-server/async-http-client.git", from: "1.20.1"),
         .package(url: "https://github.com/swiftlang/swift-docc-plugin.git", from: "1.1.0"),
     ],
@@ -88,6 +89,7 @@ let package = Package(
                 .product(name: "ArgumentParser", package: "swift-argument-parser"),
                 .product(name: "Logging", package: "swift-log"),
                 .product(name: "SwiftProtobuf", package: "swift-protobuf"),
+                .product(name: "Yams", package: "Yams"),
                 .product(name: "Containerization", package: "containerization"),
                 .product(name: "ContainerizationOCI", package: "containerization"),
                 .product(name: "ContainerizationOS", package: "containerization"),
@@ -104,6 +106,12 @@ let package = Package(
             ],
             path: "Sources/ContainerCommands"
         ),
+        .testTarget(
+            name: "ContainerCommandsTests",
+            dependencies: [
+                "ContainerCommands"
+            ]
+        ),
         .target(
             name: "ContainerBuild",
             dependencies: [

README.md

@@ -9,6 +9,10 @@ The tool consumes and produces [OCI-compatible container images](https://github.
 
 `container` uses the [Containerization](https://github.com/apple/containerization) Swift package for low level container, image, and process management.
 
+The CLI also includes an MVP `container compose` workflow for running common multi-service development setups from `compose.yaml`, `compose.yml`, `docker-compose.yaml`, or `docker-compose.yml` files.
+
+For a short implementation and design summary of the feature, see the [Compose feature brief](./docs/compose-feature-brief.md).
+
 ![introductory movie showing some basic commands](./docs/assets/landing-movie.gif)
 
 ## Get started
@@ -80,6 +84,8 @@ To retain your user data so that it is available should you reinstall later, run
 - Learn how to [use various `container` features](./docs/how-to.md).
 - Read a brief description and [technical overview](./docs/technical-overview.md) of `container`.
 - Browse the [full command reference](./docs/command-reference.md).
+- Use [`container compose`](./docs/command-reference.md#container-compose) for supported Compose-based local development workflows.
+- Read the [Compose feature brief](./docs/compose-feature-brief.md) for implementation notes and current limits.
 - [Build and run](./BUILDING.md) `container` on your own development system.
 - View the project [API documentation](https://apple.github.io/container/documentation/).
 

Sources/ContainerCommands/Application.swift

@@ -75,6 +75,12 @@ public struct Application: AsyncLoggableCommand {
                     RegistryCommand.self,
                 ]
             ),
+            CommandGroup(
+                name: "Compose",
+                subcommands: [
+                    ComposeCommand.self
+                ]
+            ),
             CommandGroup(
                 name: "Volume",
                 subcommands: [