Skip to main content

Oh-My-PickleDB is an open source key-value store using Python's json module

Project description

logo

OH-MY-PICKLEDB

GitHub status GitHub issues GitHub pull requests GitHub license GitHub last commit


oh-my-pickleDB is a lightweight, fast, and intuitive data manager written in python

📝 Table of Contents

🧐 About

oh-my-pickleDB is an improved version of PickleDB, with notable differences compared to the original. Most important differences are:

  • Cryptographic utils - Encrypt/Decrypt data content using FERNET symmetric encryption
  • Code improvements - More readable documentation, improved code, etc...
  • Data conversions - Byte, json, or str conversions
  • More flexibility - Save/load data as bytes, json or str, you decide!
  • Utilities - Export data as XML

🏁 Getting Started

Prerequisites

python~=3.9
cryptography~=3.4.8
setuptools~=58.1.0
fire~=0.4.0

Installing

# Using python pip
$ pip install oh-my-pickledb

# Using git
$ git clone https://github.com/tory1103/oh-my-pickledb.git
$ cd oh-my-pickledb
$ pip install -r requirements.txt
$ python setup.py install

🔧 Running the tests

Tests are found on tests folder.
In future versions, tests will be added inside code documentation as multi-row comments.

Break down into end to end tests

cd /tests
python3 <test_name>.py

🎈 Usage

from my_pickledb import PickleDB

database = PickleDB("test.json")  # PickleDB object

database.set('key', 'value')  # Creates new key and value
database.get('key')  # Must return 'value'
database.save.as_json()  # Must save database to file on specified path

🚀 Deployment

oh-my-pickleDB is a python library, when installed, just import it to your project.

import my_pickledb
from my_pickledb import *

⛏️ Built Using

  • Python
  • Json
  • Data Structures

✍️ Authors

See also the list of contributors who participated in this project.

🎉 Acknowledgements

✨ Useful links

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

oh-my-pickledb-0.4.2.tar.gz (20.9 kB view details)

Uploaded Source

Built Distribution

oh_my_pickledb-0.4.2-py3-none-any.whl (19.6 kB view details)

Uploaded Python 3

File details

Details for the file oh-my-pickledb-0.4.2.tar.gz.

File metadata

  • Download URL: oh-my-pickledb-0.4.2.tar.gz
  • Upload date:
  • Size: 20.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.6.3 pkginfo/1.7.1 requests/2.24.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.9.9

File hashes

Hashes for oh-my-pickledb-0.4.2.tar.gz
Algorithm Hash digest
SHA256 11734e047a88757b9b0e2be72f5abc320143e4589c11ab5ee2d95c9f43620440
MD5 d40a3cb7035db2483cf1907573c6db24
BLAKE2b-256 6e11fd3c58f9576d475c96381eec97011a65585503ff744e49fd7f086b6ed919

See more details on using hashes here.

File details

Details for the file oh_my_pickledb-0.4.2-py3-none-any.whl.

File metadata

  • Download URL: oh_my_pickledb-0.4.2-py3-none-any.whl
  • Upload date:
  • Size: 19.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.6.3 pkginfo/1.7.1 requests/2.24.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.9.9

File hashes

Hashes for oh_my_pickledb-0.4.2-py3-none-any.whl
Algorithm Hash digest
SHA256 46f89181964c55039e4d4541c5ba8fea0545e55acaad636ae53e4e4637d16efe
MD5 d19a49219ca347c24b2494a04ce374d7
BLAKE2b-256 bbe718a059ddd08c6ad9c2789782746d76d878dd585c8d2b9a202f545c16187f

See more details on using hashes here.

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