diff options
-rw-r--r-- | format-green-albatross.mdwn | 10 |
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 ================== |