client

Documentation

Index

• Variables
• func AddEtagToTag(tag, etag string) distribution.ManifestServiceOption
• func HandleErrorResponse(resp *http.Response) error
• func NewRepository(ctx context.Context, name reference.Named, baseURL string, ...) (distribution.Repository, error)
• func SuccessStatus(status int) bool
• func WithMountFrom(ref reference.Canonical) distribution.BlobCreateOption
• type Registry
  • func NewRegistry(ctx context.Context, baseURL string, transport http.RoundTripper) (Registry, error)
• type UnexpectedHTTPResponseError
  • func (e *UnexpectedHTTPResponseError) Error() string
• type UnexpectedHTTPStatusError
  • func (e *UnexpectedHTTPStatusError) Error() string

Variables

var ErrNoErrorsInBody = errors.New("no error details found in HTTP response body")

ErrNoErrorsInBody is returned when a HTTP response body parses to an empty errcode.Errors slice.

Functions

func AddEtagToTag

func AddEtagToTag(tag, etag string) distribution.ManifestServiceOption

AddEtagToTag allows a client to supply an eTag to Get which will be used for a conditional HTTP request. If the eTag matches, a nil manifest and ErrManifestNotModified error will be returned. etag is automatically quoted when added to this map.

func HandleErrorResponse

func HandleErrorResponse(resp *http.Response) error

HandleErrorResponse returns error parsed from HTTP response for an unsuccessful HTTP response code (in the range 400 - 499 inclusive). An UnexpectedHTTPStatusError returned for response code outside of expected range.

func NewRepository

func NewRepository(ctx context.Context, name reference.Named, baseURL string, transport http.RoundTripper) (distribution.Repository, error)

NewRepository creates a new Repository for the given repository name and base URL.

func SuccessStatus

func SuccessStatus(status int) bool

SuccessStatus returns true if the argument is a successful HTTP response code (in the range 200 - 399 inclusive).

func WithMountFrom

func WithMountFrom(ref reference.Canonical) distribution.BlobCreateOption

WithMountFrom returns a BlobCreateOption which designates that the blob should be mounted from the given canonical reference.

Types

type Registry

type Registry interface {
	Repositories(ctx context.Context, repos []string, last string) (n int, err error)
}

Registry provides an interface for calling Repositories, which returns a catalog of repositories.

func NewRegistry

func NewRegistry(ctx context.Context, baseURL string, transport http.RoundTripper) (Registry, error)

NewRegistry creates a registry namespace which can be used to get a listing of repositories

type UnexpectedHTTPResponseError

type UnexpectedHTTPResponseError struct {
	ParseErr   error
	StatusCode int
	Response   []byte
}

UnexpectedHTTPResponseError is returned when an expected HTTP status code is returned, but the content was unexpected and failed to be parsed.

func (*UnexpectedHTTPResponseError) Error

func (e *UnexpectedHTTPResponseError) Error() string

type UnexpectedHTTPStatusError

type UnexpectedHTTPStatusError struct {
	Status string
}

UnexpectedHTTPStatusError is returned when an unexpected HTTP status is returned when making a registry api call.

func (*UnexpectedHTTPStatusError) Error

func (e *UnexpectedHTTPStatusError) Error() string