PersistentObjects 0.1.5__tar.gz → 0.1.7__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PersistentObjects
-Version: 0.1.5
+Version: 0.1.7
 Summary: JSON-backed attribute-persistent object with namespace support
 Author: Tornado300
 License-Expression: MIT
@@ -34,5 +34,8 @@ pobject.second_value = "foo"
 namespace = pobject.namespace("test_namespace") # creates a new namespace (new subdict in json)
 namespace.third_value = [10, 5]
 
+
+print(pobject.test_namespace.third_value) # alternate way to access namespaces
+
 pobject.temp_ = True # suffixed with '_' so it will not be saved and behaves like a normal attribute.
 ```

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

@@ -1,5 +1,6 @@
 import json, os, threading
 
+
 class _PersistentState:
     _instances = {}
 
@@ -22,6 +23,7 @@ class _PersistentState:
         self._path = os.path.abspath(path)
         self._lock = threading.Lock()
         self._data = {}
+        self._defaults = {}
         self._load()
 
     def _load(self):
@@ -40,16 +42,24 @@ class _PersistentState:
 
     def __getattr__(self, name):
         if name.startswith("_"):
-            raise AttributeError(name)
+            raise AttributeError(f"Cannot access private attribute '{name}'")
         if name.endswith("_"):
-            try: 
+            try:
                 return super().__getattribute__(name[:-1])
             except AttributeError:
-                raise AttributeError(f"'{self.__class__.__name__}' object has no attribute '{name}'.\n Notice: Attribute '{name}' is not persistent!")
+                raise AttributeError(
+                    f"'{self.__class__.__name__}' object has no attribute '{name}'.\n Notice: Attribute '{name}' is not persistent!"
+                )
         try:
-            return self._data[name]
+            value = self._data[name]
+            # If it's a dict, return it as a namespace
+            if isinstance(value, dict):
+                return _Namespace(self, name)
+            return value
         except KeyError:
-            raise AttributeError(name)
+            raise AttributeError(
+                f"'{type(self).__name__}' object has no attribute '{name}'"
+            )
 
     def __setattr__(self, name, value):
         if name.startswith("_"):
@@ -87,15 +97,18 @@ class _Namespace:
         self._initialized = True
         self._root = root
         self._key = key
+        self._defaults = {}
 
     def __getattr__(self, name):
         if name.startswith("_"):
             raise AttributeError(name)
         if name.endswith("_"):
-            try: 
+            try:
                 return super().__getattribute__(name[:-1])
             except AttributeError:
-                raise AttributeError(f"'{self.__class__.__name__}' object has no attribute '{name}'.\n Notice: Attribute '{name}' is not persistent!")
+                raise AttributeError(
+                    f"'{self.__class__.__name__}' object has no attribute '{name}'.\n Notice: Attribute '{name}' is not persistent!"
+                )
         try:
             return self._root._data[self._key][name]
         except KeyError:
@@ -115,12 +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.5 → persistentobjects-0.1.7}/PersistentObjects.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PersistentObjects
-Version: 0.1.5
+Version: 0.1.7
 Summary: JSON-backed attribute-persistent object with namespace support
 Author: Tornado300
 License-Expression: MIT
@@ -34,5 +34,8 @@ pobject.second_value = "foo"
 namespace = pobject.namespace("test_namespace") # creates a new namespace (new subdict in json)
 namespace.third_value = [10, 5]
 
+
+print(pobject.test_namespace.third_value) # alternate way to access namespaces
+
 pobject.temp_ = True # suffixed with '_' so it will not be saved and behaves like a normal attribute.
 ```

{persistentobjects-0.1.5 → persistentobjects-0.1.7}/README.md

@@ -21,5 +21,8 @@ pobject.second_value = "foo"
 namespace = pobject.namespace("test_namespace") # creates a new namespace (new subdict in json)
 namespace.third_value = [10, 5]
 
+
+print(pobject.test_namespace.third_value) # alternate way to access namespaces
+
 pobject.temp_ = True # suffixed with '_' so it will not be saved and behaves like a normal attribute.
 ```

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

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