Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bobg/hashsplit
https://github.com/bobg/hashsplit
Last synced: 14 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/bobg/hashsplit
- Owner: bobg
- License: mit
- Created: 2020-04-26T00:30:09.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2021-08-19T02:46:31.000Z (about 3 years ago)
- Last Synced: 2024-05-30T02:39:36.345Z (5 months ago)
- Language: Go
- Size: 351 KB
- Stars: 28
- Watchers: 5
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: Readme.md
- License: LICENSE
Awesome Lists containing this project
- awesome-go - hashsplit - Split byte streams into chunks, and arrange chunks into trees, with boundaries determined by content, not position. (Data Structures and Algorithms / Trees)
- awesome-go-extra - hashsplit - 04-26T00:30:09Z|2021-08-19T02:46:31Z| (Generators / Trees)
README
# Hashsplit - content-based splitting of byte streams
[](https://pkg.go.dev/github.com/bobg/hashsplit/v2)
[](https://goreportcard.com/report/github.com/bobg/hashsplit/v2)
[](https://coveralls.io/github/bobg/hashsplit?branch=master)
Hashsplitting is a way of dividing a byte stream into pieces
based on the stream's content rather than on any predetermined chunk size.
As the Splitter reads the stream it maintains a _rolling checksum_ of the last several bytes.
A chunk boundary occurs when the rolling checksum has enough trailing bits set to zero
(where “enough” is a configurable setting that determines the average chunk size).
## Usage
You can split the input from `r`,
an `io.Reader`,
like this:
```go
split, errptr := hashsplit.Split(r)
for chunk := range split {
// ...handle the contents of r one chunk at a time...
}
if err := *errptr; err != nil {
// ...handle an error reading from r...
}
```
Chunks can be arranged in a “hashsplit tree” like this:
```go
split, errptr := hashsplit.Split(r)
tree := hashsplit.Tree(split)
root := hashsplit.Root(tree)
if err := *errptr; err != nil {
// ...handle an error reading from r...
}
```
...and now `root` is the root of a tree whose leaves contain consecutive chunks of the input.
## What is it all about?
Hashsplitting has benefits when it comes to representing multiple,
slightly different versions of the same data.
Consider, for example, the problem of adding EXIF tags to a JPEG image file.
The tags appear near the beginning of the file, and the bulk of the image data follows.
If the file were divided into chunks at (say) 8-kilobyte boundaries,
then adding EXIF data near the beginning would alter every following chunk
(except in the lucky case where the size of the added data is an exact multiple of 8kb).
With hashsplitting, only the chunks in the vicinity of the change are affected.
A sequence of hashsplit chunks can additionally be organized into a tree for even better compaction.
Each chunk has a “level” L determined by the rolling checksum,
and each node in the tree has a level N.
Tree nodes at level 0 collect chunks at level 0,
up to and including a chunk at level L>0;
then a new level-0 node begins.
Tree nodes at level N collect nodes at level N-1
up to and including a chunk at level L>N;
then a new level-N node begins.
Hashsplitting is used to dramatically reduce storage and bandwidth requirements
in projects like
[rsync](https://rsync.samba.org/),
[bup](http://bup.github.io/),
and [perkeep](https://perkeep.org/).
More information,
and a proposed standard,
can be found at
[github.com/hashsplit/hashsplit-spec](https://github.com/hashsplit/hashsplit-spec).