fsys

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

type ConfigOption func(*RemoteConfig) error

type File interface {
	io.Reader
	io.Writer
	io.Closer

	// Name returns the name of the file
	Name() string

	// Size returns the size of the file
	Size() int64

	// Sync attempts to sync the file with the underlying storage or errors if it
	// can't not succeed.
	Sync() error

	// ContentType returns the ContentType of file. If the underlying storage type
	// doesn't support storing the ContentType then it will return the default
	// content type - application/octet-stream
	ContentType() string

	// SetContentType sets the contentType of the file. In some underlying
	// storage types this is a nop, and reading content from the file system will
	// be ignored.
	SetContentType(t string) error
}

type Filesystem interface {
	// Create takes a path, creates the file and then returns a File back that
	// can be used. This returns an error if the file can not be created in
	// some way.
	Create(string) (File, error)

	// Open takes a path, opens a potential file and then returns a File if
	// that file exists, otherwise it returns an error if the file wasn't found.
	Open(string) (File, error)

	// Rename takes a current destination path and a new destination path and will
	// rename the a File if it exists, otherwise it returns an error if the file
	// wasn't found.
	Rename(string, string) error

	// Exists takes a path and checks to see if the potential file exists or
	// not.
	// Note: If there is an error trying to read that file, it will return false
	// even if the file already exists.
	Exists(string) bool

	// Remote takes a path, removes a potential file, if no file doesn't exist it
	// will return not found.
	Remove(string) error

	// MkdirAll takes a path and generates a directory structure from that path,
	// if there is a failure it will return an error.
	MkdirAll(string) error

	// Chtimes updates the modifier times for a given path or returns an error
	// upon failure
	Chtimes(string, time.Time, time.Time) error

	// Walk over a specific directory and will return an error if there was an
	// error whilst walking.
	Walk(string, filepath.WalkFunc) error

	// Lock attempts to create a locking file for a given path.
	Lock(string) (Releaser, bool, error)
}

type Option func(*Config) error

type Releaser interface {

	// Release given lock or returns error upon failure.
	Release() error
}

type RemoteAccessType int

type RemoteConfig struct {
	Type                         RemoteAccessType
	KMSKey, ServerSideEncryption string
	ID, Secret, Token            string
	Region, Bucket               string
}