PersistentObjects 0.1.2__py3-none-any.whl

PersistentObjects/__init__.py

@@ -0,0 +1,3 @@
+from .core import PersistentObject
+
+__all__ = ["PersistentObject"]

PersistentObjects/__main__.py

@@ -0,0 +1,88 @@
+import json, os, threading
+
+class _PersistentState:
+    _instances = {}
+
+    def __new__(cls, path):
+        path = os.path.abspath(path)
+
+        if path in cls._instances:
+            return cls._instances[path]
+
+        instance = super().__new__(cls)
+        cls._instances[path] = instance
+        return instance
+
+    def __init__(self, path):
+        # Prevent re-initialization when __new__ returns an existing instance
+        if hasattr(self, "_initialized"):
+            return
+
+        self._initialized = True
+        self._path = os.path.abspath(path)
+        self._lock = threading.Lock()
+        self._data = {}
+        self._load()
+
+    def _load(self):
+        if os.path.exists(self._path):
+            try:
+                with open(self._path, "r", encoding="utf-8") as f:
+                    self._data = json.load(f)
+            except Exception:
+                self._data = {}
+
+    def _save(self):
+        tmp = self._path + ".tmp"
+        with open(tmp, "w", encoding="utf-8") as f:
+            json.dump(self._data, f, indent=2)
+        os.replace(tmp, self._path)
+
+    def __getattr__(self, name):
+        if name.startswith("_"):
+            raise AttributeError(name)
+        try:
+            return self._data[name]
+        except KeyError:
+            raise AttributeError(name)
+
+    def __setattr__(self, name, value):
+        if name.startswith("_"):
+            super().__setattr__(name, value)
+            return
+
+        with self._lock:
+            self._data[name] = value
+            self._save()
+
+
+class _Namespace:
+    def __init__(self, root, key):
+        self._root = root
+        self._key = key
+
+    def __getattr__(self, name):
+        try:
+            return self._root._data[self._key][name]
+        except KeyError:
+            raise AttributeError(name)
+
+    def __setattr__(self, name, value):
+        if name.startswith("_"):
+            super().__setattr__(name, value)
+            return
+
+        with self._root._lock:
+            bucket = self._root._data.setdefault(self._key, {})
+            bucket[name] = value
+            self._root._save()
+
+
+class PersistentObject(_PersistentState):
+    def namespace(self, name) -> _Namespace:
+        return _Namespace(self, name)
+
+
+
+
+__all__ = ["PersistentObject"]

persistentobjects-0.1.2.dist-info/METADATA

@@ -0,0 +1,36 @@
+Metadata-Version: 2.4
+Name: PersistentObjects
+Version: 0.1.2
+Summary: JSON-backed attribute-persistent object with namespace support
+Author: Tornado300
+License-Expression: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+This is a very simple lib that provides the PersistantObject class, which saves all its attributes to the given json file.
+Attributes are saved as soon as they are set.
+
+[!IMPORTANT]
+> morphing actions like appending, inserting, extending, etc. will not automaticly save!
+> so its recomended to create a temp var, then append to it and at the end set the PersistantObject attr to the temp var.
+
+with namespace(NAME) seperate sub namespaces can be created inside the object. 
+
+
+## Usage example:
+```python
+
+from PersistantObject import PersistantObject
+
+pobject = PersistantObject("save.json")
+
+pobject.first_value = 10
+pobject.second_value = "foo"
+
+namespace = pobject.namespace("test_namespace")
+namespace.third_value = [10, 5]
+```

persistentobjects-0.1.2.dist-info/RECORD

@@ -0,0 +1,7 @@
+PersistentObjects/__init__.py,sha256=sEfMxXx8Nlt-a0Hf31vMLiijXHJKo8JHMd_Y940GW1c,67
+PersistentObjects/__main__.py,sha256=xVf9ZsWxFMurLiP6SGgu6HvOcIit_qEq9UybEb22kF0,2267
+persistentobjects-0.1.2.dist-info/licenses/LICENSE,sha256=7EI8xVBu6h_7_JlVw-yPhhOZlpY9hP8wal7kHtqKT_E,1074
+persistentobjects-0.1.2.dist-info/METADATA,sha256=Ud_t9p6hoy5yvVbU__-Vi2KjOPqeSPK3yTV0TIbnVtQ,1113
+persistentobjects-0.1.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+persistentobjects-0.1.2.dist-info/top_level.txt,sha256=m_IeuK6UA0oDyLLbqyJqZdYfQc2ZTcb4IP9BlUaVymI,18
+persistentobjects-0.1.2.dist-info/RECORD,,

persistentobjects-0.1.2.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

persistentobjects-0.1.2.dist-info/licenses/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2018 The Python Packaging Authority
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

persistentobjects-0.1.2.dist-info/top_level.txt

@@ -0,0 +1 @@
+PersistentObjects