package odb import "io" // Blob represents a Git object of type "blob". type Blob struct { // Size is the total uncompressed size of the blob's contents. Size int64 // Contents is a reader that yields the uncompressed blob contents. It // may only be read once. It may or may not implement io.ReadSeeker. Contents io.Reader // closeFn is a function that is called to free any resources held by // the Blob. In particular, this will close a file, if the Blob is // being read from a file on disk. closeFn func() error } // Type implements Object.ObjectType by returning the correct object type for // Blobs, BlobObjectType. func (b *Blob) Type() ObjectType { return BlobObjectType } // Decode implements Object.Decode and decodes the uncompressed blob contents // being read. It returns the number of bytes that it consumed off of the // stream, which is always zero. // // If any errors are encountered while reading the blob, they will be returned. func (b *Blob) Decode(r io.Reader, size int64) (n int, err error) { b.Size = size b.Contents = io.LimitReader(r, size) b.closeFn = func() error { if closer, ok := r.(io.Closer); ok { return closer.Close() } return nil } return 0, nil } // Encode encodes the blob's contents to the given io.Writer, "w". If there was // any error copying the blob's contents, that error will be returned. // // Otherwise, the number of bytes written will be returned. func (b *Blob) Encode(to io.Writer) (n int, err error) { nn, err := io.Copy(to, b.Contents) return int(nn), err } // Closes closes any resources held by the open Blob, or returns nil if there // were no errors. func (b *Blob) Close() error { if b.closeFn == nil { return nil } return b.closeFn() }