Bump to 1.0.0-alpha.1 (#400)

Bump to 1.0.0-alpha.1

### Motivation

Prep for 1.0.0-alpha.1.

### Modifications

Bumped documentation and upstream SOAR dependencies to 1.0.0-alpha.1.

Note that because the generator itself is not yet released, the integration test and examples will fail to build, but that's the unfortunate nature of having examples projects in the same repo as the project itself. But it's important that once this repo is tagged, that the examples/integration tests included use the right tags, so I don't think there's another way to stage this in.

### Result

Ready to tag 1.0.0-alpha.1.

### Test Plan

Temporarily modified the generator dependency in examples/integration tests to point to `main` and verified all works. Then changed it back.

All other tests pass.


Reviewed by: simonjbeaumont

Builds:
     ✔︎ pull request validation (5.10) - Build finished. 
     ✔︎ pull request validation (5.9) - Build finished. 
     ✔︎ pull request validation (compatibility test) - Build finished. 
     ✔︎ pull request validation (docc test) - Build finished. 
     ✔︎ pull request validation (nightly) - Build finished. 
     ✔︎ pull request validation (soundness) - Build finished. 
     ✖︎ pull request validation (integration test) - Build finished. 

#400

Author: czechboy0

Examples/GreetingService/Package.swift

@@ -18,9 +18,9 @@ let package = Package(
     name: "GreetingService",
     platforms: [.macOS(.v13)],
     dependencies: [
-        .package(url: "https://github.com/apple/swift-openapi-generator", .upToNextMinor(from: "0.3.0")),
-        .package(url: "https://github.com/apple/swift-openapi-runtime", .upToNextMinor(from: "0.3.0")),
-        .package(url: "https://github.com/swift-server/swift-openapi-vapor", .upToNextMinor(from: "0.3.0")),
+        .package(url: "https://github.com/apple/swift-openapi-generator", exact: "1.0.0-alpha.1"),
+        .package(url: "https://github.com/apple/swift-openapi-runtime", exact: "1.0.0-alpha.1"),
+        .package(url: "https://github.com/swift-server/swift-openapi-vapor", exact: "1.0.0-alpha.1"),
         .package(url: "https://github.com/vapor/vapor", from: "4.76.0"),
     ],
     targets: [
@@ -35,7 +35,11 @@ let package = Package(
         ),
         .testTarget(
             name: "GreetingServiceMockTests",
-            dependencies: ["GreetingService", .product(name: "OpenAPIRuntime", package: "swift-openapi-runtime")]
+            dependencies: [
+                "GreetingService", .product(name: "OpenAPIRuntime", package: "swift-openapi-runtime"),
+                .product(name: "OpenAPIVapor", package: "swift-openapi-vapor"),
+                .product(name: "Vapor", package: "vapor"),
+            ]
         ),
     ]
 )

Examples/GreetingServiceClient/Package.swift

@@ -1,4 +1,4 @@
-// swift-tools-version:5.8
+// swift-tools-version:5.9
 //===----------------------------------------------------------------------===//
 //
 // This source file is part of the SwiftOpenAPIGenerator open source project
@@ -18,9 +18,9 @@ let package = Package(
     name: "GreetingServiceClient",
     platforms: [.macOS(.v13)],
     dependencies: [
-        .package(url: "https://github.com/apple/swift-openapi-generator", .upToNextMinor(from: "0.3.0")),
-        .package(url: "https://github.com/apple/swift-openapi-runtime", .upToNextMinor(from: "0.3.0")),
-        .package(url: "https://github.com/apple/swift-openapi-urlsession", .upToNextMinor(from: "0.3.0")),
+        .package(url: "https://github.com/apple/swift-openapi-generator", exact: "1.0.0-alpha.1"),
+        .package(url: "https://github.com/apple/swift-openapi-runtime", exact: "1.0.0-alpha.1"),
+        .package(url: "https://github.com/apple/swift-openapi-urlsession", exact: "1.0.0-alpha.1"),
     ],
     targets: [
         .executableTarget(
@@ -30,6 +30,13 @@ let package = Package(
                 .product(name: "OpenAPIURLSession", package: "swift-openapi-urlsession"),
             ],
             plugins: [.plugin(name: "OpenAPIGenerator", package: "swift-openapi-generator")]
-        )
+        ),
+        .testTarget(
+            name: "GreetingServiceMockTests",
+            dependencies: [
+                "GreetingServiceClient", .product(name: "OpenAPIRuntime", package: "swift-openapi-runtime"),
+                .product(name: "OpenAPIURLSession", package: "swift-openapi-urlsession"),
+            ]
+        ),
     ]
 )

Examples/GreetingServiceClient/Tests/GreetingServiceMockTests/MockGreetingService.swift

@@ -11,7 +11,7 @@
 // SPDX-License-Identifier: Apache-2.0
 //
 //===----------------------------------------------------------------------===//
