humus.py 0.1.0

A client for the humus composting database

Humus.py

(A python client for) a composting database.

Simple python client for Humus, the forgetful database.

Installation:

pip install humus.py # Not pip install humus, that's someone else's project that ironically does the complete opposite

Usage:

First, make sure the Humus server is running somewhere you can access it.

Then you can create a client object:

import humus

# Create a client.
# Looks for HUMUS_PROTOCOL, HUMUS_HOST and HUMUS_PORT environment variables,
# or by default connects to humus on http://localhost:3030

client = humus.Client()

# Otherwise you can provide protocol, host and port as arguments:
client = humus.Client(host="somehost", port=1234, protocol="https")

Once you have your client, you can start storing and retrieving objects:

# Put (any json-serializable) dict at a path:
client.insert("path/to/the_object", { "hello": "world"})

# Get objects at a path:
client.get("path/to/the_object")
# => [{ "hello": "world"}]

Further information on the humus, its data model, and our innovative and forward-thinking strong guarantee of transience™ can be found in the main humus repository.