PersistentObjects 0.1.6__tar.gz → 0.1.7__tar.gz

{persistentobjects-0.1.6 → persistentobjects-0.1.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PersistentObjects
-Version: 0.1.6
+Version: 0.1.7
 Summary: JSON-backed attribute-persistent object with namespace support
 Author: Tornado300
 License-Expression: MIT

{persistentobjects-0.1.6 → persistentobjects-0.1.7}/PersistentObjects/core.py

@@ -23,6 +23,7 @@ class _PersistentState:
         self._path = os.path.abspath(path)
         self._lock = threading.Lock()
         self._data = {}
+        self._defaults = {}
         self._load()
 
     def _load(self):
@@ -96,6 +97,7 @@ class _Namespace:
         self._initialized = True
         self._root = root
         self._key = key
+        self._defaults = {}
 
     def __getattr__(self, name):
         if name.startswith("_"):
@@ -126,10 +128,64 @@ class _Namespace:
             bucket[name] = value
             self._root._save()
 
+    def setdefault(self, name: str, value):
+        """Set a value only if the key doesn't already exist. Registers the value as the default for reset()."""
+        self._defaults[name] = value
+        with self._root._lock:
+            bucket = self._root._data.setdefault(self._key, {})
+            if name not in bucket:
+                bucket[name] = value
+                self._root._save()
+        return self._root._data[self._key][name]
+
+    def reset(self, name: str | None = None):
+        """Reset a key to its default value, or all keys if no name is given.
+
+        Raises KeyError if the key has no registered default.
+        """
+        with self._root._lock:
+            bucket = self._root._data.setdefault(self._key, {})
+            if name is not None:
+                if name not in self._defaults:
+                    raise KeyError(
+                        f"No default registered for '{name}'. Use setdefault() first."
+                    )
+                bucket[name] = self._defaults[name]
+            else:
+                for key, value in self._defaults.items():
+                    bucket[key] = value
+            self._root._save()
+
 
 class PersistentObject(_PersistentState):
     def namespace(self, name) -> _Namespace:
         return _Namespace(self, name)
 
+    def setdefault(self, name: str, value):
+        """Set a value only if the key doesn't already exist. Registers the value as the default for reset()."""
+        self._defaults[name] = value
+        with self._lock:
+            if name not in self._data:
+                self._data[name] = value
+                self._save()
+        return self._data[name]
+
+    def reset(self, name: str | None = None):
+        """Reset a key to its default value, or all keys if no name is given.
+
+        Raises KeyError if the key has no registered default.
+        """
+        with self._lock:
+            if name is not None:
+                if name not in self._defaults:
+                    raise KeyError(
+                        f"No default registered for '{name}'. Use setdefault() first."
+                    )
+                self._data[name] = self._defaults[name]
+            else:
+                for key, value in self._defaults.items():
+                    self._data[key] = value
+            self._save()
+
 
 __all__ = ["PersistentObject"]

{persistentobjects-0.1.6 → persistentobjects-0.1.7}/PersistentObjects.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PersistentObjects
-Version: 0.1.6
+Version: 0.1.7
 Summary: JSON-backed attribute-persistent object with namespace support
 Author: Tornado300
 License-Expression: MIT

{persistentobjects-0.1.6 → persistentobjects-0.1.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "PersistentObjects"
-version = "0.1.6"
+version = "0.1.7"
 description = "JSON-backed attribute-persistent object with namespace support"
 authors = [
     { name="Tornado300" }