nestio 0.1.0__tar.gz

nestio-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nestio
+
+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.

nestio-0.1.0/PKG-INFO

@@ -0,0 +1,20 @@
+Metadata-Version: 2.4
+Name: nestio
+Version: 0.1.0
+Summary: Async-first nested JSON/TOML storage with dot-path access and atomic writes
+Author: MrBaconHat
+License: MIT
+Project-URL: Homepage, https://github.com/MrBaconHat/nestio
+Project-URL: Repository, https://github.com/MrBaconHat/nestio
+Project-URL: Issues, https://github.com/MrBaconHat/nestio/issues
+Keywords: async,json,storage,database,nest,dotpath
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Database
+Classifier: Framework :: AsyncIO
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiofiles>=23.0.0
+Dynamic: license-file

nestio-0.1.0/nestio/__init__.py

@@ -0,0 +1 @@
+from .json import Json

nestio-0.1.0/nestio/base.py

@@ -0,0 +1,129 @@
+import aiofiles
+import tempfile
+import os
+from pathlib import Path
+
+from .lock import LockManager
+
+
+class BaseStorage:
+    def __init__(self, path: str):
+        self.path = Path(path)
+        self.path.parent.mkdir(parents=True, exist_ok=True)
+
+        self._lock_manager = LockManager()
+
+    # --- format layer ---
+    def _serialize(self, data): ...
+    def _deserialize(self, text): ...
+
+    # --- IO ---
+    async def _load(self):
+        try:
+            async with aiofiles.open(self.path, "r", encoding="utf-8") as f:
+                return self._deserialize(await f.read())
+        except FileNotFoundError:
+            return {}
+
+    async def _save(self, data):
+        content = self._serialize(data)
+
+        with tempfile.NamedTemporaryFile(
+            "w",
+            dir=self.path.parent,
+            delete=False,
+            encoding="utf-8"
+        ) as tmp:
+            tmp.write(content)
+            tmp.flush()
+            os.fsync(tmp.fileno())
+            temp_path = tmp.name
+
+        os.replace(temp_path, self.path)
+
+    # --- helpers ---
+    def _resolve_parent(self, data, path, create=False):
+        keys = path.split(".")
+        current = data
+
+        for k in keys[:-1]:
+            if k not in current:
+                if create:
+                    current[k] = {}
+                else:
+                    raise KeyError(path)
+
+            if not isinstance(current[k], dict):
+                raise TypeError(f"Invalid path: {path}")
+
+            current = current[k]
+
+        return current, keys[-1]
+    
+    def _deep_merge(self, original, new):
+        for k, v in new.items():
+            if isinstance(v, dict) and isinstance(original.get(k), dict):
+                self._deep_merge(original[k], v)
+            else:
+                original[k] = v
+    
+    # ==== Functions ====
+    async def get(self, path, default=None):
+        data = await self._load()
+
+        try:
+            parent, key = self._resolve_parent(data, path)
+            return parent.get(key, default)
+        except Exception:
+            return default
+
+    async def set(self, path, value):
+        async with await self._lock_manager.get(path):
+            data = await self._load()
+
+            parent, key = self._resolve_parent(data, path, create=True)
+            parent[key] = value
+
+            await self._save(data)
+
+    async def delete(self, path):
+        async with await self._lock_manager.get(path):
+            data = await self._load()
+
+            parent, key = self._resolve_parent(data, path)
+
+            if key in parent:
+                del parent[key]
+                await self._save(data)
+
+    async def append(self, path, value):
+        async with await self._lock_manager.get(path):
+            data = await self._load()
+
+            parent, key = self._resolve_parent(data, path, create=True)
+
+            if key not in parent:
+                parent[key] = []
+
+            if not isinstance(parent[key], list):
+                raise TypeError("Target is not a list")
+
+            parent[key].append(value)
+
+            await self._save(data)
+
+    async def update(self, path, new_data: dict):
+        async with await self._lock_manager.get(path):
+            data = await self._load()
+
+            parent, key = self._resolve_parent(data, path, create=True)
+
+            if key not in parent:
+                parent[key] = {}
+
+            if not isinstance(parent[key], dict):
+                raise TypeError("Target is not a dict")
+
+            self._deep_merge(parent[key], new_data)
+
+            await self._save(data)

