{"id":27397,"library":"simplekv","title":"simplekv","description":"A key-value store for binary data, supporting multiple backends including filesystem, Redis, MongoDB, Azure Blob Storage, and Amazon S3. Current version: 0.14.1. Release cadence is irregular, with occasional minor and patch releases.","status":"active","version":"0.14.1","language":"python","source_language":"en","source_url":"http://github.com/mbr/simplekv","tags":["key-value","storage","redis","s3","azure","filesystem","mongodb"],"install":[{"cmd":"pip install simplekv","lang":"bash","label":"Install core library"},{"cmd":"pip install simplekv[redis]","lang":"bash","label":"Install with Redis backend support"},{"cmd":"pip install simplekv[s3]","lang":"bash","label":"Install with S3 (boto) backend support"}],"dependencies":[{"reason":"Required for RedisStore backend when using simplekv[redis]","package":"redis","optional":true},{"reason":"Required for S3 backend when using simplekv[s3]","package":"boto3","optional":true},{"reason":"Required for Azure backend; version 12+ supported since simplekv 0.14.0","package":"azure-storage-blob","optional":true},{"reason":"Required for MongoDB backend when using simplekv[mongo]","package":"pymongo","optional":true}],"imports":[{"note":"Base class for all stores.","symbol":"KeyValueStore","correct":"from simplekv import KeyValueStore"},{"note":"Redis backend store.","symbol":"RedisStore","correct":"from simplekv.contrib.redis import RedisStore"},{"note":"Amazon S3 backend store (boto3).","symbol":"S3Store","correct":"from simplekv.contrib.s3 import S3Store"},{"note":"Local filesystem backend.","symbol":"FilesystemStore","correct":"from simplekv.fs import FilesystemStore"},{"note":"MongoDB backend.","symbol":"MongoStore","correct":"from simplekv.contrib.mongo import MongoStore"},{"note":"Azure Blob Storage backend (since 0.14.0).","symbol":"AzureBlockBlobStore","correct":"from simplekv.contrib.azure import AzureBlockBlobStore"}],"quickstart":{"code":"import os\nfrom simplekv.contrib.redis import RedisStore\n\n# Initialize store (assuming Redis running on localhost)\nstore = RedisStore(host='localhost', port=6379)\n\n# Put a value\nstore.put('key', b'value')\n\n# Get a value\nvalue = store.get('key')\nprint(value)\n\n# Delete a value\nstore.delete('key')\n","lang":"python","description":"Basic usage of RedisStore."},"warnings":[{"fix":"Use `list(store.keys())` to get a list.","message":"The `keys()` method returns a generator in Python 3 (since 0.12.0), not a list. This is a change from earlier versions where it returned a list. Wrap with `list()` if you need a list.","severity":"gotcha","affected_versions":">=0.12.0"},{"fix":"Update dependencies to `azure-storage-blob>=12` and import `AzureBlockBlobStore`.","message":"In version 0.14.0, the Azure backend switched to `azure-storage-blob` version 12. Old code using the old Azure SDK will break. The store class name is now `AzureBlockBlobStore`.","severity":"breaking","affected_versions":">=0.14.0"},{"fix":"Do not use `seek()` or `tell()` on S3Store opened files; read sequentially or download the entire object.","message":"The `S3Store`'s `open()` method removed seek/tell support in version 0.11.7 due to leaking HTTP connections. If you rely on random access on S3 file-like objects, this will break.","severity":"gotcha","affected_versions":">=0.11.7"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Install simplekv with redis support: `pip install simplekv[redis]`","cause":"The `redis` extra dependency is missing.","error":"ImportError: No module named 'simplekv.contrib.redis'"},{"fix":"Convert to list: `list(store.keys()).sort()`","cause":"`keys()` now returns a generator instead of a list (since 0.12.0).","error":"AttributeError: 'generator' object has no attribute 'sort'"},{"fix":"Convert to list before passing to other processes: `list(store.keys())`","cause":"Trying to pickle the result of `keys()` (a generator) in multiprocessing context.","error":"TypeError: can't pickle 'generator' objects"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}