simple-crypt-dat 1.0.0

Super lightweight, secure local file-based database encrypted with AES/Fernet + PBKDF2

Simple Crypt Dat

Super lightweight, secure local JSON file-based database encrypted with AES (Fernet) and derived keys using PBKDF2HMAC-SHA256. Perfect for desktop apps, Telegram bots, or lightweight scripts requiring password-protected data files.

Installation

Install using pip:

pip install simple-crypt-dat

Features

• No Server Needed: Store data in a single local .dat file.
• AES-128 in CBC mode + HMAC-SHA256: Handled via standard Cryptography Fernet.
• PBKDF2 Key Derivation: Automatically derives keys using 100,000 iterations and a cryptographically secure random 16-byte salt saved directly inside the file header.
• JSON Serializable: Store complex Python lists, dicts, strings, and numbers easily.
• Password retry friendly: Raises custom InvalidPasswordError when decryption fails.

Quick Start

1. Save Encrypted Data

from simple_crypt_dat import EncryptedFileDB

# Initialize DB with the target file path
db = EncryptedFileDB("secrets.dat")

# Any JSON-serializable Python structure
secret_accounts = [
    {"user": "admin", "token": "abc123xyz"},
    {"user": "moderator", "token": "pqr456lmn"}
]

# Encrypt and save with a password
db.save(secret_accounts, password="MySuperSecretPassword")
print("Encrypted data saved successfully to secrets.dat!")

2. Load and Decrypt Data

from simple_crypt_dat import EncryptedFileDB, InvalidPasswordError

db = EncryptedFileDB("secrets.dat")

try:
    # Load and decrypt using the correct password
    data = db.load(password="MySuperSecretPassword")
    print("Decrypted Data:", data)
    
except InvalidPasswordError:
    print("Error: The password entered is incorrect!")
except FileNotFoundError:
    print("Error: Database file not found.")

License

MIT License.