blob

type Blob interface {
	ReadOnlyBlob
	WriteableBlob
}

type DigestAware interface {
	// Digest returns the blob digest if known.
	Digest() (digest string, known bool)
}

type DigestPrecalculatable interface {
	// HasPrecalculatedDigest returns true if a precalculated digest of the blob is known in advance.
	HasPrecalculatedDigest() bool
	// SetPrecalculatedDigest sets the digest of the blob if it is known in advance.
	// Once set, HasPrecalculatedDigest must return true.
	// It MUST be safe for concurrent use, serializing as necessary.
	// It MUST be safe to call multiple times, overwriting the digest every time.
	SetPrecalculatedDigest(digest string)
}

type DirectReadOnlyBlob struct {
	*EagerBufferedReader
}

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

type MediaTypeAware interface {
	// MediaType returns the media type of the blob if known.
	MediaType() (mediaType string, known bool)
}

type MediaTypeOverrideable interface {
	// SetMediaType overrides the media type of the blob if it is known in advance.
	// It MUST be safe for concurrent use, serializing as necessary.
	// It MUST be safe to call multiple times, overwriting the mediaType every time.
	SetMediaType(mediaType string)
}

type ReadOnlyBlob interface {
	// ReadCloser returns a reader to incrementally access byte stream content
	// It is the caller's responsibility to close the reader.
	//
	// ReadCloser MUST be safe for concurrent use, serializing access as necessary.
	// ReadCloser MUST be able to be called multiple times, which each invocation
	// returning a new reader, that starts from the beginning of the blob.
	//
	// Note that this behavior is not parallel to WriteableBlob.WriteCloser
	ReadCloser() (io.ReadCloser, error)
}

type SizeAware interface {
	// Size returns the blob size in bytes if known.
	// If the size is unknown, it MUST return SizeUnknown.
	Size() (size int64)
}

type SizePrecalculatable interface {
	// HasPrecalculatedSize returns true if a precalculated size of the blob is known in advance.
	HasPrecalculatedSize() bool
	// SetPrecalculatedSize sets the size of the blob if it is known in advance.
	// It MUST be safe for concurrent use, serializing as necessary.
	// It MUST be safe to call multiple times, with the same or greater different size.
	// Once called, HasPrecalculatedSize MUST return true.
	// If called with a size less than the current size, it MUST ignore this size.
	SetPrecalculatedSize(size int64)
}

type WriteableBlob interface {
	// WriteCloser returns a writer to incrementally write byte stream content
	// It is the caller's responsibility to close the writer.
	//
	// WriteCloser MUST be safe for concurrent use, serializing access as necessary.
	// WriteCloser MUST be able to be called multiple times, which each invocation
	// returning a new writer, that appends to the previous one.
	WriteCloser() (io.WriteCloser, error)
}