blocker

README

blocker

Blocker is a non-RESTful HTTP API to write arbitrary blocks of data to storage, and to retrieve them by SHA1 hash key.

Status

EXPERIMENTAL - Not recommended for general use.

Installation

Blocker requires Go 1 or higher. Install with go get:

go get github.com/jmcvetta/blocker

Usage

# Start blocker in the background
$ blocker &
[1] 17059
Starting server on localhost:8080

# POST data and get SHA1 digest as key
$ wget -qO - --post-data="foo bar baz" http://localhost:8080/blocker ; echo
x1Z-izniQo44v5ySJqxo3kxn3Dk=

# Retreive data using key
$ wget -qO - http://localhost:8080/blocker/x1Z-izniQo44v5ySJqxo3kxn3Dk= ; echo
foo bar baz

Testing

Package gocheck is required to run the test suite.

go get launchpad.net/gocheck
go test -gocheck.v  # Verbose output

Name

The name "Blocker" is a silly pun on the popular application "Docker" - to which Blocker has no particular relationship or similarity - and "blocks of data".

License

This is Free Software, released under the terms of the AGPL v3.