stashdb
v0.7.0
Published
Topic based data repository
Downloads
8
Readme
stashdb
A REST based data store that syncs
Features
- Supports PUT and GET of REST resources ("files") of any content type.
- Stores everything in RAM for fast access.
- Stores differential history to enable syncing of collections.
Basics
/some/resource
If you PUT /some/resource
, stashdb will store the resouce you have provided and return it verbatim on any subsequent GET
with the same path.
/some/collection/
If you PUT /some/collection/resource
, the collection /some/collection is created automatically for you (and all intermediary collections).
After this, you can iterate on all resources in the collection like this:
GET /some/collection/?get
This will fetch the first resource from the collection and return a next
link to the next available resource.
Specifically, following the next
link can return the following:
- The
Name
header has been set- HTTP 200: Resource available: the resource with the provided name is returned.
- HTTP 204: Resource gone: the resource with the provided name has been deleted.
- The
Name
header is missing- HTTP 204: No more resources: there is no more resources in this collection.
In all three cases above, the service will always return a next
link. In the case where there is no more resources, following the next
link may return a new resource that was added since the request to the server that returned the link.