Skip to main content

Bind Python objects to JSON files

Project description


Build Status Coverage Status PEP8

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.

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"

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

livejson-1.9.1.tar.gz (6.2 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page