A Python library implementing a dict-like object that writes to a JSON file as it is modified
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
setup.py Fix unclosed file Jul 28, 2016



Build Status Coverage Status PEP8

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.

Demo gif

livejson is:

  • Easy: use livejson with the same interface as Python lists and dicts, meaning it can basically be used as a drop-in replacement.
  • Flexible: livejson fully supports complex nestings of lists and dicts, meaning it can represent any valid JSON file.
  • Compatible: livejson works perfectly on both Python 2 and Python 3.
  • Lightweight: livejson is 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 livejson is working properly

livejson can be used for:

  • Database storage: you can use livejson to easily write flexible JSON databases, without having to worry about complex open and close operations, or learning how to use the json module.
  • Debugging: You can use livejson to back up your Python objects. If you use a livejson.Database instead of a dict or a list and 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. livejson can 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 pip.

# Python 2
sudo pip install livejson
# Python 3
sudo pip3 install livejson

After installing, you can just import livejson from your code!

Example usage

Basic usage:

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"