feat: add OpenAPI/Swagger spec module for auto-generating HTTP routes

example/openapi-petstore.yaml

@@ -0,0 +1,35 @@
+requires:
+  plugins:
+    - name: workflow-plugin-http
+    - name: workflow-plugin-openapi
+
+modules:
+  # HTTP server on port 8095
+  - name: petstore-server
+    type: http.server
+    config:
+      address: ":8095"
+
+  # HTTP router — the OpenAPI module registers routes onto this
+  - name: petstore-router
+    type: http.router
+    dependsOn:
+      - petstore-server
+
+  # OpenAPI module — parses the spec and generates routes
+  - name: pet-store-api
+    type: openapi
+    dependsOn:
+      - petstore-router
+    config:
+      # NOTE: spec_file is resolved relative to this config file's directory
+      # via the _config_dir mechanism in config.ResolvePathInConfig.
+      spec_file: specs/petstore.yaml
+      base_path: /api/v1
+      router: petstore-router
+      validation:
+        request: true
+        response: false
+      swagger_ui:
+        enabled: true
+        path: /docs

example/specs/petstore.yaml

@@ -0,0 +1,97 @@
+openapi: "3.0.0"
+info:
+  title: Petstore API
+  version: "1.0.0"
+  description: A sample pet store API based on the OpenAPI 3.0 Petstore example
+
+paths:
+  /pets:
+    get:
+      operationId: listPets
+      summary: List all pets
+      parameters:
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: integer
+            minimum: 1
+            maximum: 100
+      responses:
+        "200":
+          description: A list of pets
+        "400":
+          description: Invalid request
+    post:
+      operationId: createPet
+      summary: Create a pet
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required:
+                - name
+              properties:
+                name:
+                  type: string
+                  minLength: 1
+                  maxLength: 100
+                tag:
+                  type: string
+                  maxLength: 50
+      responses:
+        "201":
+          description: Null response
+        "400":
+          description: Validation error
+
+  /pets/{petId}:
+    get:
+      operationId: showPetById
+      summary: Info for a specific pet
+      parameters:
+        - name: petId
+          in: path
+          required: true
+          schema:
+            type: integer
+      responses:
+        "200":
+          description: Expected response to a valid request
+        "404":
+          description: Pet not found
+
+  /pets/{petId}/status:
+    put:
+      operationId: updatePetStatus
+      summary: Update pet status
+      parameters:
+        - name: petId
+          in: path
+          required: true
+          schema:
+            type: integer
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required:
+                - status
+              properties:
+                status:
+                  type: string
+                  enum:
+                    - available
+                    - pending
+                    - sold
+      responses:
+        "200":
+          description: Updated
+        "400":
+          description: Invalid status
+        "404":
+          description: Pet not found