/trex.openapi.generate

Regenerate OpenAPI Client Code

Regenerate the Go client code from OpenAPI specifications. Run this after modifying any `openapi/*.yaml` files.

Instructions

Step 1: Verify Docker/Podman is Running

The generator uses a container to run the OpenAPI code generator:

podman info --format '{{.Host.RemoteSocket.Exists}}' 2>/dev/null || docker info --format '{{.ID}}' 2>/dev/null

If neither is running, inform the user that Docker or Podman is required.

Step 2: Run the Generator

make generate

This takes 2-3 minutes. It: 1. Builds a container image from `Dockerfile.openapi` 2. Runs the OpenAPI Generator inside the container 3. Copies generated Go files back into `pkg/api/openapi/`

Step 3: Verify Generated Files

ls -la pkg/api/openapi/model_*.go | head -20

Check for the expected model files for each Kind defined in the OpenAPI specs.

Step 4: Build to Confirm

make binary

When to Run This

• After creating a new Kind (part of `/trex.kind.new` workflow)
• After adding fields to an existing Kind's OpenAPI spec
• After modifying `openapi/openapi.yaml` or any `openapi/openapi.*.yaml` file
• After resolving merge conflicts in OpenAPI specs

Troubleshooting

• **"Cannot connect to Docker daemon"**: Start Docker/Podman first
• **Build fails after generation**: Check for type mismatches between your OpenAPI schema types and the presenter code
• **Missing model files**: Verify the schema name in `openapi.yaml` matches the `$ref` target exactly