securedb

securedb is a lightweight Python framework that lets you work with encrypted JSON-based databases.

pip install securedb --upgrade

Content index

• Changelog
  • New in 2.0.0 (Latest)
  • New in 1.1.0
• Documentation
  • Creation
    • Key
    • Initialization
  • Writing
    • write()
    • write_many()
  • Deleting
    • delete()
    • delete_many()
    • clear()
  • Reading
    • get()
    • get_many()

Changelog

New in 2.0.0 (Latest)

• Completely redesigned db schema, now using single files for each database key
• Maximum database storage size heavily increased
• Lower memory consumption
• Mapped every possible error
• Custom key file path

New in 1.1.0

• force kwarg added in the initialization; see initialization
• You don't need to manually encode the key during the initialization
• If there is no error, all the functions now return True
• Useless print() functions were removed
• Smoother error handling

Documentation

Creation

Key

To create a database, an encryption key is needed. To generate it, you can use the built-in newkey() function.

import securedb
securedb.newkey()

This will create a new file named ".key" which contains a randomly generated encryption key.

Initialization

Now, create a blank file (there aren't file extensions restrictions), copy the path and the init the Db() class:

import securedb
with open(".key", "r") as f:
    key = f.read()
db = securedb.Db(path, key, force=True)

With force=True the program will create a new db in the given path if no database is found. force is default set to False. Remember that if you lost your key there will be no way to recover the database content, so keep it safe!

Writing

write()

The write(key, value) function allows you to insert a single value into the database. key is the value name value is the value data.

key is used to access the data, and must be an integral or a string; value can be anything such as boolean, integer, string, array, list, dictionary ecc.

write_many()

The write_many(payload) function allows you to write many values in a single time. payload is a dictionary with all the values you need to insert: {key: value, key1: value1, key2: value2}` etc. There isn't any limit regarding the size of the input dictionary.

Deleting

delete()

The delete(key) function allows you to delete a single value from the database. key is the value's key inside the database (see write) and must be a string or an integer.

delete_many()

The delete_many(payload) function allows you to delete many values at the same time. payload is a list of the keys you want to delete: [key, key1, key2] etc.

clear()

The clear() functions is a dangerous function that allows you to erease the whole database. Be careful using it, because this action cannot be undone and the function doesn't ask confirmation before ereasing the database.

Reading

get()

To read any value from the database, you need to use the get(key) function. key is the key of the value you want to read (see write).

get_many()

To read any value from the database, you need to use the get_many(keys) function. keys is a list of the keys you want to read (see write).