nestio-0.1.0/nestio/json.py

@@ -0,0 +1,13 @@
+import json
+from .base import BaseStorage
+
+
+class Json(BaseStorage):
+    def __init__(self, path: str):
+        super().__init__(path)
+        
+    def _serialize(self, data):
+        return json.dumps(data, indent=4)
+
+    def _deserialize(self, text):
+        return json.loads(text)

nestio-0.1.0/nestio/lock.py

@@ -0,0 +1,26 @@
+import asyncio
+import time
+
+
+class LockManager:
+    def __init__(self, ttl=300):
+        self._locks = {}
+        self._last_used = {}
+        self._ttl = ttl
+        self._global = asyncio.Lock()
+
+    async def get(self, key: str) -> asyncio.Lock:
+        async with self._global:
+            now = time.monotonic()
+
+            # cleanup old locks
+            for k in list(self._locks.keys()):
+                if now - self._last_used.get(k, 0) > self._ttl:
+                    del self._locks[k]
+                    del self._last_used[k]
+
+            if key not in self._locks:
+                self._locks[key] = asyncio.Lock()
+
+            self._last_used[key] = now
+            return self._locks[key]

nestio-0.1.0/nestio.egg-info/PKG-INFO

@@ -0,0 +1,20 @@
+Metadata-Version: 2.4
+Name: nestio
+Version: 0.1.0
+Summary: Async-first nested JSON/TOML storage with dot-path access and atomic writes
+Author: MrBaconHat
+License: MIT
+Project-URL: Homepage, https://github.com/MrBaconHat/nestio
+Project-URL: Repository, https://github.com/MrBaconHat/nestio
+Project-URL: Issues, https://github.com/MrBaconHat/nestio/issues
+Keywords: async,json,storage,database,nest,dotpath
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Database
+Classifier: Framework :: AsyncIO
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiofiles>=23.0.0
+Dynamic: license-file

nestio-0.1.0/nestio.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+nestio/__init__.py
+nestio/base.py
+nestio/json.py
+nestio/lock.py
+nestio.egg-info/PKG-INFO
+nestio.egg-info/SOURCES.txt
+nestio.egg-info/dependency_links.txt
+nestio.egg-info/requires.txt
+nestio.egg-info/top_level.txt

nestio-0.1.0/nestio.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

nestio-0.1.0/nestio.egg-info/requires.txt

@@ -0,0 +1 @@
+aiofiles>=23.0.0

nestio-0.1.0/nestio.egg-info/top_level.txt

@@ -0,0 +1 @@
+nestio

nestio-0.1.0/pyproject.toml

@@ -0,0 +1,47 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+
+[project]
+name = "nestio"
+version = "0.1.0"
+description = "Async-first nested JSON/TOML storage with dot-path access and atomic writes"
+readme = "README.md"
+requires-python = ">=3.9"
+license = {text = "MIT"}
+
+authors = [
+    {name = "MrBaconHat"}
+]
+
+dependencies = [
+    "aiofiles>=23.0.0"
+]
+
+keywords = [
+    "async",
+    "json",
+    "storage",
+    "database",
+    "nest",
+    "dotpath"
+]
+
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Database",
+    "Framework :: AsyncIO"
+]
+
+
+[project.urls]
+Homepage = "https://github.com/MrBaconHat/nestio"
+Repository = "https://github.com/MrBaconHat/nestio"
+Issues = "https://github.com/MrBaconHat/nestio/issues"
+
+
+[tool.setuptools]
+packages = ["nestio"]

nestio-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+