Overview on pgmi

TypeScript

Mon, 01 Jan 0001 00:00:00 +0000

TypeScript Client Generation#

Scope: advanced template API surface. This guide consumes REST/RPC endpoints generated by the advanced template — it is not a client for the pgmi deployment CLI.

Generate TypeScript types and a fetch-based client from your deployment’s /openapi.json.

openapi-typescript (types only)#

Generates TypeScript types from the spec. Pair with openapi-fetch for a typed fetch wrapper.

npx openapi-typescript http://localhost:3000/openapi.json -o src/api.d.ts

Use the types with openapi-fetch:

import createClient from "openapi-fetch";
import type { paths } from "./api";

const client = createClient<paths>({ baseUrl: "http://localhost:3000" });

const { data, error } = await client.GET("/hello", {
 params: { query: { name: "World" } },
});

openapi-generator (full client)#

Generates a complete client with models and API classes:

Go

Mon, 01 Jan 0001 00:00:00 +0000

Go Client Generation#

Scope: advanced template API surface. This guide consumes REST/RPC endpoints generated by the advanced template — it is not a client for the pgmi deployment CLI.

Generate Go types and client code from your deployment’s /openapi.json.

oapi-codegen#

The standard Go OpenAPI code generator. Produces types, client, and server stubs.

go install github.com/oapi-codegen/oapi-codegen/v2/cmd/oapi-codegen@latest

# Generate types + client
oapi-codegen -generate types,client \
 -package api \
 -o api/client.gen.go \
 http://localhost:3000/openapi.json

Usage:

Python

Mon, 01 Jan 0001 00:00:00 +0000

Python Client Generation#

Scope: advanced template API surface. This guide consumes REST/RPC endpoints generated by the advanced template — it is not a client for the pgmi deployment CLI.

Generate a typed Python client from your deployment’s /openapi.json.

openapi-python-client#

Generates a complete Python package with Pydantic models and an httpx-based client.

pip install openapi-python-client

# Generate client package
openapi-python-client generate \
 --url http://localhost:3000/openapi.json \
 --output-path ./api-client

Usage:

from api_client import Client
from api_client.api.default import hello_world

client = Client(base_url="http://localhost:3000")
response = hello_world.sync(client=client, name="World")
print(response.message)

# Async
response = await hello_world.asyncio(client=client, name="World")

Updating#

When handlers change, regenerate:

C#

Mon, 01 Jan 0001 00:00:00 +0000

C# Client Generation#

Scope: advanced template API surface. This guide consumes REST/RPC endpoints generated by the advanced template — it is not a client for the pgmi deployment CLI.

Generate a typed C# client from your deployment’s /openapi.json.

NSwag#

NSwag generates C# clients with full async support. Install via dotnet tool or NuGet.

dotnet tool install -g NSwag.ConsoleCore

# Generate client
nswag openapi2csclient \
 /input:http://localhost:3000/openapi.json \
 /output:ApiClient.cs \
 /namespace:MyProject.Api \
 /generateClientClasses:true \
 /generateDtoTypes:true

Usage:

Generic (any language)

Mon, 01 Jan 0001 00:00:00 +0000

Generic Client Generation (Any Language)#

Scope: advanced template API surface. This guide consumes REST/RPC endpoints generated by the advanced template — it is not a client for the pgmi deployment CLI.

The OpenAPI Generator project supports 50+ languages and frameworks. Use it when no language-specific tool is a better fit.

openapi-generator#

# Install via npm, Homebrew, or Docker
npm install -g @openapitools/openapi-generator-cli

# List available generators
openapi-generator-cli list

# Generate a client
openapi-generator-cli generate \
 -i http://localhost:3000/openapi.json \
 -g <generator-name> \
 -o ./generated-client

Common generators:

HTTP collections

Mon, 01 Jan 0001 00:00:00 +0000

HTTP Collections#

Scope: advanced template API surface. This guide consumes REST/RPC endpoints generated by the advanced template — it is not a client for the pgmi deployment CLI.

For ad-hoc API exploration without codegen, generate importable request files from /openapi.json.

VS Code REST Client (.http files)#

Generate .http files from the spec using jq:

curl -s http://localhost:3000/openapi.json | jq -r '
 .paths | to_entries[] | .key as $path |
 .value | to_entries[] |
 "\(.key | ascii_upcase) http://localhost:3000\($path)\n\n###\n"
' > api-requests.http

Open api-requests.http in VS Code with the REST Client extension. Click “Send Request” above any block.