aboutsummaryrefslogtreecommitdiff
path: root/object/store/loose/store.go
diff options
context:
space:
mode:
authorGravatar Runxi Yu2026-03-28 04:19:44 +0000
committerGravatar Runxi Yu2026-03-28 04:20:29 +0000
commit402ef2733813d128631ca4aea18c2908c74340d5 (patch)
treee03a90b6f41411bd62e7339390802c5c50082850 /object/store/loose/store.go
parentobject/store: Rename from object/storer (diff)
signatureNo signature
object/store: Rename back from storer; rename Store to ReadingStore v0.1.118
Diffstat (limited to 'object/store/loose/store.go')
-rw-r--r--object/store/loose/store.go41
1 files changed, 41 insertions, 0 deletions
diff --git a/object/store/loose/store.go b/object/store/loose/store.go
new file mode 100644
index 00000000..d8eba84e
--- /dev/null
+++ b/object/store/loose/store.go
@@ -0,0 +1,41 @@
+// Package loose provides a loose object backend (objects/XX/YYYYY..).
+package loose
+
+import (
+ "os"
+
+ objectid "codeberg.org/lindenii/furgit/object/id"
+)
+
+// Store reads loose Git objects from an objects directory root.
+//
+// Loose objects are zlib streams whose trailer uses Adler-32. Which reads
+// consume enough of the stream to reach and verify that trailer is documented
+// on the individual methods.
+type Store struct {
+ // root is the objects directory capability used for all object file access.
+ // Object files are opened by relative paths like "<first2>/<rest>".
+ // Store borrows this root.
+ root *os.Root
+ // algo is the expected object ID algorithm for lookups.
+ algo objectid.Algorithm
+}
+
+// New creates a loose-object store rooted at an objects directory for algo.
+func New(root *os.Root, algo objectid.Algorithm) (*Store, error) {
+ if algo.Size() == 0 {
+ return nil, objectid.ErrInvalidAlgorithm
+ }
+
+ return &Store{
+ root: root,
+ algo: algo,
+ }, nil
+}
+
+// Close releases resources associated with the backend.
+//
+// Store borrows its root, so Close does not close it.
+//
+// Repeated calls to Close are undefined behavior.
+func (store *Store) Close() error { return nil }