blocks.store.file — mvxcvi/blocks 2.0.0

This store provides block storage backed by files in local directories. Each block is stored in a separate file. File block stores may be constructed using the file://<path-to-root-dir> URI form. Under the root directory, the store keeps a block files in a subdirectory, alongside some layout metadata and a directory.

$ROOT/meta.properties
$ROOT/blocks/111497df/35011497df3588b5a3...
$ROOT/landing/block.123456789.tmp

In many filesystems, performance degrades as the number of files in a directory grows. In order to reduce this impact and make navigating the blocks more efficient, block files are stored in multiple subdirectories consisting of the first four bytes of the multihashes of the blocks stored in them. Within each directory, blocks are stored in files whose names consist of the rest of their digests.

In addition to the blocks, a meta.properties file at the root holds information about the current storage layout for future-proofing. This currently holds a single property, the layout version, which is always "1".

file-block-store clj

(file-block-store root & {:as opts})

Creates a new local file-based block store.

layout-version clj

The current supported storage layout version.