A lightweight, persistent data store with dictionary, key-value, and linked list support with GUI
PyPi: Click Here
pyhold is a lightweight, persistent data store built in pure Python with multiple data structure support. Designed for MVPs, CLI tools, and embedded apps that need quick and reliable state saving — no database required.
store["token"] = "abc"int, str, float, bool, dict, list, tuple, NonePython Version: 3.7 or higher
Built-in Dependencies (included with Python):
tkinter - For GUI functionality (included in most Python installations)xml.etree.ElementTree - For XML file operationsjson - For complex data type serializationast - For literal evaluationNote: The GUI features require tkinter, which is included in most Python installations but may need to be installed separately on some Linux distributions:
# Ubuntu/Debian
sudo apt-get install python3-tk
# CentOS/RHEL/Fedora
sudo yum install tkinter
# or
sudo dnf install python3-tkinter
# macOS (usually included with Python)
# If missing: brew install python-tk
pip install pyhold
The key-value store provides dictionary-like functionality with persistent storage to XML files.
from pyhold import pyhold
# Initialize in keyvalue mode
kv_store = pyhold("my_data.xml", mode="keyvalue", auto_sync=True, auto_reload=True)
# Set values
kv_store["username"] = "john_doe"
kv_store["age"] = 25
kv_store["settings"] = {"theme": "dark", "notifications": True}
# Get values
print(kv_store["username"]) # "john_doe"
print(kv_store["age"]) # 25
# Check if key exists
if "username" in kv_store:
print("User found!")
# Delete items
del kv_store["age"]
# or
kv_store.pop("age") # Returns the value and removes it
# Get with default value
value = kv_store.get("missing_key", "default_value")
# Get all keys, values, or items
keys = kv_store.keys() # ['username', 'settings']
values = kv_store.values() # ['john_doe', {'theme': 'dark', 'notifications': True}]
items = kv_store.items() # [('username', 'john_doe'), ('settings', {...})]
# Get length
print(len(kv_store)) # Number of key-value pairs
# Clear all data
kv_store.clear()
# Manual save/reload
kv_store.save_pyhold() # Force save to XML
kv_store.load_pyhold() # Force reload from XML
# Alternative way to add/update values
kv_store.write("api_key", "abc123")
kv_store.write("counter", 42)
# Open graphical interface for managing data
kv_store.show_gui()
from pyhold import pyhold
# Initialize store in keyvalue mode
config = pyhold("app_config.xml", mode="keyvalue")
# Store application settings
config["app_name"] = "MyApp"
config["version"] = "1.0.0"
config["debug_mode"] = True
config["database"] = {
"host": "localhost",
"port": 5432,
"name": "myapp_db"
}
config["features"] = ["auth", "logging", "api"]
# Retrieve settings
print(f"App: {config['app_name']} v{config['version']}")
print(f"Debug: {config['debug_mode']}")
print(f"DB Host: {config['database']['host']}")
# Check if feature is enabled
if "auth" in config["features"]:
print("Authentication is enabled")
# Update settings
config["version"] = "1.1.0"
config["debug_mode"] = False
# Open GUI to manage settings
config.show_gui()
The linked list provides a persistent, index-based data structure with full list operations.
from pyhold import pyhold
# Initialize in linkedlist mode
ll = pyhold("my_list.xml", mode="linkedlist", auto_sync=True, auto_reload=True)
# Add items
ll.append("first item")
ll.append(42)
ll.append({"nested": "data"})
# Access by index
print(ll[0]) # "first item"
print(ll[1]) # 42
# Set items by index
ll[0] = "updated first item"
# Check if value exists
if "first item" in ll:
print("Item found!")
# Get length
print(len(ll)) # Number of items
# Insert at specific index
ll.insert(1, "inserted item") # Inserts at index 1
# Remove by value
ll.remove("inserted item") # Removes first occurrence
# Remove by index
ll.pop(0) # Removes and returns item at index 0
ll.pop() # Removes and returns last item
# Delete by index
del ll[0] # Removes item at index 0
# Find index of value
try:
index = ll.index("first item")
print(f"Found at index: {index}")
except ValueError:
print("Item not found")
# Count occurrences
count = ll.count("first item") # Number of times item appears
# Check if lists are equal
other_list = pyhold("other.xml", mode="linkedlist")
other_list.append("first item")
print(ll == other_list) # True if lists have same values
# Reverse the list
ll.reverse()
# Sort the list
ll.sort() # Ascending order
ll.sort(reverse=True) # Descending order
# Extend with another iterable
ll.extend(["item1", "item2", "item3"])
# Concatenate lists
list1 = pyhold("list1.xml", mode="linkedlist")
list2 = pyhold("list2.xml", mode="linkedlist")
combined = list1 + list2 # Creates new list
# Repeat list
repeated = ll * 3 # Creates list with ll repeated 3 times
# Clear all items
ll.clear()
# Manual save/reload
ll.save_pyhold() # Force save to XML
ll.load_pyhold() # Force reload from XML
# String representation
print(str(ll)) # Prints all values, one per line
# Open graphical interface for managing list
ll.show_gui()
from pyhold import pyhold
# Initialize list in linkedlist mode
tasks = pyhold("todo_list.xml", mode="linkedlist")
# Add tasks
tasks.append("Buy groceries")
tasks.append("Write documentation")
tasks.append("Review code")
tasks.append("Deploy application")
# Insert priority task
tasks.insert(0, "URGENT: Fix critical bug")
# Check current tasks
print(f"Total tasks: {len(tasks)}")
print(f"First task: {tasks[0]}")
print(f"Last task: {tasks[-1]}")
# Find specific task
try:
index = tasks.index("Write documentation")
print(f"Documentation task at index: {index}")
except ValueError:
print("Task not found")
# Update task
tasks[1] = "Buy groceries and milk"
# Remove completed task
tasks.remove("Review code")
# Sort tasks alphabetically
tasks.sort()
# Reverse to see most recent first
tasks.reverse()
# Open GUI to manage tasks
tasks.show_gui()
The dictionary store provides a simple key-value interface using the main pyhold class.
from pyhold import pyhold
# Initialize in keyvalue mode (default)
store = pyhold("mydata.xml", mode="keyvalue", auto_sync=True, auto_reload=True)
# Use like a dictionary
store["username"] = "anjan"
store["token"] = "abc123"
print(store["username"]) # "anjan"
# Remove items
store.pop("username")
from pyhold import pyhold
# Initialize store
app_data = pyhold("app_data.xml", mode="keyvalue")
# Store user session data
app_data["user_id"] = 12345
app_data["session_token"] = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9"
app_data["preferences"] = {
"theme": "dark",
"language": "en",
"notifications": True
}
app_data["last_login"] = "2024-01-15T10:30:00Z"
# Retrieve data
user_id = app_data.get("user_id")
session_token = app_data["session_token"]
theme = app_data["preferences"]["theme"]
# Update data
app_data["last_login"] = "2024-01-15T11:45:00Z"
# Check if key exists
if "session_token" in app_data:
print("User is logged in")
# Remove sensitive data
app_data.pop("session_token")
All classes support these initialization parameters:
filename (str): XML file path for persistence (default: "pyhold.xml")mode (str): Data structure mode - "keyvalue" or "linkedlist" (default: "keyvalue")auto_sync (bool): Automatically save changes to file (default: True)auto_reload (bool): Automatically load from file on initialization (default: True)Both key-value and linked list stores include a comprehensive GUI with:
int, str, float, bool, Nonedict, list, tupleIf you encounter issues with the GUI:
sudo apt-get install python3-tk (Ubuntu/Debian) or sudo yum install tkinter (CentOS/RHEL)brew install python-tkContributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
git clone https://github.com/AnjanB3012/pyhold.git
cd pyhold
pip install -e .
# Basic functionality test
from pyhold import pyhold
# Test key-value store
kv = pyhold("test.xml", mode="keyvalue")
kv["test"] = "value"
assert kv["test"] == "value"
# Test linked list
ll = pyhold("test_list.xml", mode="linkedlist")
ll.append("item1")
assert ll[0] == "item1"
This project is licensed under the MIT License - see the LICENSE file for details.
FAQs
A lightweight, persistent data store with dictionary, key-value, and linked list support with GUI
We found that pyhold demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Popular npm packages like eslint-config-prettier were compromised after a phishing attack stole a maintainer’s token, spreading malicious updates.
Security News
/Research
A phishing attack targeted developers using a typosquatted npm domain (npnjs.com) to steal credentials via fake login pages - watch out for similar scams.
Security News
Knip hits 500 releases with v5.62.0, refining TypeScript config detection and updating plugins as monthly npm downloads approach 12M.