-import GreetingService
+import GreetingServiceClient
 
 // Mock operates on value types, and requires no concrete client or server transport.
 struct MockGreetingService: APIProtocol {

Examples/GreetingServiceClient/Tests/GreetingServiceMockTests/MockGreetingServiceTests.swift

@@ -12,7 +12,7 @@
 //
 //===----------------------------------------------------------------------===//
 import XCTest
-@testable import GreetingService
+@testable import GreetingServiceClient
 
 final class GreetingServiceMockTests: XCTestCase {
     func testWithMock() async throws {

IntegrationTest/Package.swift

@@ -24,8 +24,8 @@ let package = Package(
         )
     ],
     dependencies: [
-        .package(url: "https://github.com/apple/swift-openapi-generator", .upToNextMinor(from: "0.3.0")),
-        .package(url: "https://github.com/apple/swift-openapi-runtime", .upToNextMinor(from: "0.3.0")),
+        .package(url: "https://github.com/apple/swift-openapi-generator", exact: "1.0.0-alpha.1"),
+        .package(url: "https://github.com/apple/swift-openapi-runtime", exact: "1.0.0-alpha.1"),
     ],
     targets: [
         .target(

IntegrationTest/README.md

@@ -1,4 +1,4 @@
-# Simple Integration Test
+# Integration Test
 
 A Swift package used as an integration test in the Swift OpenAPI Generator ecosystem.
 
@@ -11,7 +11,7 @@ For example, from the pull request pipeline for that project, you can do the fol
 ```sh
 # Clone the generator repo and go into the integration test directory
 git clone https://github.com/apple/swift-openapi-generator
-cd swift-openapi-generator/IntegrationTests/Simple
+cd swift-openapi-generator/IntegrationTests
 
 # Use Swift PM to override the dependency for the package you want to test
 swift package edit swift-openapi-runtime path/to/checkout/of/swift-openapi-runtime

Package.swift

@@ -60,7 +60,7 @@ let package = Package(
         // Tests-only: Runtime library linked by generated code, and also
         // helps keep the runtime library new enough to work with the generated
         // code.
-        .package(url: "https://github.com/apple/swift-openapi-runtime", branch: "main"),
+        .package(url: "https://github.com/apple/swift-openapi-runtime", exact: "1.0.0-alpha.1"),
 
         // Build and preview docs
         .package(url: "https://github.com/apple/swift-docc-plugin", from: "1.0.0"),

Sources/swift-openapi-generator/Documentation.docc/Tutorials/_Resources/client.Package.2.swift

@@ -10,9 +10,9 @@ let package = Package(
         .watchOS(.v6),
     ],
     dependencies: [
-        .package(url: "https://github.com/apple/swift-openapi-generator", .upToNextMinor(from: "0.3.0")),
-        .package(url: "https://github.com/apple/swift-openapi-runtime", .upToNextMinor(from: "0.3.0")),
-        .package(url: "https://github.com/apple/swift-openapi-urlsession", .upToNextMinor(from: "0.3.0")),
+        .package(url: "https://github.com/apple/swift-openapi-generator", exact: "1.0.0-alpha.1"),
+        .package(url: "https://github.com/apple/swift-openapi-runtime", exact: "1.0.0-alpha.1"),
+        .package(url: "https://github.com/apple/swift-openapi-urlsession", exact: "1.0.0-alpha.1"),
     ],
     targets: [
         .executableTarget(

Sources/swift-openapi-generator/Documentation.docc/Tutorials/_Resources/client.Package.3.swift

@@ -10,9 +10,9 @@ let package = Package(
         .watchOS(.v6),
     ],
     dependencies: [
-        .package(url: "https://github.com/apple/swift-openapi-generator", .upToNextMinor(from: "0.3.0")),
-        .package(url: "https://github.com/apple/swift-openapi-runtime", .upToNextMinor(from: "0.3.0")),
-        .package(url: "https://github.com/apple/swift-openapi-urlsession", .upToNextMinor(from: "0.3.0")),
+        .package(url: "https://github.com/apple/swift-openapi-generator", exact: "1.0.0-alpha.1"),
+        .package(url: "https://github.com/apple/swift-openapi-runtime", exact: "1.0.0-alpha.1"),
+        .package(url: "https://github.com/apple/swift-openapi-urlsession", exact: "1.0.0-alpha.1"),
     ],
     targets: [
         .executableTarget(

Sources/swift-openapi-generator/Documentation.docc/Tutorials/_Resources/client.Package.4.swift

@@ -10,9 +10,9 @@ let package = Package(
         .watchOS(.v6),
     ],
     dependencies: [
-        .package(url: "https://github.com/apple/swift-openapi-generator", .upToNextMinor(from: "0.3.0")),
-        .package(url: "https://github.com/apple/swift-openapi-runtime", .upToNextMinor(from: "0.3.0")),
-        .package(url: "https://github.com/apple/swift-openapi-urlsession", .upToNextMinor(from: "0.3.0")),
+        .package(url: "https://github.com/apple/swift-openapi-generator", exact: "1.0.0-alpha.1"),
+        .package(url: "https://github.com/apple/swift-openapi-runtime", exact: "1.0.0-alpha.1"),
+        .package(url: "https://github.com/apple/swift-openapi-urlsession", exact: "1.0.0-alpha.1"),
     ],
     targets: [
         .executableTarget(