d6eec4d240
New command group for OpenAPI spec generation and SDK codegen: - `core api spec` generates OpenAPI 3.1 spec (JSON/YAML) from route groups - `core api sdk` generates client SDKs via openapi-generator-cli - Adds go-api dependency for SpecBuilder, ExportSpec, SDKGenerator Co-Authored-By: Virgil <virgil@lethean.io> Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
87 lines
2.5 KiB
Go
87 lines
2.5 KiB
Go
// SPDX-License-Identifier: EUPL-1.2
|
|
|
|
package api
|
|
|
|
import (
|
|
"context"
|
|
"fmt"
|
|
"os"
|
|
"strings"
|
|
|
|
"forge.lthn.ai/core/go/pkg/cli"
|
|
|
|
goapi "forge.lthn.ai/core/go-api"
|
|
)
|
|
|
|
func addSDKCommand(parent *cli.Command) {
|
|
var (
|
|
lang string
|
|
output string
|
|
specFile string
|
|
packageName string
|
|
)
|
|
|
|
cmd := cli.NewCommand("sdk", "Generate client SDKs from OpenAPI spec", "", func(cmd *cli.Command, args []string) error {
|
|
if lang == "" {
|
|
return fmt.Errorf("--lang is required. Supported: %s", strings.Join(goapi.SupportedLanguages(), ", "))
|
|
}
|
|
|
|
// If no spec file provided, generate one to a temp file.
|
|
if specFile == "" {
|
|
builder := &goapi.SpecBuilder{
|
|
Title: "Lethean Core API",
|
|
Description: "Lethean Core API",
|
|
Version: "1.0.0",
|
|
}
|
|
|
|
bridge := goapi.NewToolBridge("/tools")
|
|
groups := []goapi.RouteGroup{bridge}
|
|
|
|
tmpFile, err := os.CreateTemp("", "openapi-*.json")
|
|
if err != nil {
|
|
return fmt.Errorf("create temp spec file: %w", err)
|
|
}
|
|
defer os.Remove(tmpFile.Name())
|
|
|
|
if err := goapi.ExportSpec(tmpFile, "json", builder, groups); err != nil {
|
|
tmpFile.Close()
|
|
return fmt.Errorf("generate spec: %w", err)
|
|
}
|
|
tmpFile.Close()
|
|
specFile = tmpFile.Name()
|
|
}
|
|
|
|
gen := &goapi.SDKGenerator{
|
|
SpecPath: specFile,
|
|
OutputDir: output,
|
|
PackageName: packageName,
|
|
}
|
|
|
|
if !gen.Available() {
|
|
fmt.Fprintln(os.Stderr, "openapi-generator-cli not found. Install with:")
|
|
fmt.Fprintln(os.Stderr, " brew install openapi-generator (macOS)")
|
|
fmt.Fprintln(os.Stderr, " npm install @openapitools/openapi-generator-cli -g")
|
|
return fmt.Errorf("openapi-generator-cli not installed")
|
|
}
|
|
|
|
// Generate for each language.
|
|
languages := strings.Split(lang, ",")
|
|
for _, l := range languages {
|
|
l = strings.TrimSpace(l)
|
|
fmt.Fprintf(os.Stderr, "Generating %s SDK...\n", l)
|
|
if err := gen.Generate(context.Background(), l); err != nil {
|
|
return fmt.Errorf("generate %s: %w", l, err)
|
|
}
|
|
fmt.Fprintf(os.Stderr, " Done: %s/%s/\n", output, l)
|
|
}
|
|
|
|
return nil
|
|
})
|
|
|
|
cli.StringFlag(cmd, &lang, "lang", "l", "", "Target language(s), comma-separated (e.g. go,python,typescript-fetch)")
|
|
cli.StringFlag(cmd, &output, "output", "o", "./sdk", "Output directory for generated SDKs")
|
|
cli.StringFlag(cmd, &specFile, "spec", "s", "", "Path to existing OpenAPI spec (generates from MCP tools if not provided)")
|
|
cli.StringFlag(cmd, &packageName, "package", "p", "lethean", "Package name for generated SDK")
|
|
|
|
parent.AddCommand(cmd)
|
|
}
|