Some more taskfile improvements (#1382)

* Merge swagger-gen into docs.
* Rename mock-gen to gen, since it is a general-purpose code gen command.

Author: dmjb

.github/workflows/verify-swagger.yml renamed to .github/workflows/verify-gen.yml

@@ -1,4 +1,4 @@
-name: Swagger
+name: Codegen
 
 on:
   workflow_call:
@@ -8,7 +8,7 @@ permissions:
 
 jobs:
   swagger:
-    name: Verify Swagger
+    name: Verify code generation
     runs-on: ubuntu-latest
 
     steps:
@@ -21,16 +21,16 @@ jobs:
         with:
           version: 3.x
           repo-token: ${{ secrets.GITHUB_TOKEN }}
-      - name: Install swagger
-        run: task swagger-install
-      - name: Generate swagger files
-        run: task swagger-gen
+      - name: Install mockgen
+        run: task mock-install
+      - name: Generate code files
+        run: task gen
       - name: Check for changes
         run: |
           if ! git diff --exit-code docs/server/; then
-            echo "❌ Swagger files are not up to date!"
-            echo "Please run 'task swagger-gen' or 'swag init -g pkg/api/server.go --v3.1 -o docs/server' and commit the changes."
+            echo "❌ Generated code files are not up to date!"
+            echo "Please run 'task gen' and commit the changes."
             exit 1
           else
-            echo "✅ Swagger files are up to date!"
+            echo "✅ Generated code files are up to date!"
           fi

CLAUDE.md

@@ -41,8 +41,8 @@ task test-e2e
 # Run all tests (unit and e2e)
 task test-all
 
-# Generate OpenAPI/Swagger documentation
-task swagger-gen
+# Generate mocks
+task gen
 
 # Generate CLI documentation
 task docs

Taskfile.yml

@@ -8,27 +8,23 @@ includes:
 tasks:
   docs:
     desc: Regenerate the docs
+    deps: [swagger-install]
     cmds:
       - rm -rf docs/cli/*
       - go run cmd/help/main.go --dir docs/cli
+      - swag init -g pkg/api/server.go --v3.1 -o docs/server
 
   swagger-install:
     desc: Install the swag tool for OpenAPI/Swagger generation
     cmds:
       - go install github.com/swaggo/swag/v2/cmd/swag@latest
 
-  swagger-gen:
-    desc: Generate OpenAPI/Swagger documentation
-    deps: [swagger-install]
-    cmds:
-      - swag init -g pkg/api/server.go --v3.1 -o docs/server
-
   mock-install:
     desc: Install the mockgen tool for mock generation
     cmds:
       - go install go.uber.org/mock/mockgen@latest
 
-  mock-gen:
+  gen:
     desc: Generate mock files using go generate
     deps: [mock-install]
     cmds:
@@ -64,7 +60,7 @@ tasks:
 
   test:
     desc: Run unit tests (excluding e2e tests)
-    deps: [mock-gen]
+    deps: [gen]
     cmds:
       - task: test-unixlike
         platforms: [linux, darwin]
@@ -140,7 +136,7 @@ tasks:
 
   build:
     desc: Build the binary
-    deps: [mock-gen]
+    deps: [gen]
     vars:
       VERSION:
         sh: git describe --tags --always --dirty --match "v*" || echo "dev"