Oh-My-PickleDB is an open source key-value store using Python's json module
Project description
OH-MY-PICKLEDB
oh-my-pickleDB is a lightweight, fast, and intuitive data manager written in python
📝 Table of Contents
- About
- Getting Started
- Deployment
- Usage
- Built Using
- TODO
- Contributing
- Authors
- Acknowledgments
- Useful Links
🧐 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
- @tory1103 - Idea, Concept & Initial work
See also the list of contributors who participated in this project.
🎉 Acknowledgements
✨ Useful links
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 11734e047a88757b9b0e2be72f5abc320143e4589c11ab5ee2d95c9f43620440 |
|
MD5 | d40a3cb7035db2483cf1907573c6db24 |
|
BLAKE2b-256 | 6e11fd3c58f9576d475c96381eec97011a65585503ff744e49fd7f086b6ed919 |
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 46f89181964c55039e4d4541c5ba8fea0545e55acaad636ae53e4e4637d16efe |
|
MD5 | d19a49219ca347c24b2494a04ce374d7 |
|
BLAKE2b-256 | bbe718a059ddd08c6ad9c2789782746d76d878dd585c8d2b9a202f545c16187f |