gitlab

package
v17.4.1 Latest Latest
Warning

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

 Go to latest Published: Sep 24, 2024 License: MIT Imports: 29 Imported by: 0

Documentation

Index

Constants

View Source 
const (
	AgentkTokenHeader = "Gitlab-Agentk-Api-Request" //nolint: gosec
)

Variables

View Source 
var File_internal_gitlab_gitlab_proto protoreflect.FileDescriptor

Functions

func DefaultErrorHandlerWithReason added in v17.4.0 

func DefaultErrorHandlerWithReason(resp *http.Response) error

DefaultErrorHandlerWithReason tries to add an error reason from the response body. If no reason can be found, none is added to the response

func IsBadRequest 

func IsBadRequest(err error) bool

func IsForbidden 

func IsForbidden(err error) bool

func IsNotFound 

func IsNotFound(err error) bool

func IsUnauthorized 

func IsUnauthorized(err error) bool

Types

type Client 

type Client struct {
	Backend           *url.URL
	HTTPClient        HTTPClient
	HTTPClientNoRetry HTTPClient
	UserAgent         string
	Validator         prototool.Validator
}

func NewClient 

func NewClient(backend *url.URL, authSecret []byte, opts ...ClientOption) *Client

func (*Client) Do 

func (c *Client) Do(ctx context.Context, opts ...DoOption) error

type ClientError 

type ClientError struct {
	StatusCode int32  `protobuf:"varint,1,opt,name=status_code,json=statusCode,proto3" json:"status_code,omitempty"`
	Path       string `protobuf:"bytes,2,opt,name=path,proto3" json:"path,omitempty"`
	Reason     string `protobuf:"bytes,3,opt,name=reason,proto3" json:"reason,omitempty"`
	// contains filtered or unexported fields
}

func DefaultErrorHandler added in v17.4.0 

func DefaultErrorHandler(resp *http.Response) *ClientError

func (*ClientError) Descriptor deprecated 

func (*ClientError) Descriptor() ([]byte, []int)

Deprecated: Use ClientError.ProtoReflect.Descriptor instead.

func (*ClientError) Error 

func (x *ClientError) Error() string

func (*ClientError) GetPath 

func (x *ClientError) GetPath() string

func (*ClientError) GetReason 

func (x *ClientError) GetReason() string

func (*ClientError) GetStatusCode 

func (x *ClientError) GetStatusCode() int32

func (*ClientError) ProtoMessage 

func (*ClientError) ProtoMessage()

func (*ClientError) ProtoReflect 

func (x *ClientError) ProtoReflect() protoreflect.Message

func (*ClientError) Reset 

func (x *ClientError) Reset()

func (*ClientError) String 

func (x *ClientError) String() string

type ClientInterface 

type ClientInterface interface {
	Do(ctx context.Context, opts ...DoOption) error
}

type ClientOption 

type ClientOption func(*clientConfig)

ClientOption to configure the client.

func WithMeterProvider 

func WithMeterProvider(meterProvider otelmetric.MeterProvider) ClientOption

WithMeterProvider sets a custom meter provider to be used, otherwise the OTEL's global MeterProvider is used.

func WithRateLimiter 

func WithRateLimiter(limiter httpz.Limiter) ClientOption

WithRateLimiter sets the rate limiter to use.

func WithRetryConfig 

func WithRetryConfig(retryConfig RetryConfig) ClientOption

WithRetryConfig configures retry behavior.

func WithTLSConfig 

func WithTLSConfig(tlsConfig *tls.Config) ClientOption

WithTLSConfig sets the TLS config to use.

func WithTextMapPropagator 

func WithTextMapPropagator(p propagation.TextMapPropagator) ClientOption

WithTextMapPropagator sets a custom trace propagator to be used, otherwise the OTEL's global TextMapPropagator is used.

func WithTracerProvider 

func WithTracerProvider(traceProvider trace.TracerProvider) ClientOption

WithTracerProvider sets a custom trace provider to be used, otherwise the OTEL's global TracerProvider is used.

func WithUserAgent 

func WithUserAgent(userAgent string) ClientOption

WithUserAgent configures the User-Agent header on the http client.

func WithValidator added in v17.3.0 

func WithValidator(v prototool.Validator) ClientOption

WithValidator sets the proto validator to use.

type DefaultApiError 

type DefaultApiError struct {
	Message string `protobuf:"bytes,1,opt,name=message,proto3" json:"message,omitempty"`
	// contains filtered or unexported fields
}

func (*DefaultApiError) Descriptor deprecated 

func (*DefaultApiError) Descriptor() ([]byte, []int)

Deprecated: Use DefaultApiError.ProtoReflect.Descriptor instead.

func (*DefaultApiError) GetMessage 

func (x *DefaultApiError) GetMessage() string

