base

Documentation

Overview

Package base define base manager

Index

• Constants
• func NewStreamReader(stream *option.Stream, reedSeeker io.ReadSeeker) io.ReadCloser
• func NewUploader(manager storage.Manager) storage.BatchUploader
• type List
• type Manager
  • func New(manager storage.Manager, scheme string, ...) *Manager
  • func (m *Manager) BaseURL() string
  • func (m *Manager) Close() error
  • func (m *Manager) Create(ctx context.Context, URL string, mode os.FileMode, isDir bool, ...) error
  • func (m *Manager) Delete(ctx context.Context, URL string, options ...storage.Option) error
  • func (m *Manager) Exists(ctx context.Context, URL string, options ...storage.Option) (bool, error)
  • func (m *Manager) IsAuthChanged(ctx context.Context, baseURL string, options []storage.Option) bool
  • func (m *Manager) List(ctx context.Context, URL string, options ...storage.Option) ([]storage.Object, error)
  • func (m *Manager) Object(ctx context.Context, URL string, options ...storage.Option) (storage.Object, error)
  • func (m *Manager) Open(ctx context.Context, object storage.Object, options ...storage.Option) (io.ReadCloser, error)
  • func (m *Manager) OpenURL(ctx context.Context, URL string, options ...storage.Option) (io.ReadCloser, error)
  • func (m *Manager) Options(options []storage.Option) []storage.Option
  • func (m *Manager) Scheme() string
  • func (m *Manager) Storager(ctx context.Context, baseURL string, options []storage.Option) (storage.Storager, error)
  • func (m *Manager) Upload(ctx context.Context, URL string, mode os.FileMode, reader io.Reader, ...) error
• type Retry
  • func NewRetry() *Retry
  • func (b *Retry) Pause() time.Duration
• type Storager
  • func (s *Storager) Get(ctx context.Context, location string, options ...storage.Option) (os.FileInfo, error)

Constants

const (
	//RangeHeader represents a range header
	RangeHeader     = "Range"
	RangeHeaderTmpl = "bytes=%d-%d"
)

RangeHeader represents a range header

Functions

func NewStreamReader

func NewStreamReader(stream *option.Stream, reedSeeker io.ReadSeeker) io.ReadCloser

func NewUploader

func NewUploader(manager storage.Manager) storage.BatchUploader

NewUploader creates a new batch uploader

Types

type List

type List func(ctx context.Context, location string, options ...storage.Option) ([]os.FileInfo, error)

type Manager

type Manager struct {
	storage.Manager
	// contains filtered or unexported fields
}

Manager represents Storager base manager

func New

func New(manager storage.Manager, scheme string, provider func(ctx context.Context, baseURL string, options ...storage.Option) (storage.Storager, error), options []storage.Option) *Manager

New creates base Storager base Manager

func (*Manager) BaseURL

func (m *Manager) BaseURL() string

Scheme returns scheme

func (*Manager) Close

func (m *Manager) Close() error

Close closes storagers

func (*Manager) Create

func (m *Manager) Create(ctx context.Context, URL string, mode os.FileMode, isDir bool, options ...storage.Option) error

Create creates a resource

func (*Manager) Delete

func (m *Manager) Delete(ctx context.Context, URL string, options ...storage.Option) error

Delete deletes locations

func (*Manager) Exists

func (m *Manager) Exists(ctx context.Context, URL string, options ...storage.Option) (bool, error)

Exists checks if resource exsits

func (*Manager) IsAuthChanged

func (m *Manager) IsAuthChanged(ctx context.Context, baseURL string, options []storage.Option) bool

func (*Manager) List

func (m *Manager) List(ctx context.Context, URL string, options ...storage.Option) ([]storage.Object, error)

List lists content for supplied URL

func (*Manager) Object

func (m *Manager) Object(ctx context.Context, URL string, options ...storage.Option) (storage.Object, error)

Object retuns an object for supplied URL or error

func (*Manager) Open

func (m *Manager) Open(ctx context.Context, object storage.Object, options ...storage.Option) (io.ReadCloser, error)

Open downloads content

func (*Manager) OpenURL

func (m *Manager) OpenURL(ctx context.Context, URL string, options ...storage.Option) (io.ReadCloser, error)

OpenURL downloads content

func (*Manager) Options

func (m *Manager) Options(options []storage.Option) []storage.Option

Options returns base and supplied options

func (*Manager) Scheme

func (m *Manager) Scheme() string

Scheme returns scheme

func (*Manager) Storager

func (m *Manager) Storager(ctx context.Context, baseURL string, options []storage.Option) (storage.Storager, error)

Storager returns Storager

func (*Manager) Upload

func (m *Manager) Upload(ctx context.Context, URL string, mode os.FileMode, reader io.Reader, options ...storage.Option) error

Upload uploads content

type Retry

type Retry struct {
	Count      int
	Initial    time.Duration
	Max        time.Duration
	Multiplier float64
	// contains filtered or unexported fields
}

Retry represents abstraction holding sleep duration between retries (back-off)

func NewRetry

func NewRetry() *Retry

NewRetry creates a retry

func (*Retry) Pause

func (b *Retry) Pause() time.Duration

Pause returns the next time.Duration that the caller should use to backoff.

type Storager

type Storager struct {
	List func(ctx context.Context, location string, options ...storage.Option) ([]os.FileInfo, error)
}

Storager represents a base storager

func (*Storager) Get

func (s *Storager) Get(ctx context.Context, location string, options ...storage.Option) (os.FileInfo, error)

Get returns an object for supplied location