apigen

module
v0.3.4 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 13, 2026 License: MIT

README

Syfon API Generation

apigen is the committed OpenAPI generation output for Syfon.

Overview

Syfon uses oapi-codegen v2.8.0 with its native Fiber v3 server generator. The generated packages under apigen/* are committed to the repository so the runtime boundary is visible in code review.

Each API has one generated package containing its models, client bindings, and Fiber v3 server bindings. The generated packages are drs, lfsapi, bucketapi, metricsapi, and internalapi. Their shared error envelope is defined once in openapi/error.openapi.yaml and generated into errorapi.

Package paths

The combined package is the supported import path for generated APIs. Migrate imports as follows:

Old import Current import
github.com/calypr/syfon/apigen/client/drs github.com/calypr/syfon/apigen/drs
github.com/calypr/syfon/apigen/server/drs github.com/calypr/syfon/apigen/drs
github.com/calypr/syfon/apigen/client/<pkg> github.com/calypr/syfon/apigen/<pkg>
github.com/calypr/syfon/apigen/server/<pkg> github.com/calypr/syfon/apigen/<pkg>

The DRS package is apigen/drs, not apigen/drsapi. Each current package contains the generated models, client methods, and Fiber server methods for that API. The apigen/errorapi package owns the shared error definitions.

The N200ServiceInfo... names in apigen/drs/compat.go are compatibility aliases for generated DRS field names. They do not create another package path.

Module release order

Release the apigen module before releasing a client version that requires it. Tag apigen/vX.Y.Z, update the client requirement to that version, and then run the client checks with GOWORK=off. The release check must resolve the published github.com/calypr/syfon/apigen module without a local replace directive. The repository go.work file is for local development only.

The generator configs live in apigen/codegen/:

  • oapi-drs.yaml
  • oapi-internal.yaml
  • oapi-lfs.yaml
  • oapi-metrics.yaml
  • oapi-bucket.yaml

The configs use the native Fiber v3 and strict-server templates from the pinned generator. A small client-with-responses.tmpl compatibility override remains for preserving the SDK's handling of malformed non-2xx response bodies.

Regeneration

Use make gen from the repo root when changing:

  • the OpenAPI specs in apigen/openapi/*.openapi.yaml
  • the generator configs in apigen/codegen/*

The generated code is then consumed by:

  • cmd/server
  • internal/httpapi/buckets
  • internal/httpapi/drs
  • internal/httpapi/lfs
  • internal/httpapi/metrics
  • internal/httpapi/records
  • internal/httpapi/transfers
Upstream reference

The upstream generator docs are here:

oapi-codegen

Directories

Path Synopsis
Package bucketapi provides primitives to interact with the openapi HTTP API.
Package bucketapi provides primitives to interact with the openapi HTTP API.
Package drs provides primitives to interact with the openapi HTTP API.
Package drs provides primitives to interact with the openapi HTTP API.
Package errorapi provides primitives to interact with the openapi HTTP API.
Package errorapi provides primitives to interact with the openapi HTTP API.
Package internalapi provides primitives to interact with the openapi HTTP API.
Package internalapi provides primitives to interact with the openapi HTTP API.
Package lfsapi provides primitives to interact with the openapi HTTP API.
Package lfsapi provides primitives to interact with the openapi HTTP API.
Package metricsapi provides primitives to interact with the openapi HTTP API.
Package metricsapi provides primitives to interact with the openapi HTTP API.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL