Skip to main content

A key value datastore which stores data locally in a memory-mapped file.

Project description

# [key-value-ds](https://pypi.org/project/key-value-ds/)

##### File based Key-Value datastore

Supports basic CRD (Create, Read, Delete)

Functionalities:
  1. It can be initialized using an optional file path. If one is not provided, it will reliably create itself using uuid.

  2. Key string capped at 32 characters and Value must be a JSON object capped at 16KB. (These values can be changed in config.py)

  3. Every key supports setting a Time-To-Live property when it is created. This property is optional. If provided, it will be evaluated as an integer defining the number of seconds. Once the Time-To-Live for a key has expired, the key will no longer be available for Read or Delete operations.

  4. Only one process can access the datastore (local file) at a time.

  5. Thread safe.

Usage:

###### Creating an instance ` import key_value_ds ds_instance = key_value_ds.get_instance() `

Note: If file_path is provided in the get_instance() call, it will obtain lock on that file using fcntl. If object is created for the same file path twice, BlockingIOError is thrown.

###### Creating an data ` data_key = 'test_key' data_value = {"value": 1} # must be a JSON time_to_live = 5*1000 # in milliseconds ds_instance.create(data_key, data_value, ttl=time_to_live) `

###### Retrieving data ` retrieve_key = 'test_key' ds_instance.get(retrieve_key) # returns {"value": 1} if retrieved within 5 seconds else ValueError `

###### Deleting data ` key_to_delete = 'test_key' ds_instance.delete(key_to_delete) # key-value is removed from the datastore `

###### Delete all data ` ds_instance.delete_all() `

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

key_value_ds-1.0.1.tar.gz (5.3 kB view hashes)

Uploaded Source

Built Distribution

key_value_ds-1.0.1-py3-none-any.whl (7.0 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page