summaryrefslogtreecommitdiff
path: root/format-green-albatross.mdwn
diff options
context:
space:
mode:
Diffstat (limited to 'format-green-albatross.mdwn')
-rw-r--r--format-green-albatross.mdwn10
1 files changed, 9 insertions, 1 deletions
diff --git a/format-green-albatross.mdwn b/format-green-albatross.mdwn
index ef00495..c5361de 100644
--- a/format-green-albatross.mdwn
+++ b/format-green-albatross.mdwn
@@ -48,6 +48,13 @@ This repository format takes the following approach:
Bags
====
+A bag is used to store a number of blobs. Bags are identified by a
+random 64-bit integer. This is used as the filename of the bag. The
+bags are stored in a 3-level directory structure, using the top three
+octets of the bag id as the directory names. Thus, a bag whose id in
+hexadecimal is 0x1234567890abcdef would be stored as
+`12/34/56/1234567890abcdef.bag`.
+
A bag is implemented as a Python `dict` object:
{
@@ -55,9 +62,10 @@ A bag is implemented as a Python `dict` object:
'blobs': [...],
}
-The `blobs` field contains the blobs. Each blob may be an arbitrary
+The `items` field contains the blobs. Each blob may be an arbitrary
byte string (for chunks), or an encoded Python object.
+
Object identifiers
==================