getter

Documentation

Overview

Package getter provides a generalize tool for fetching data by scheme.

This provides a method by which the plugin system can load arbitrary protocol handlers based upon a URL scheme.

Index

• Constants
• type Constructor
  • func NewPluginGetter(command string, settings *cli.EnvSettings, name, base string) Constructor
• type Getter
  • func NewHTTPGetter(options ...Option) (Getter, error)
  • func NewOCIGetter(ops ...Option) (Getter, error)
• type HTTPGetter
  • func (g *HTTPGetter) Get(href string, options ...Option) (*bytes.Buffer, error)
• type OCIGetter
  • func (g *OCIGetter) Get(href string, options ...Option) (*bytes.Buffer, error)
• type Option
  • func WithBasicAuth(username, password string) Option
  • func WithInsecureSkipVerifyTLS(insecureSkipVerifyTLS bool) Option
  • func WithPassCredentialsAll(pass bool) Option
  • func WithPlainHTTP(plainHTTP bool) Option
  • func WithRegistryClient(client *registry.Client) Option
  • func WithTLSClientConfig(certFile, keyFile, caFile string) Option
  • func WithTagName(tagname string) Option
  • func WithTimeout(timeout time.Duration) Option
  • func WithTransport(transport *http.Transport) Option
  • func WithURL(url string) Option
  • func WithUntar() Option
  • func WithUserAgent(userAgent string) Option
• type Provider
  • func (p Provider) Provides(scheme string) bool
• type Providers
  • func All(settings *cli.EnvSettings) Providers
  • func (p Providers) ByScheme(scheme string) (Getter, error)

Constants

const (
	// The cost timeout references curl's default connection timeout.
	// https://github.com/curl/curl/blob/master/lib/connect.h#L40C21-L40C21
	// The helm commands are usually executed manually. Considering the acceptable waiting time, we reduced the entire request time to 120s.
	DefaultHTTPTimeout = 120
)

Types

type Constructor

type Constructor func(options ...Option) (Getter, error)

Constructor is the function for every getter which creates a specific instance according to the configuration

func NewPluginGetter

func NewPluginGetter(command string, settings *cli.EnvSettings, name, base string) Constructor

NewPluginGetter constructs a valid plugin getter

type Getter

type Getter interface {
	// Get file content by url string
	Get(url string, options ...Option) (*bytes.Buffer, error)
}

Getter is an interface to support GET to the specified URL.

func NewHTTPGetter

func NewHTTPGetter(options ...Option) (Getter, error)

NewHTTPGetter constructs a valid http/https client as a Getter

func NewOCIGetter

func NewOCIGetter(ops ...Option) (Getter, error)

NewOCIGetter constructs a valid http/https client as a Getter

type HTTPGetter

type HTTPGetter struct {
	// contains filtered or unexported fields
}

HTTPGetter is the default HTTP(/S) backend handler

func (*HTTPGetter) Get

func (g *HTTPGetter) Get(href string, options ...Option) (*bytes.Buffer, error)

Get performs a Get from repo.Getter and returns the body.

type OCIGetter

type OCIGetter struct {
	// contains filtered or unexported fields
}

OCIGetter is the default HTTP(/S) backend handler

func (*OCIGetter) Get

func (g *OCIGetter) Get(href string, options ...Option) (*bytes.Buffer, error)

Get performs a Get from repo.Getter and returns the body.

type Option

type Option func(*options)

Option allows specifying various settings configurable by the user for overriding the defaults used when performing Get operations with the Getter.

func WithBasicAuth

func WithBasicAuth(username, password string) Option

WithBasicAuth sets the request's Authorization header to use the provided credentials

func WithInsecureSkipVerifyTLS

func WithInsecureSkipVerifyTLS(insecureSkipVerifyTLS bool) Option

WithInsecureSkipVerifyTLS determines if a TLS Certificate will be checked

func WithPassCredentialsAll

func WithPassCredentialsAll(pass bool) Option

func WithPlainHTTP

func WithPlainHTTP(plainHTTP bool) Option

func WithRegistryClient

func WithRegistryClient(client *registry.Client) Option

func WithTLSClientConfig

func WithTLSClientConfig(certFile, keyFile, caFile string) Option

WithTLSClientConfig sets the client auth with the provided credentials.

func WithTagName

func WithTagName(tagname string) Option

func WithTimeout

func WithTimeout(timeout time.Duration) Option

WithTimeout sets the timeout for requests

func WithTransport

func WithTransport(transport *http.Transport) Option

WithTransport sets the http.Transport to allow overwriting the HTTPGetter default.

func WithURL

func WithURL(url string) Option

WithURL informs the getter the server name that will be used when fetching objects. Used in conjunction with WithTLSClientConfig to set the TLSClientConfig's server name.

func WithUntar

func WithUntar() Option

func WithUserAgent

func WithUserAgent(userAgent string) Option

WithUserAgent sets the request's User-Agent header to use the provided agent name.

type Provider

type Provider struct {
	Schemes []string
	New     Constructor
}

Provider represents any getter and the schemes that it supports.

For example, an HTTP provider may provide one getter that handles both 'http' and 'https' schemes.

func (Provider) Provides

func (p Provider) Provides(scheme string) bool

Provides returns true if the given scheme is supported by this Provider.

type Providers

type Providers []Provider

Providers is a collection of Provider objects.

func All

func All(settings *cli.EnvSettings) Providers

All finds all of the registered getters as a list of Provider instances. Currently, the built-in getters and the discovered plugins with downloader notations are collected.

func (Providers) ByScheme

func (p Providers) ByScheme(scheme string) (Getter, error)

ByScheme returns a Provider that handles the given scheme.

If no provider handles this scheme, this will return an error.