func (*DefaultApiError) ProtoMessage 

func (*DefaultApiError) ProtoMessage()

func (*DefaultApiError) ProtoReflect 

func (x *DefaultApiError) ProtoReflect() protoreflect.Message

func (*DefaultApiError) Reset 

func (x *DefaultApiError) Reset()

func (*DefaultApiError) String 

func (x *DefaultApiError) String() string

type DoOption 

type DoOption func(*doConfig) error

DoOption to configure the Do call of the client.

func WithAgentToken 

func WithAgentToken(agentToken api.AgentToken) DoOption

func WithHeader 

func WithHeader(header http.Header) DoOption

func WithJSONRequestBody 

func WithJSONRequestBody(body any) DoOption

WithJSONRequestBody specifies the object to marshal to JSON and use as request body. Do NOT use this method with proto messages, use WithProtoJSONRequestBody instead.

func WithJWT 

func WithJWT(withJWT bool) DoOption

func WithJobToken 

func WithJobToken(jobToken string) DoOption

WithJobToken sets the CI job token to authenticate this API request. See https://docs.gitlab.com/ee/api/rest/#job-tokens.

func WithMethod 

func WithMethod(method string) DoOption

func WithPath 

func WithPath(path string) DoOption

func WithProtoJSONRequestBody 

func WithProtoJSONRequestBody(body proto.Message) DoOption

WithProtoJSONRequestBody specifies the object to marshal to JSON and use as request body. Use this method with proto messages.

func WithQuery 

func WithQuery(query url.Values) DoOption

func WithRequestBodyBytes added in v17.4.0 

func WithRequestBodyBytes(body []byte, contentType string) DoOption

WithRequestBodyBytes sets the request body and HTTP Content-Type header if contentType is not empty.

func WithRequestBodyReader added in v17.4.0 

func WithRequestBodyReader(body io.Reader, contentType string) DoOption

WithRequestBodyReader sets the request body and HTTP Content-Type header if contentType is not empty.

func WithResponseHandler 

func WithResponseHandler(handler ResponseHandler) DoOption

func WithoutRetries 

func WithoutRetries() DoOption

type ErrHandler 

type ErrHandler func(resp *http.Response) error

type HTTPClient 

type HTTPClient interface {
	Do(*retryablehttp.Request) (*http.Response, error)
}

type ResponseHandler 

type ResponseHandler interface {
	// Handle is invoked with HTTP client's response and error values.
	Handle(prototool.Validator, *http.Response, error) error
	// Accept returns the value to send in the Accept HTTP header.
	// Empty string means no value should be sent.
	Accept() string
}

func NakedResponseHandler 

func NakedResponseHandler(response **http.Response) ResponseHandler

func NoContentResponseHandler 

func NoContentResponseHandler() ResponseHandler

NoContentResponseHandler can be used when no response is expected or response must be discarded.

func ProtoJSONResponseHandler 

func ProtoJSONResponseHandler(response proto.Message) ResponseHandler

func ProtoJSONResponseHandlerWithErr 

func ProtoJSONResponseHandlerWithErr(response proto.Message, errHandler ErrHandler) ResponseHandler

func ProtoJSONResponseHandlerWithStructuredErrReason 

func ProtoJSONResponseHandlerWithStructuredErrReason(response proto.Message) ResponseHandler

type ResponseHandlerStruct 

type ResponseHandlerStruct struct {
	AcceptHeader string
	HandleFunc   func(prototool.Validator, *http.Response, error) error
}

func (ResponseHandlerStruct) Accept 

func (r ResponseHandlerStruct) Accept() string

func (ResponseHandlerStruct) Handle 

func (r ResponseHandlerStruct) Handle(v prototool.Validator, resp *http.Response, err error) error

type RetryConfig 

type RetryConfig struct {
	// Logger instance. Can be either retryablehttp.Logger or retryablehttp.LeveledLogger
	Logger any

	RetryWaitMin time.Duration // Minimum time to wait
	RetryWaitMax time.Duration // Maximum time to wait
	RetryMax     int           // Maximum number of retries

	// RequestLogHook allows a user-supplied function to be called
	// before each retry.
	RequestLogHook retryablehttp.RequestLogHook

	// ResponseLogHook allows a user-supplied function to be called
	// with the response from each HTTP request executed.
	ResponseLogHook retryablehttp.ResponseLogHook

	// CheckRetry specifies the policy for handling retries, and is called
	// after each request. The default policy is retryablehttp.DefaultRetryPolicy.
	CheckRetry retryablehttp.CheckRetry

	// Backoff specifies the policy for how long to wait between retries.
	// retryablehttp.DefaultBackoff is used by default.
	Backoff retryablehttp.Backoff
}

Source Files

View all Source files

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.