Skip to main content

creation, access and modification of SQL databases

Project description


folktales enables the creation, access and modification of SQL databases, with an emphasis on storing dictionaries easily and accessing database tables as pandas DataFrames easily. It also provides template dictionaries suitable for logging. While it can be used with other databases, it is designed currently to be used easily with SQLite3 databases.

folktales might be used in a logging context, whereby a status dictionary, which features a UUID4 identifier and a UTC datetime by default, is updated with program characteristics or other data and then saved to database.


pip install folktales

Sqliteman is a GUI tool that can be used to interact with SQLite3 databases.

apt install sqliteman


create a database

folktales.create_database(filepath = "database.db")

access a database

database = folktales.access_database(filepath = "database.db")

insert a dictionary into a database table

    dictionary      = {
                      "a": 1,
                      "b": 2
    table_name      = "data",
    filepath        = "database.db"

state dictionaries

A template state dictionary can be created in the following way:


This returns a dictionary that features a UUID4 identifier (uuid.uuid4()) and a datetime (datetime.datetime.utcnow()).

A state dictionary can be created at the same time as updating it with an existing dictionary in the following way:

    entries = {
              "state_ID"             : "84f80687-cdd7-48f9-b21c-3d75fd759604",
              "price_recommendation" : 5007.24

insert a state dictionary into a database table

    entries    = {
                 "state_ID"             : "84f80687-cdd7-48f9-b21c-3d75fd759604",
                 "price_recommendation" : 5007.24
    table_name = "do_stocks",
    filepath   = "database.db"

access a database table as a pandas DataFrame

df = folktales.DataFrame_of_database_table(
    filepath   = "database.db",
    table_name = "do_stocks"

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for folktales, version 2018.5.3.245
Filename, size File type Python version Upload date Hashes
Filename, size folktales-2018.5.3.245.tar.gz (3.9 kB) File type Source Python version None Upload date Hashes View

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 Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page