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

• type Constructor
• type Getter
• type HTTPGetter
  • func NewHTTPGetter(URL, CertFile, KeyFile, CAFile string) (*HTTPGetter, error)
  • func (g *HTTPGetter) Get(href string) (*bytes.Buffer, error)
  • func (g *HTTPGetter) SetCredentials(username, password string)
  • func (g *HTTPGetter) SetUserAgent(userAgent string)
• type Provider
  • func ByScheme(scheme string, settings cli.EnvSettings) (Provider, error)
  • func (p Provider) Provides(scheme string) bool
• type Providers
  • func All(settings cli.EnvSettings) Providers
  • func (p Providers) ByScheme(scheme string) (Constructor, error)

Types

type Constructor

type Constructor func(URL, CertFile, KeyFile, CAFile string) (Getter, error)

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

type Getter

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

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

type HTTPGetter

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

HTTPGetter is the efault HTTP(/S) backend handler

func NewHTTPGetter

func NewHTTPGetter(URL, CertFile, KeyFile, CAFile string) (*HTTPGetter, error)

NewHTTPGetter constructs a valid http/https client as HTTPGetter

func (*HTTPGetter) Get

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

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

func (*HTTPGetter) SetCredentials

func (g *HTTPGetter) SetCredentials(username, password string)

SetCredentials sets the credentials for the getter

func (*HTTPGetter) SetUserAgent

func (g *HTTPGetter) SetUserAgent(userAgent string)

SetUserAgent sets the HTTP User-Agent for the getter

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 ByScheme

func ByScheme(scheme string, settings cli.EnvSettings) (Provider, error)

ByScheme returns a getter for the given scheme.

If the scheme is not supported, this will return an error.

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 build-in http/https getter and the discovered plugins with downloader notations are collected.

func (Providers) ByScheme

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

ByScheme returns a Provider that handles the given scheme.

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