build openapi spec from golang annotations

.github/workflows/openapi2_golang_build.yaml

@@ -0,0 +1,35 @@
+on: 
+  workflow_call:
+    inputs:
+      entrypoint:
+        required: true
+        type: string
+        default: "main.go"
+
+jobs:
+  build_with_swagger:
+    runs-on: ubuntu-latest
+    if: "!startsWith(github.ref, 'refs/tags/')"
+    container:
+      image: cubicrootxyz/golang-ci:v1.23.0
+      options: --user root
+    steps:
+      - name: Checkout the repository
+        uses: actions/checkout@v3
+        with:
+          ref: ${{ github.head_ref }}
+      - uses: actions/setup-node@v3
+        with:
+          node-version: "14"
+      - name: Get dependencies
+        run: go get ./...
+      - name: Make docs folder
+        run: mkdir -p docs
+      - name: Build the api documentation
+        run: swag init --parseDependency=true -d . -g ${{ inputs.entrypoint }}
+      - name: Archive OpenAPI spec
+        uses: actions/upload-artifact@v4
+        with:
+          name: openapi-spec
+          path: |
+            docs/

.github/workflows/openapi2_golang_build_test.yaml

@@ -0,0 +1,7 @@
+on: push
+
+jobs:
+  openapi2_golang_build_test:
+    uses: ./.github/workflows/openapi2_golang_build.yaml
+    with:
+      entrypoint: tests/openapi2/main.go

tests/openapi2/go.mod

@@ -0,0 +1,3 @@
+module openapi2
+
+go 1.23.0

tests/openapi2/main.go

@@ -0,0 +1,22 @@
+package main
+
+import (
+	"os"
+)
+
+// @title Matrix Reminder and Calendar Bot (RemindMe)
+// @version 2.0.0
+// @description API documentation for the matrix reminder and calendar bot.
+
+// @contact.name Support
+
+// @host your-bot-domain.tld
+// @BasePath /
+// @query.collection.format multi
+
+// @securityDefinitions.apikey APIKeyAuthentication
+// @in header
+// @name Authorization
+func main() {
+	os.Exit(0)
+}