Skip to main content

Create a simple JSON database with just one line of code!

Project description

Simple Json Database

Do you need a simple, small, and very easy to use local database? You have come to the right place! with simplejsondb you can create a simple JSON database with only one line of code, and we will take care of the rest!

A basic example

from simplejsondb import Database

# If database named 'translations' doesn't exist yet, creates a new empty dict database
translations = Database('translations.json', default=dict())

# Now, we can treat the database instance as a dictionary!['Hello'] = 'Hola'['Goodbye'] = 'Adiֳ³s'
print(   # dict_values(['Hola', 'Adiֳ³s'])

# The database will automatically save the changes when the program exits

After running the code above for the first time, a file named translations.json will be automatically created under the current working directory. Then, we will be able to use the database inside other scripts, and treat it as a dictionary:

from simplejsondb import Database

# loads the previously saved translations database
translations = Database('translations.json')

# Again, we treat the 'translations' instance as a dictionary
print(f"Hello in Spanish is {['Hello']}!")
# This will output: Hello in Spanish is Hola!

# We can also use the built in dictionary methods
for english, spanish in
    print(f"{english} in Spanish is {spanish}!")

# This will output:
# Hello in Spanish is Hola!
# Goodbye in Spanish is Adiֳ³s!


The simplest way to install simplejsondb is by using pip. Just run the following command in your terminal:

$ (sudo) pip install simplejsondb

You can also clone the Github repo, download the latest release from Github or directly from PyPI. Then, unzip the files (if they are zipped), and use the following command to install the package:

$ (sudo) python install

If the command above didn't work, make sure that you have the setuptools package installed using:

$ (sudo) pip install setuptools


Database(path, default=None, overwrite=False, save_at_exit=True)

The constructor of the Database instance. Receives a path to a JSON file, and tries to load it. If the file doesn't exist, loads the default data that is passed using the default argument.


  • path (str): The path to the json database file.
  • default: The default data that will be loaded if the file doesn't exist yet.
  • overwrite (bool): If True, loads the default without checking if the file exists.
  • save_at_exit (bool): If True (default), will automatically dump the database into storage when the program exits.**additional)

By default, the database is loaded from the local storage when the instance is created. It is then saved in the memory, until the program exits - and only then the new and updated data is saved back in the local storage. By using the method, you can save the database into the local storage before the program exists, in any given point.

Additional arguments

The save method supports receiving additional keyword arguments that are directly passed into the json.dump function. One useful argument can be indent that is a non-negative integer that sets the indention level of the dumped json file. For more information, check out the json module documentation.


Loads the data from the json file into the instance. Overwrites previous data that was saved under the .data property.



A property that contains the path to the database JSON file.


A property that stores the absolute path to the directory where the database json file lives in.

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

simplejsondb-0.2.0.tar.gz (4.3 kB view hashes)

Uploaded Source

Built Distribution

simplejsondb-0.2.0-py3-none-any.whl (4.6 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