Files
pangolin/server/api/gen/server.gen.go
T
wangjia dd060fd34a feat(1d): wire oapi-codegen, generate types/server/client, add 501 stubs — tsk_Kp80nvHV2yLc
- Fix openapi.yaml: quote bearerAuth description that contained unquoted `: ` plain-scalar YAML
- Add server/api/cfg-{types,server,client}.yaml — oapi-codegen v2 config for three split outputs
- Add server/api/gen/gen.go — three //go:generate directives; run `make generate`
- Generate server/api/gen/{types,server,client}.gen.go from the contract (all 15 operations)
- Add github.com/oapi-codegen/runtime v1.4.1 to go.mod (runtime types needed by generated code)
- Add server/internal/httpapi/unimplemented.go — UnimplementedServer satisfies gen.ServerInterface;
  every method writes HTTP 501 + {code,message_zh,message_en} JSON body (no dep on task-1f apierr)
- Update server/cmd/server/main.go — mount /v1 API via gen.HandlerFromMuxWithBaseURL; keep /healthz
- Update server/Makefile — `generate` target now runs `go generate ./...`;
  add `check-generate` CI guard (regenerate + git diff --exit-code)
- Add server/internal/httpapi/unimplemented_test.go — 19 httptest cases covering all 15 API routes
  (501+body), undefined routes (404), and /healthz isolation

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-13 14:36:21 +08:00

904 lines
31 KiB
Go

