gs

type Client interface {
	// Close closes the connection to Google Storage.
	Close() error

	// Attrs retrieves Object attributes for a given path.
	Attrs(p Path) (*gs.ObjectAttrs, error)

	// Objects retrieves all object attributes for a given path.
	Objects(p Path) ([]*gs.ObjectAttrs, error)

	// SignedURL generates a google storage signed url for a given path.
	SignedURL(p Path, opts *gs.SignedURLOptions) (string, error)

	// NewReader instantiates a new Reader instance for the named bucket/path.
	//
	// The supplied offset must be >= 0, or else this function will panic.
	//
	// If the supplied length is <0, no upper byte bound will be set.
	//
	// The reader inherits the context of the client.
	NewReader(p Path, offset, length int64) (io.ReadCloser, error)

	// NewWriter instantiates a new Writer instance for the named bucket/path.
	//
	// The writer inherits the context of the client.
	NewWriter(p Path) (Writer, error)

	// Delete deletes the object at the specified path.
	//
	// If the object does not exist, it is considered a success.
	Delete(p Path) error

	// Rename renames an object from one path to another.
	//
	// NOTE: The object should be removed from its original path, but current
	// implementation uses two operations (Copy + Delete), so it may
	// occasionally fail.
	Rename(src, dst Path) error
}

type LimitedClient struct {
	// Base is the base Client instance.
	Client

	// MaxReadBytes, if >0, is the maximum number of bytes that can be read at a
	// time. If more bytes are required, additional read calls will be made.
	MaxReadBytes int64
}

type Path string

type Writer interface {
	io.WriteCloser

	// Count returns the number of bytes written by the object.
	Count() int64
}