An interface to transparently bind Python objects to JSON files, so that all changes made to the object are reflected in the JSON file
livejson allows you to cleanly manipulate JSON objects as though they were Python
dicts, with your file transparently updating in the background. It's pure-python with no dependencies, and compatible across Python 2 and Python 3.
- Easy: use
livejsonwith the same interface as Python
dicts, meaning it can basically be used as a drop-in replacement.
livejsonfully supports complex nestings of
dicts, meaning it can represent any valid JSON file.
livejsonworks perfectly on both Python 2 and Python 3.
livejsonis a single file with no external dependencies. Just install and go!
- Reliable: by default, no caching is used. Every single time you access a
livejson.Database, it's read straight from the file. And every time you write to it, the change is instant. No delays, no conflicts. However, if efficiency is important, you can use the context manager to perform "grouped writes", which allow for performing a large number of operations with only one write at the end.
- 100% test covered Be confident that
livejsonis working properly
livejson can be used for:
- Database storage: you can use
livejsonto easily write flexible JSON databases, without having to worry about complex
closeoperations, or learning how to use the
- Debugging: You can use
livejsonto back up your Python objects. If you use a
livejson.Databaseinstead of a
listand your script crashes you'll still have a hard copy of your object. And you barely had to change any of your code.
- General-purpose JSON: If your script or application needs to interact with JSON files in any way, consider using
livejson, for simplicity's sake.
livejsoncan make your code easier to read and understand, and also save you time.
Thanks to dgelessus for naming this project.
livejson supports both Python 2 and 3, and can be easily installed with
# Python 2 sudo pip install livejson # Python 3 sudo pip3 install livejson
After installing, you can just
import livejson from your code!
import livejson f = livejson.File("test.json") f["a"] = "b" # That's it, the file has been written to!
As a context manager:
import livejson with livejson.File("test.json") as f: f["a"] = "b"