// Package gen provides primitives to interact with the openapi HTTP API.
//
// Code generated by github.com/oapi-codegen/oapi-codegen/v2 version v2.7.1 DO NOT EDIT.
package gen
import (
"bytes"
"compress/flate"
"context"
"encoding/base64"
"errors"
"fmt"
"net/http"
"net/url"
"path"
"strings"
"github.com/getkin/kin-openapi/openapi3"
"github.com/go-chi/chi/v5"
"github.com/oapi-codegen/runtime"
openapi_types "github.com/oapi-codegen/runtime/types"
)
// ServerInterface represents all server handlers.
type ServerInterface interface {
// 激励视频广告解锁当日时长
// (POST /ads/unlock)
AdsUnlock(w http.ResponseWriter, r *http.Request)
// 发送邮箱验证码
// (POST /auth/code)
SendVerificationCode(w http.ResponseWriter, r *http.Request)
// 登录
// (POST /auth/login)
Login(w http.ResponseWriter, r *http.Request)
// 刷新 Access Token
// (POST /auth/refresh)
RefreshToken(w http.ResponseWriter, r *http.Request)
// 注册账户
// (POST /auth/register)
Register(w http.ResponseWriter, r *http.Request)
// 获取当前账户信息
// (GET /me)
GetMe(w http.ResponseWriter, r *http.Request)
// 获取设备列表
// (GET /me/devices)
ListDevices(w http.ResponseWriter, r *http.Request)
// 移除设备
// (DELETE /me/devices/{id})
DeleteDevice(w http.ResponseWriter, r *http.Request, id openapi_types.UUID)
// 获取节点目录
// (GET /nodes)
ListNodes(w http.ResponseWriter, r *http.Request, params ListNodesParams)
// 连接节点 — 下发连接凭证
// (POST /nodes/{id}/connect)
ConnectNode(w http.ResponseWriter, r *http.Request, id openapi_types.UUID)
// 断开节点连接
// (POST /nodes/{id}/disconnect)
DisconnectNode(w http.ResponseWriter, r *http.Request, id openapi_types.UUID)
// 获取公告列表
// (GET /notices)
ListNotices(w http.ResponseWriter, r *http.Request)
// 获取套餐目录
// (GET /plans)
ListPlans(w http.ResponseWriter, r *http.Request)
// 兑换激活码
// (POST /redeem)
RedeemCode(w http.ResponseWriter, r *http.Request)
// 获取用量曲线
// (GET /usage)
GetUsage(w http.ResponseWriter, r *http.Request, params GetUsageParams)
}
// Unimplemented server implementation that returns http.StatusNotImplemented for each endpoint.
type Unimplemented struct{}
// 激励视频广告解锁当日时长
// (POST /ads/unlock)
func (_ Unimplemented) AdsUnlock(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusNotImplemented)
}
// 发送邮箱验证码
// (POST /auth/code)
func (_ Unimplemented) SendVerificationCode(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusNotImplemented)
}
// 登录
// (POST /auth/login)
func (_ Unimplemented) Login(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusNotImplemented)
}
// 刷新 Access Token
// (POST /auth/refresh)
func (_ Unimplemented) RefreshToken(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusNotImplemented)
}
// 注册账户
// (POST /auth/register)
func (_ Unimplemented) Register(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusNotImplemented)
}
// 获取当前账户信息
// (GET /me)
func (_ Unimplemented) GetMe(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusNotImplemented)
}
// 获取设备列表
// (GET /me/devices)
func (_ Unimplemented) ListDevices(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusNotImplemented)
}
// 移除设备
// (DELETE /me/devices/{id})
func (_ Unimplemented) DeleteDevice(w http.ResponseWriter, r *http.Request, id openapi_types.UUID) {
w.WriteHeader(http.StatusNotImplemented)
}
// 获取节点目录
// (GET /nodes)
func (_ Unimplemented) ListNodes(w http.ResponseWriter, r *http.Request, params ListNodesParams) {
w.WriteHeader(http.StatusNotImplemented)
}
// 连接节点 — 下发连接凭证
// (POST /nodes/{id}/connect)
func (_ Unimplemented) ConnectNode(w http.ResponseWriter, r *http.Request, id openapi_types.UUID) {
w.WriteHeader(http.StatusNotImplemented)
}
// 断开节点连接
// (POST /nodes/{id}/disconnect)
func (_ Unimplemented) DisconnectNode(w http.ResponseWriter, r *http.Request, id openapi_types.UUID) {
w.WriteHeader(http.StatusNotImplemented)
}
// 获取公告列表
// (GET /notices)
func (_ Unimplemented) ListNotices(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusNotImplemented)
}
// 获取套餐目录
// (GET /plans)
func (_ Unimplemented) ListPlans(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusNotImplemented)
}
// 兑换激活码
// (POST /redeem)
func (_ Unimplemented) RedeemCode(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusNotImplemented)
}
// 获取用量曲线
// (GET /usage)
func (_ Unimplemented) GetUsage(w http.ResponseWriter, r *http.Request, params GetUsageParams) {
w.WriteHeader(http.StatusNotImplemented)
}
// ServerInterfaceWrapper converts contexts to parameters.
type ServerInterfaceWrapper struct {
Handler ServerInterface
HandlerMiddlewares []MiddlewareFunc
ErrorHandlerFunc func(w http.ResponseWriter, r *http.Request, err error)
}
type MiddlewareFunc func(http.Handler) http.Handler
// AdsUnlock operation middleware
func (siw *ServerInterfaceWrapper) AdsUnlock(w http.ResponseWriter, r *http.Request) {
ctx := r.Context()
ctx = context.WithValue(ctx, BearerAuthScopes, []string{})
r = r.WithContext(ctx)
handler := http.Handler(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
siw.Handler.AdsUnlock(w, r)
}))
for _, middleware := range siw.HandlerMiddlewares {
handler = middleware(handler)
}
handler.ServeHTTP(w, r)
}
// SendVerificationCode operation middleware
func (siw *ServerInterfaceWrapper) SendVerificationCode(w http.ResponseWriter, r *http.Request) {
handler := http.Handler(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
siw.Handler.SendVerificationCode(w, r)
}))
for _, middleware := range siw.HandlerMiddlewares {
handler = middleware(handler)
}
handler.ServeHTTP(w, r)
}
// Login operation middleware
func (siw *ServerInterfaceWrapper) Login(w http.ResponseWriter, r *http.Request) {
handler := http.Handler(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
siw.Handler.Login(w, r)
}))
for _, middleware := range siw.HandlerMiddlewares {
handler = middleware(handler)
}
handler.ServeHTTP(w, r)
}
// RefreshToken operation middleware
func (siw *ServerInterfaceWrapper) RefreshToken(w http.ResponseWriter, r *http.Request) {
handler := http.Handler(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
siw.Handler.RefreshToken(w, r)
}))
for _, middleware := range siw.HandlerMiddlewares {
handler = middleware(handler)
}
handler.ServeHTTP(w, r)
}
// Register operation middleware
func (siw *ServerInterfaceWrapper) Register(w http.ResponseWriter, r *http.Request) {
handler := http.Handler(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
siw.Handler.Register(w, r)
}))
for _, middleware := range siw.HandlerMiddlewares {
handler = middleware(handler)
}
handler.ServeHTTP(w, r)
}
// GetMe operation middleware
func (siw *ServerInterfaceWrapper) GetMe(w http.ResponseWriter, r *http.Request) {
ctx := r.Context()
ctx = context.WithValue(ctx, BearerAuthScopes, []string{})
r = r.WithContext(ctx)
handler := http.Handler(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
siw.Handler.GetMe(w, r)
}))
for _, middleware := range siw.HandlerMiddlewares {
handler = middleware(handler)
}
handler.ServeHTTP(w, r)
}
// ListDevices operation middleware
func (siw *ServerInterfaceWrapper) ListDevices(w http.ResponseWriter, r *http.Request) {
ctx := r.Context()
ctx = context.WithValue(ctx, BearerAuthScopes, []string{})
r = r.WithContext(ctx)
handler := http.Handler(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
siw.Handler.ListDevices(w, r)
}))
for _, middleware := range siw.HandlerMiddlewares {
handler = middleware(handler)
}
handler.ServeHTTP(w, r)
}
// DeleteDevice operation middleware
func (siw *ServerInterfaceWrapper) DeleteDevice(w http.ResponseWriter, r *http.Request) {
var err error
_ = err
// ------------- Path parameter "id" -------------
var id openapi_types.UUID
err = runtime.BindStyledParameterWithOptions("simple", "id", chi.URLParam(r, "id"), &id, runtime.BindStyledParameterOptions{ParamLocation: runtime.ParamLocationPath, Explode: false, Required: true, Type: "string", Format: "uuid"})
if err != nil {
siw.ErrorHandlerFunc(w, r, &InvalidParamFormatError{ParamName: "id", Err: err})
return
}
ctx := r.Context()
ctx = context.WithValue(ctx, BearerAuthScopes, []string{})
r = r.WithContext(ctx)
handler := http.Handler(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
siw.Handler.DeleteDevice(w, r, id)
}))
for _, middleware := range siw.HandlerMiddlewares {
handler = middleware(handler)
}
handler.ServeHTTP(w, r)
}
// ListNodes operation middleware
func (siw *ServerInterfaceWrapper) ListNodes(w http.ResponseWriter, r *http.Request) {
var err error
_ = err
ctx := r.Context()
ctx = context.WithValue(ctx, BearerAuthScopes, []string{})
r = r.WithContext(ctx)
// Parameter object where we will unmarshal all parameters from the context
var params ListNodesParams
// ------------- Optional query parameter "if_version" -------------
err = runtime.BindQueryParameterWithOptions("form", true, false, "if_version", r.URL.Query(), &params.IfVersion, runtime.BindQueryParameterOptions{Type: "integer", Format: "int64"})
if err != nil {
var requiredError *runtime.RequiredParameterError
if errors.As(err, &requiredError) {
siw.ErrorHandlerFunc(w, r, &RequiredParamError{ParamName: "if_version"})
} else {
siw.ErrorHandlerFunc(w, r, &InvalidParamFormatError{ParamName: "if_version", Err: err})
}
return
}
handler := http.Handler(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
siw.Handler.ListNodes(w, r, params)
}))
for _, middleware := range siw.HandlerMiddlewares {
handler = middleware(handler)
}
handler.ServeHTTP(w, r)
}
// ConnectNode operation middleware
func (siw *ServerInterfaceWrapper) ConnectNode(w http.ResponseWriter, r *http.Request) {
var err error
_ = err
// ------------- Path parameter "id" -------------
var id openapi_types.UUID
err = runtime.BindStyledParameterWithOptions("simple", "id", chi.URLParam(r, "id"), &id, runtime.BindStyledParameterOptions{ParamLocation: runtime.ParamLocationPath, Explode: false, Required: true, Type: "string", Format: "uuid"})
if err != nil {
siw.ErrorHandlerFunc(w, r, &InvalidParamFormatError{ParamName: "id", Err: err})
return
}
ctx := r.Context()
ctx = context.WithValue(ctx, BearerAuthScopes, []string{})
r = r.WithContext(ctx)
handler := http.Handler(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
siw.Handler.ConnectNode(w, r, id)
}))
for _, middleware := range siw.HandlerMiddlewares {
handler = middleware(handler)
}
handler.ServeHTTP(w, r)
}
// DisconnectNode operation middleware
func (siw *ServerInterfaceWrapper) DisconnectNode(w http.ResponseWriter, r *http.Request) {
var err error
_ = err
// ------------- Path parameter "id" -------------
var id openapi_types.UUID
err = runtime.BindStyledParameterWithOptions("simple", "id", chi.URLParam(r, "id"), &id, runtime.BindStyledParameterOptions{ParamLocation: runtime.ParamLocationPath, Explode: false, Required: true, Type: "string", Format: "uuid"})
if err != nil {
siw.ErrorHandlerFunc(w, r, &InvalidParamFormatError{ParamName: "id", Err: err})
return
}
ctx := r.Context()
ctx = context.WithValue(ctx, BearerAuthScopes, []string{})
r = r.WithContext(ctx)
handler := http.Handler(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
siw.Handler.DisconnectNode(w, r, id)
}))
for _, middleware := range siw.HandlerMiddlewares {
handler = middleware(handler)
}
handler.ServeHTTP(w, r)
}
// ListNotices operation middleware
func (siw *ServerInterfaceWrapper) ListNotices(w http.ResponseWriter, r *http.Request) {
ctx := r.Context()
ctx = context.WithValue(ctx, BearerAuthScopes, []string{})
r = r.WithContext(ctx)
handler := http.Handler(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
siw.Handler.ListNotices(w, r)
}))
for _, middleware := range siw.HandlerMiddlewares {
handler = middleware(handler)
}
handler.ServeHTTP(w, r)
}
// ListPlans operation middleware
func (siw *ServerInterfaceWrapper) ListPlans(w http.ResponseWriter, r *http.Request) {
ctx := r.Context()
ctx = context.WithValue(ctx, BearerAuthScopes, []string{})
r = r.WithContext(ctx)
handler := http.Handler(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
siw.Handler.ListPlans(w, r)
}))
for _, middleware := range siw.HandlerMiddlewares {
handler = middleware(handler)
}
handler.ServeHTTP(w, r)
}
// RedeemCode operation middleware
func (siw *ServerInterfaceWrapper) RedeemCode(w http.ResponseWriter, r *http.Request) {
ctx := r.Context()
ctx = context.WithValue(ctx, BearerAuthScopes, []string{})
r = r.WithContext(ctx)
handler := http.Handler(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
siw.Handler.RedeemCode(w, r)
}))
for _, middleware := range siw.HandlerMiddlewares {
handler = middleware(handler)
}
handler.ServeHTTP(w, r)
}
// GetUsage operation middleware
func (siw *ServerInterfaceWrapper) GetUsage(w http.ResponseWriter, r *http.Request) {
var err error
_ = err
ctx := r.Context()
ctx = context.WithValue(ctx, BearerAuthScopes, []string{})
r = r.WithContext(ctx)
// Parameter object where we will unmarshal all parameters from the context
var params GetUsageParams
// ------------- Optional query parameter "days" -------------
err = runtime.BindQueryParameterWithOptions("form", true, false, "days", r.URL.Query(), &params.Days, runtime.BindQueryParameterOptions{Type: "integer", Format: ""})
if err != nil {
var requiredError *runtime.RequiredParameterError
if errors.As(err, &requiredError) {
siw.ErrorHandlerFunc(w, r, &RequiredParamError{ParamName: "days"})
} else {
siw.ErrorHandlerFunc(w, r, &InvalidParamFormatError{ParamName: "days", Err: err})
}
return
}
handler := http.Handler(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
siw.Handler.GetUsage(w, r, params)
}))
for _, middleware := range siw.HandlerMiddlewares {
handler = middleware(handler)
}
handler.ServeHTTP(w, r)
}
type UnescapedCookieParamError struct {
ParamName string
Err error
}
func (e *UnescapedCookieParamError) Error() string {
return fmt.Sprintf("error unescaping cookie parameter '%s'", e.ParamName)
}
func (e *UnescapedCookieParamError) Unwrap() error {
return e.Err
}
type UnmarshalingParamError struct {
ParamName string
Err error
}
func (e *UnmarshalingParamError) Error() string {
return fmt.Sprintf("Error unmarshaling parameter %s as JSON: %s", e.ParamName, e.Err.Error())
}
func (e *UnmarshalingParamError) Unwrap() error {
return e.Err
}
type RequiredParamError struct {
ParamName string
}
func (e *RequiredParamError) Error() string {
return fmt.Sprintf("Query argument %s is required, but not found", e.ParamName)
}
type RequiredHeaderError struct {
ParamName string
Err error
}
func (e *RequiredHeaderError) Error() string {
return fmt.Sprintf("Header parameter %s is required, but not found", e.ParamName)
}
func (e *RequiredHeaderError) Unwrap() error {
return e.Err
}
type InvalidParamFormatError struct {
ParamName string
Err error
}
func (e *InvalidParamFormatError) Error() string {
return fmt.Sprintf("Invalid format for parameter %s: %s", e.ParamName, e.Err.Error())
}
func (e *InvalidParamFormatError) Unwrap() error {
return e.Err
}
type TooManyValuesForParamError struct {
ParamName string
Count int
}
func (e *TooManyValuesForParamError) Error() string {
return fmt.Sprintf("Expected one value for %s, got %d", e.ParamName, e.Count)
}
// Handler creates http.Handler with routing matching OpenAPI spec.
func Handler(si ServerInterface) http.Handler {
return HandlerWithOptions(si, ChiServerOptions{})
}
type ChiServerOptions struct {
BaseURL string
BaseRouter chi.Router
Middlewares []MiddlewareFunc
ErrorHandlerFunc func(w http.ResponseWriter, r *http.Request, err error)
}
// HandlerFromMux creates http.Handler with routing matching OpenAPI spec based on the provided mux.
func HandlerFromMux(si ServerInterface, r chi.Router) http.Handler {
return HandlerWithOptions(si, ChiServerOptions{
BaseRouter: r,
})
}
func HandlerFromMuxWithBaseURL(si ServerInterface, r chi.Router, baseURL string) http.Handler {
return HandlerWithOptions(si, ChiServerOptions{
BaseURL: baseURL,
BaseRouter: r,
})
}
// HandlerWithOptions creates http.Handler with additional options
func HandlerWithOptions(si ServerInterface, options ChiServerOptions) http.Handler {
r := options.BaseRouter
if r == nil {
r = chi.NewRouter()
}
if options.ErrorHandlerFunc == nil {
options.ErrorHandlerFunc = func(w http.ResponseWriter, r *http.Request, err error) {
http.Error(w, err.Error(), http.StatusBadRequest)
}
}
wrapper := ServerInterfaceWrapper{
Handler: si,
HandlerMiddlewares: options.Middlewares,
ErrorHandlerFunc: options.ErrorHandlerFunc,
}
r.Group(func(r chi.Router) {
r.Post(options.BaseURL+"/ads/unlock", wrapper.AdsUnlock)
})
r.Group(func(r chi.Router) {
r.Post(options.BaseURL+"/auth/code", wrapper.SendVerificationCode)
})
r.Group(func(r chi.Router) {
r.Post(options.BaseURL+"/auth/login", wrapper.Login)
})
r.Group(func(r chi.Router) {
r.Post(options.BaseURL+"/auth/refresh", wrapper.RefreshToken)
})
r.Group(func(r chi.Router) {
r.Post(options.BaseURL+"/auth/register", wrapper.Register)
})
r.Group(func(r chi.Router) {
r.Get(options.BaseURL+"/me", wrapper.GetMe)
})
r.Group(func(r chi.Router) {
r.Get(options.BaseURL+"/me/devices", wrapper.ListDevices)
})
r.Group(func(r chi.Router) {
r.Delete(options.BaseURL+"/me/devices/{id}", wrapper.DeleteDevice)
})
r.Group(func(r chi.Router) {
r.Get(options.BaseURL+"/nodes", wrapper.ListNodes)
})
r.Group(func(r chi.Router) {
r.Post(options.BaseURL+"/nodes/{id}/connect", wrapper.ConnectNode)
})
r.Group(func(r chi.Router) {
r.Post(options.BaseURL+"/nodes/{id}/disconnect", wrapper.DisconnectNode)
})
r.Group(func(r chi.Router) {
r.Get(options.BaseURL+"/notices", wrapper.ListNotices)
})
r.Group(func(r chi.Router) {
r.Get(options.BaseURL+"/plans", wrapper.ListPlans)
})
r.Group(func(r chi.Router) {
r.Post(options.BaseURL+"/redeem", wrapper.RedeemCode)
})
r.Group(func(r chi.Router) {
r.Get(options.BaseURL+"/usage", wrapper.GetUsage)
})
return r
}
// Base64 encoded, compressed with deflate, json marshaled OpenAPI spec.
// Stored as a slice of fixed-width chunks rather than one concatenated
// const string: with thousands of chunks the chained `+` fold is several
// times slower for the Go compiler than parsing a slice literal.
var swaggerSpec = []string{
"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",
}
// decodeSpec returns the embedded OpenAPI spec as raw JSON bytes,
// after base64-decoding and flate-decompressing the embedded blob.
func decodeSpec() ([]byte, error) {
encoded := strings.Join(swaggerSpec, "")
compressed, err := base64.StdEncoding.DecodeString(encoded)
if err != nil {
return nil, fmt.Errorf("error base64 decoding spec: %w", err)
}
zr := flate.NewReader(bytes.NewReader(compressed))
var buf bytes.Buffer
if _, err := buf.ReadFrom(zr); err != nil {
return nil, fmt.Errorf("read flate: %w", err)
}
if err := zr.Close(); err != nil {
return nil, fmt.Errorf("close flate reader: %w", err)
}
return buf.Bytes(), nil
}
var rawSpec = decodeSpecCached()
// a naive cache of the decoded OpenAPI spec
func decodeSpecCached() func() ([]byte, error) {
data, err := decodeSpec()
return func() ([]byte, error) {
return data, err
}
}
// Constructs a synthetic filesystem for resolving external references when loading openapi specifications.
func PathToRawSpec(pathToFile string) map[string]func() ([]byte, error) {
res := make(map[string]func() ([]byte, error))
if len(pathToFile) > 0 {
res[pathToFile] = rawSpec
}
return res
}
// GetSpec returns the OpenAPI specification corresponding to the generated
// code in this file. External references in the spec are resolved through
// PathToRawSpec; externally-referenced files must be embedded in their
// corresponding Go packages (via the import-mapping feature). URL-based
// external refs are not supported.
func GetSpec() (swagger *openapi3.T, err error) {
resolvePath := PathToRawSpec("")
loader := openapi3.NewLoader()
loader.IsExternalRefsAllowed = true
loader.ReadFromURIFunc = func(loader *openapi3.Loader, url *url.URL) ([]byte, error) {
pathToFile := url.String()
pathToFile = path.Clean(pathToFile)
getSpec, ok := resolvePath[pathToFile]
if !ok {
err1 := fmt.Errorf("path not found: %s", pathToFile)
return nil, err1
}
return getSpec()
}
var specData []byte
specData, err = rawSpec()
if err != nil {
return
}
swagger, err = loader.LoadFromData(specData)
if err != nil {
return
}
return
}
// GetSpecJSON returns the raw JSON bytes of the embedded OpenAPI
// specification: decompressed but not unmarshaled. External references
// are not resolved here; the bytes are the spec exactly as embedded by
// codegen. The result is cached at package init time, so repeated calls
// are cheap.
func GetSpecJSON() ([]byte, error) {
return rawSpec()
}
// GetSwagger returns the OpenAPI specification corresponding to the
// generated code in this file.
//
// Deprecated: GetSwagger predates kin-openapi renaming openapi3.Swagger
// to openapi3.T. Use [GetSpec] instead. This wrapper is retained for
// backwards compatibility.
func GetSwagger() (*openapi3.T, error) {
return GetSpec()
}