A tiny dictionary-like file storage system.
Project description
peridata
peridata is a simple, tiny (<4KB!) data storage system using JSON and files, meant to be easy to use, strict on typing, and to allow easy migrations via changing properties.
usage
Create a property dictionary:
from peridata import Property, PersistentStorage
epic_property_dict = {"nuclear_bombs": Property[int](default=1)}
Then, create a PersistentStorage instance:
ps = PersistentStorage(epic_property_dict, Path(".") / "data" / "makesurethisisafileloc.json")
You can then use it like a dictionary; however, adding new keys will error, and typing is checked:
print(ps["nuclear_bombs"]) # Output: 1 (since it's the default set earlier)
# Wait, we're British. That's it, we're invading France.
ps["nuclear_bombs"] -= 1
print(ps["nuclear_bombs"]) # Output: 0
# I'm gonna make a complex amount of nuclear bombs.
ps["nuclear_bombs"] = 2+1j # TypeError: Invalid type for property 'nuclear_bombs'. Expected int, got complex
# Fine, I'll try to store my tea in here, then.
ps["tea"] = Tea(Tea.Brand.YORKSHIRE, quantity=10000).serialize() # KeyError: 'Invalid property: tea'
The data is automatically saved to the file location:
// in data/makesurethisisafileloc.json
{
"nuclear_bombs": 0
}
And, loading the PersistentStorage again will take that instead of the default:
epic_property_dict = {"nuclear_bombs": Property[int](default=1)} # The properties stay the same.
ps = PersistentStorage(epic_property_dict, Path(".") / "data" / "makesurethisisafileloc.json") # The file location is also the same.
print(ps["nuclear_bombs"]) # Output: 0
You can also protect data; then, if you use write_unprivileged, you will get an error on writing:
epic_property_dict = {"nuclear_bombs": Property[int](default=1),
"tea": Property[str](default=Tea(Tea.Brand.YORKSHIRE, quantity=1).serialize(), protected=True)} # The library will manage setting new dictionary values, if you add them.
ps = PersistentStorage(epic_property_dict, Path(".") / "data" / "makesurethisisafileloc.json") # The file location still the same.
ps.write_unprivileged("nuclear_bombs", 100) # This works, since by default protected=False.
# I'm gonna annoy this brit so hard.
ps.write_unprivileged("tea", Coffee().serialize()) # PermissionError: The property 'tea' is protected and cannot be modified from write_unprivileged().
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
peridata-1.0.0.post1.tar.gz
(4.1 kB
view hashes)
Built Distribution
Close
Hashes for peridata-1.0.0.post1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5b75579cdbddaf12ef2dd3503153b54252511aa7dbced3de426cfa2736e9003d |
|
MD5 | fc399cf0f3de5d2e434f34f58f0dec71 |
|
BLAKE2b-256 | ca1793044e58d267d45434e0ee4eb3cfa0108237dc4c19f66a18b82272cc0b9b |