aboutsummaryrefslogtreecommitdiff
path: root/objectdb/objectdb.go
blob: 3e45893a8d234a5eb91348aeaf29958f4f42ceb0 (about) (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
// Package objectdb provides storage interfaces for Git objects.
package objectdb

import (
	"errors"

	"codeberg.org/lindenii/furgit/objectid"
	"codeberg.org/lindenii/furgit/objecttype"
)

// ErrObjectNotFound indicates that an object does not exist in a backend.
// TODO: This might need to be an interface or otherwise be able to encapsulate multiple concrete backends'
var ErrObjectNotFound = errors.New("objectdb: object not found")

// ObjectDB reads Git objects by object ID.
type ObjectDB interface {
	// ReadBytesFull reads a full serialized object as "type size\\x00content".
	// If hashed with the same algorithm it MUST match the object ID.
	ReadBytesFull(id objectid.ObjectID) ([]byte, error)
	// ReadBytesContent reads an object's type and content bytes.
	ReadBytesContent(id objectid.ObjectID) (objecttype.Type, []byte, error)
	// ReadHeader reads an object's type and declared content length.
	ReadHeader(id objectid.ObjectID) (objecttype.Type, int64, error)
	// Close releases resources associated with the backend.
	Close() error
}