v3.15.3 Latest Latest

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

Go to latest
Published: Jul 10, 2024 License: Apache-2.0 Imports: 20 Imported by: 383



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.



View Source
const (
	// The cost timeout references curl's default connection timeout.
	// The helm commands are usually executed manually. Considering the acceptable waiting time, we reduced the entire request time to 120s.
	DefaultHTTPTimeout = 120


This section is empty.


This section is empty.


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 added in v3.5.0

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 added in v3.5.0

type OCIGetter struct {
	// contains filtered or unexported fields

OCIGetter is the default HTTP(/S) backend handler

func (*OCIGetter) Get added in v3.5.0

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 added in v3.2.0

func WithInsecureSkipVerifyTLS(insecureSkipVerifyTLS bool) Option

WithInsecureSkipVerifyTLS determines if a TLS Certificate will be checked

func WithPassCredentialsAll added in v3.6.1

func WithPassCredentialsAll(pass bool) Option

func WithPlainHTTP added in v3.13.0

func WithPlainHTTP(plainHTTP bool) Option

func WithRegistryClient added in v3.5.0

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 added in v3.5.0

func WithTagName(tagname string) Option

func WithTimeout added in v3.3.0

func WithTimeout(timeout time.Duration) Option

WithTimeout sets the timeout for requests

func WithTransport added in v3.8.2

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 added in v3.5.0

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.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL