bfs

type Bucket interface {
	// Glob lists the files matching a glob pattern. It supports
	// `*`, `**`, `?` wildcards, character classes and alternative sequences.
	// Please see https://github.com/bmatcuk/doublestar#patterns for more details.
	Glob(ctx context.Context, pattern string) (Iterator, error)

	// Head returns an object's meta info.
	Head(ctx context.Context, name string) (*MetaInfo, error)

	// Open opens an object for reading.
	Open(ctx context.Context, name string) (Reader, error)

	// Create creates/opens a object for writing.
	Create(ctx context.Context, name string, opts *WriteOptions) (Writer, error)

	// Remove removes a object.
	Remove(ctx context.Context, name string) error

	// Close closes the bucket.
	Close() error
}

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

type Iterator interface {
	// Next advances the cursor to the next position.
	Next() bool
	// Name returns the name at the current cursor position.
	Name() string
	// Size returns the length of the content in bytes for the current object.
	Size() int64
	// ModTime returns the modification time for the current object.
	ModTime() time.Time
	// Error returns the last iterator error, if any.
	Error() error
	// Close closes the iterator, should always be deferred.
	Close() error
}

type MetaInfo struct {
	Name        string    // base name of the object
	Size        int64     // length of the content in bytes
	ModTime     time.Time // modification time
	ContentType string    // content type
	Metadata    Metadata  // metadata
}

type Metadata map[string]string

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

type Reader interface {
	io.ReadCloser
}

type Resolver func(context.Context, *url.URL) (Bucket, error)

type WriteOptions struct {
	ContentType string
	Metadata    Metadata
}

type Writer interface {
	io.Writer

	// Discard closes and releases the writer without writing a file.
	Discard() error

	// Commit closes and commits the content by writing a file. Calls to Commit
	// will fail when Discard was called before.
	Commit() error
}