Add ability to regenerate all packages' docs at once by manually invoking deploy flow

Author: gwynne

.github/workflows/deploy-api-docs.yml

@@ -3,12 +3,19 @@ on:
   push:
     branches:
       - main
+  workflow_dispatch:
+    inputs:
+      regenerate_all:
+        description: "Force regeneration of every single package's API docs."
+        required: false
+        type: boolean
+        default: false
 
 jobs:
   deploy:
     name: Build and deploy
     runs-on: ubuntu-latest
-    container: swift:5.8
+    container: swiftlang/swift:nightly-5.9-jammy@sha256:a3c3ec5e4436c14e44759e38416bb0d46813dc6dd050e787ef3a80b2c3051a36
     steps:
       - name: Checkout
         uses: actions/checkout@v3
@@ -20,6 +27,33 @@ jobs:
           curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
           unzip awscliv2.zip
           ./aws/install
+      - name: Regenerate all API docs if requested
+        if: inputs.regenerate_all
+        shell: bash
+        run: |
+          curl -sL \
+            https://raw.githubusercontent.com/vapor/api-docs/main/generate-package-api-docs.swift -o generate-package-api-docs.swift \
+            https://raw.githubusercontent.com/vapor/api-docs/main/theme-settings.json -o theme-settings.json            
+          for item in \
+            vapor:Vapor vapor:XCTVapor \
+            async-kit:AsyncKit routing-kit:RoutingKit console-kit:ConsoleKit \
+            websocket-kit:WebSocketKit multipart-kit:MultipartKit \
+            postgres-nio:PostgresNIO mysql-nio:MySQLNIO sqlite-nio:SQLiteNIO sql-kit:SQLKit \
+            postgres-kit:PostgresKit mysql-kit:MySQLKit sqlite-kit:SQLiteKit fluent-kit:FluentKit \
+            fluent-kit:FluentSQL fluent-kit:XCTFluent fluent:Fluent fluent-postgres-driver:FluentPostgresDriver \
+            fluent-mongo-driver:FluentMongoDriver fluent-mysql-driver:FluentMySQLDriver fluent-sqlite-driver:FluentSQLiteDriver \
+            redis:Redis queues-redis-driver:QueuesRedisDriver queues:Queues queues:XCTQueues \
+            leaf-kit:LeafKit leaf:Leaf \
+            jwt-kit:JWTKit jwt:JWT apns:APNS \
+          do
+            repo=${item%:*} module=${item#*:}
+            if [[ ! -d ${repo} ]]; then
+                git clone https://github.com/vapor/${repo}.git ${repo}
+            fi
+            cp theme-settings.json ${repo}
+            (cd ${repo} && swift ../generate-package-api-docs.swift ${repo} ${module})
+            cp -r ${repo}/public/* ./public
+          done
       - name: Configure AWS Credentials
         uses: aws-actions/configure-aws-credentials@v2
         with: