// Code generated by ogen, DO NOT EDIT. package api import ( "context" "net/url" "strings" "time" "github.com/go-faster/errors" "go.opentelemetry.io/otel/attribute" "go.opentelemetry.io/otel/codes" "go.opentelemetry.io/otel/metric" semconv "go.opentelemetry.io/otel/semconv/v1.19.0" "go.opentelemetry.io/otel/trace" "github.com/ogen-go/ogen/conv" ht "github.com/ogen-go/ogen/http" "github.com/ogen-go/ogen/otelogen" "github.com/ogen-go/ogen/uri" ) // Invoker invokes operations described by OpenAPI v3 specification. type Invoker interface { // GetUser invokes getUser operation. // // Retrieve user with ID. // // GET /users/{UserID} GetUser(ctx context.Context, params GetUserParams) (*User, error) // GetUserRank invokes getUserRank operation. // // Retrieve rank of user. // // GET /users/{UserID}/rank GetUserRank(ctx context.Context, params GetUserRankParams) (*Rank, error) // ListRanks invokes listRanks operation. // // Get list of ranks. // // GET /ranks ListRanks(ctx context.Context, params ListRanksParams) ([]Rank, error) // ListTimes invokes listTimes operation. // // Get list of times. // // GET /times ListTimes(ctx context.Context, params ListTimesParams) ([]Time, error) } // Client implements OAS client. type Client struct { serverURL *url.URL baseClient } type errorHandler interface { NewError(ctx context.Context, err error) *ErrorStatusCode } var _ Handler = struct { errorHandler *Client }{} func trimTrailingSlashes(u *url.URL) { u.Path = strings.TrimRight(u.Path, "/") u.RawPath = strings.TrimRight(u.RawPath, "/") } // NewClient initializes new Client defined by OAS. func NewClient(serverURL string, opts ...ClientOption) (*Client, error) { u, err := url.Parse(serverURL) if err != nil { return nil, err } trimTrailingSlashes(u) c, err := newClientConfig(opts...).baseClient() if err != nil { return nil, err } return &Client{ serverURL: u, baseClient: c, }, nil } type serverURLKey struct{} // WithServerURL sets context key to override server URL. func WithServerURL(ctx context.Context, u *url.URL) context.Context { return context.WithValue(ctx, serverURLKey{}, u) } func (c *Client) requestURL(ctx context.Context) *url.URL { u, ok := ctx.Value(serverURLKey{}).(*url.URL) if !ok { return c.serverURL } return u } // GetUser invokes getUser operation. // // Retrieve user with ID. // // GET /users/{UserID} func (c *Client) GetUser(ctx context.Context, params GetUserParams) (*User, error) { res, err := c.sendGetUser(ctx, params) return res, err } func (c *Client) sendGetUser(ctx context.Context, params GetUserParams) (res *User, err error) { otelAttrs := []attribute.KeyValue{ otelogen.OperationID("getUser"), semconv.HTTPMethodKey.String("GET"), semconv.HTTPRouteKey.String("/users/{UserID}"), } // Run stopwatch. startTime := time.Now() defer func() { // Use floating point division here for higher precision (instead of Millisecond method). elapsedDuration := time.Since(startTime) c.duration.Record(ctx, float64(float64(elapsedDuration)/float64(time.Millisecond)), metric.WithAttributes(otelAttrs...)) }() // Increment request counter. c.requests.Add(ctx, 1, metric.WithAttributes(otelAttrs...)) // Start a span for this request. ctx, span := c.cfg.Tracer.Start(ctx, "GetUser", trace.WithAttributes(otelAttrs...), clientSpanKind, ) // Track stage for error reporting. var stage string defer func() { if err != nil { span.RecordError(err) span.SetStatus(codes.Error, stage) c.errors.Add(ctx, 1, metric.WithAttributes(otelAttrs...)) } span.End() }() stage = "BuildURL" u := uri.Clone(c.requestURL(ctx)) var pathParts [2]string pathParts[0] = "/users/" { // Encode "UserID" parameter. e := uri.NewPathEncoder(uri.PathEncoderConfig{ Param: "UserID", Style: uri.PathStyleSimple, Explode: false, }) if err := func() error { return e.EncodeValue(conv.Int64ToString(params.UserID)) }(); err != nil { return res, errors.Wrap(err, "encode path") } encoded, err := e.Result() if err != nil { return res, errors.Wrap(err, "encode path") } pathParts[1] = encoded } uri.AddPathParts(u, pathParts[:]...) stage = "EncodeRequest" r, err := ht.NewRequest(ctx, "GET", u) if err != nil { return res, errors.Wrap(err, "create request") } stage = "SendRequest" resp, err := c.cfg.Client.Do(r) if err != nil { return res, errors.Wrap(err, "do request") } defer resp.Body.Close() stage = "DecodeResponse" result, err := decodeGetUserResponse(resp) if err != nil { return res, errors.Wrap(err, "decode response") } return result, nil } // GetUserRank invokes getUserRank operation. // // Retrieve rank of user. // // GET /users/{UserID}/rank func (c *Client) GetUserRank(ctx context.Context, params GetUserRankParams) (*Rank, error) { res, err := c.sendGetUserRank(ctx, params) return res, err } func (c *Client) sendGetUserRank(ctx context.Context, params GetUserRankParams) (res *Rank, err error) { otelAttrs := []attribute.KeyValue{ otelogen.OperationID("getUserRank"), semconv.HTTPMethodKey.String("GET"), semconv.HTTPRouteKey.String("/users/{UserID}/rank"), } // Run stopwatch. startTime := time.Now() defer func() { // Use floating point division here for higher precision (instead of Millisecond method). elapsedDuration := time.Since(startTime) c.duration.Record(ctx, float64(float64(elapsedDuration)/float64(time.Millisecond)), metric.WithAttributes(otelAttrs...)) }() // Increment request counter. c.requests.Add(ctx, 1, metric.WithAttributes(otelAttrs...)) // Start a span for this request. ctx, span := c.cfg.Tracer.Start(ctx, "GetUserRank", trace.WithAttributes(otelAttrs...), clientSpanKind, ) // Track stage for error reporting. var stage string defer func() { if err != nil { span.RecordError(err) span.SetStatus(codes.Error, stage) c.errors.Add(ctx, 1, metric.WithAttributes(otelAttrs...)) } span.End() }() stage = "BuildURL" u := uri.Clone(c.requestURL(ctx)) var pathParts [3]string pathParts[0] = "/users/" { // Encode "UserID" parameter. e := uri.NewPathEncoder(uri.PathEncoderConfig{ Param: "UserID", Style: uri.PathStyleSimple, Explode: false, }) if err := func() error { return e.EncodeValue(conv.Int64ToString(params.UserID)) }(); err != nil { return res, errors.Wrap(err, "encode path") } encoded, err := e.Result() if err != nil { return res, errors.Wrap(err, "encode path") } pathParts[1] = encoded } pathParts[2] = "/rank" uri.AddPathParts(u, pathParts[:]...) stage = "EncodeQueryParams" q := uri.NewQueryEncoder() { // Encode "StyleID" parameter. cfg := uri.QueryParameterEncodingConfig{ Name: "StyleID", Style: uri.QueryStyleForm, Explode: true, } if err := q.EncodeParam(cfg, func(e uri.Encoder) error { return e.EncodeValue(conv.Int32ToString(params.StyleID)) }); err != nil { return res, errors.Wrap(err, "encode query") } } { // Encode "GameID" parameter. cfg := uri.QueryParameterEncodingConfig{ Name: "GameID", Style: uri.QueryStyleForm, Explode: true, } if err := q.EncodeParam(cfg, func(e uri.Encoder) error { return e.EncodeValue(conv.Int32ToString(params.GameID)) }); err != nil { return res, errors.Wrap(err, "encode query") } } { // Encode "ModeID" parameter. cfg := uri.QueryParameterEncodingConfig{ Name: "ModeID", Style: uri.QueryStyleForm, Explode: true, } if err := q.EncodeParam(cfg, func(e uri.Encoder) error { return e.EncodeValue(conv.Int32ToString(params.ModeID)) }); err != nil { return res, errors.Wrap(err, "encode query") } } u.RawQuery = q.Values().Encode() stage = "EncodeRequest" r, err := ht.NewRequest(ctx, "GET", u) if err != nil { return res, errors.Wrap(err, "create request") } stage = "SendRequest" resp, err := c.cfg.Client.Do(r) if err != nil { return res, errors.Wrap(err, "do request") } defer resp.Body.Close() stage = "DecodeResponse" result, err := decodeGetUserRankResponse(resp) if err != nil { return res, errors.Wrap(err, "decode response") } return result, nil } // ListRanks invokes listRanks operation. // // Get list of ranks. // // GET /ranks func (c *Client) ListRanks(ctx context.Context, params ListRanksParams) ([]Rank, error) { res, err := c.sendListRanks(ctx, params) return res, err } func (c *Client) sendListRanks(ctx context.Context, params ListRanksParams) (res []Rank, err error) { otelAttrs := []attribute.KeyValue{ otelogen.OperationID("listRanks"), semconv.HTTPMethodKey.String("GET"), semconv.HTTPRouteKey.String("/ranks"), } // Run stopwatch. startTime := time.Now() defer func() { // Use floating point division here for higher precision (instead of Millisecond method). elapsedDuration := time.Since(startTime) c.duration.Record(ctx, float64(float64(elapsedDuration)/float64(time.Millisecond)), metric.WithAttributes(otelAttrs...)) }() // Increment request counter. c.requests.Add(ctx, 1, metric.WithAttributes(otelAttrs...)) // Start a span for this request. ctx, span := c.cfg.Tracer.Start(ctx, "ListRanks", trace.WithAttributes(otelAttrs...), clientSpanKind, ) // Track stage for error reporting. var stage string defer func() { if err != nil { span.RecordError(err) span.SetStatus(codes.Error, stage) c.errors.Add(ctx, 1, metric.WithAttributes(otelAttrs...)) } span.End() }() stage = "BuildURL" u := uri.Clone(c.requestURL(ctx)) var pathParts [1]string pathParts[0] = "/ranks" uri.AddPathParts(u, pathParts[:]...) stage = "EncodeQueryParams" q := uri.NewQueryEncoder() { // Encode "page" parameter. cfg := uri.QueryParameterEncodingConfig{ Name: "page", Style: uri.QueryStyleForm, Explode: true, } if err := q.EncodeParam(cfg, func(e uri.Encoder) error { return params.Page.EncodeURI(e) }); err != nil { return res, errors.Wrap(err, "encode query") } } { // Encode "filter" parameter. cfg := uri.QueryParameterEncodingConfig{ Name: "filter", Style: uri.QueryStyleForm, Explode: true, } if err := q.EncodeParam(cfg, func(e uri.Encoder) error { if val, ok := params.Filter.Get(); ok { return val.EncodeURI(e) } return nil }); err != nil { return res, errors.Wrap(err, "encode query") } } u.RawQuery = q.Values().Encode() stage = "EncodeRequest" r, err := ht.NewRequest(ctx, "GET", u) if err != nil { return res, errors.Wrap(err, "create request") } stage = "SendRequest" resp, err := c.cfg.Client.Do(r) if err != nil { return res, errors.Wrap(err, "do request") } defer resp.Body.Close() stage = "DecodeResponse" result, err := decodeListRanksResponse(resp) if err != nil { return res, errors.Wrap(err, "decode response") } return result, nil } // ListTimes invokes listTimes operation. // // Get list of times. // // GET /times func (c *Client) ListTimes(ctx context.Context, params ListTimesParams) ([]Time, error) { res, err := c.sendListTimes(ctx, params) return res, err } func (c *Client) sendListTimes(ctx context.Context, params ListTimesParams) (res []Time, err error) { otelAttrs := []attribute.KeyValue{ otelogen.OperationID("listTimes"), semconv.HTTPMethodKey.String("GET"), semconv.HTTPRouteKey.String("/times"), } // Run stopwatch. startTime := time.Now() defer func() { // Use floating point division here for higher precision (instead of Millisecond method). elapsedDuration := time.Since(startTime) c.duration.Record(ctx, float64(float64(elapsedDuration)/float64(time.Millisecond)), metric.WithAttributes(otelAttrs...)) }() // Increment request counter. c.requests.Add(ctx, 1, metric.WithAttributes(otelAttrs...)) // Start a span for this request. ctx, span := c.cfg.Tracer.Start(ctx, "ListTimes", trace.WithAttributes(otelAttrs...), clientSpanKind, ) // Track stage for error reporting. var stage string defer func() { if err != nil { span.RecordError(err) span.SetStatus(codes.Error, stage) c.errors.Add(ctx, 1, metric.WithAttributes(otelAttrs...)) } span.End() }() stage = "BuildURL" u := uri.Clone(c.requestURL(ctx)) var pathParts [1]string pathParts[0] = "/times" uri.AddPathParts(u, pathParts[:]...) stage = "EncodeQueryParams" q := uri.NewQueryEncoder() { // Encode "page" parameter. cfg := uri.QueryParameterEncodingConfig{ Name: "page", Style: uri.QueryStyleForm, Explode: true, } if err := q.EncodeParam(cfg, func(e uri.Encoder) error { return params.Page.EncodeURI(e) }); err != nil { return res, errors.Wrap(err, "encode query") } } { // Encode "filter" parameter. cfg := uri.QueryParameterEncodingConfig{ Name: "filter", Style: uri.QueryStyleForm, Explode: true, } if err := q.EncodeParam(cfg, func(e uri.Encoder) error { if val, ok := params.Filter.Get(); ok { return val.EncodeURI(e) } return nil }); err != nil { return res, errors.Wrap(err, "encode query") } } u.RawQuery = q.Values().Encode() stage = "EncodeRequest" r, err := ht.NewRequest(ctx, "GET", u) if err != nil { return res, errors.Wrap(err, "create request") } stage = "SendRequest" resp, err := c.cfg.Client.Do(r) if err != nil { return res, errors.Wrap(err, "do request") } defer resp.Body.Close() stage = "DecodeResponse" result, err := decodeListTimesResponse(resp) if err != nil { return res, errors.Wrap(err, "decode response") } return result, nil }