state-handler 0.1.0__py3-none-any.whl

state_handler/State_handler.py

@@ -0,0 +1,43 @@
+# state.py
+
+import json
+from pathlib import Path
+
+class State:
+    def __init__(self):
+        self._data = {}
+        self._callbacks = []
+
+    def get(self, key, default=None):
+        return self._data.get(key, default)
+
+    def set(self, key, value):
+        old_value = self._data.get(key)
+        self._data[key] = value
+
+        for callback in self._callbacks:
+            callback(key, old_value, value)
+
+    def delete(self, key):
+        self._data.pop(key, None)
+
+    def exists(self, key):
+        return key in self._data
+
+    def register_callback(self, callback):
+        self._callbacks.append(callback)
+
+    def save(self, filename="state.json"):
+        with open(filename, "w") as f:
+            json.dump(self._data, f, indent=4)
+
+    def load(self, filename="state.json"):
+        if Path(filename).exists():
+            with open(filename, "r") as f:
+                self._data = json.load(f)
+
+    def all(self):
+        return self._data.copy()
+
+
+state = State()

state_handler/__init__.py

@@ -0,0 +1 @@
+from .State_handler import State

state_handler-0.1.0.dist-info/METADATA

@@ -0,0 +1,130 @@
+Metadata-Version: 2.4
+Name: state-handler
+Version: 0.1.0
+Summary: A simple global state manager to help pass values through mautiple py files
+Author: OneNorth Technologies
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENCE
+Dynamic: license-file
+
+# State Handler
+
+A lightweight global state manager for Python.
+
+---
+
+## Features
+
+* Simple global key-value storage
+* Accessible across your entire Python project
+* Lightweight and dependency-free
+* Event callbacks on state changes
+* Optional persistence support
+
+---
+
+## Installation
+
+```bash
+pip install state-handler
+```
+
+---
+
+## Quick Start
+
+```python
+from state_handler import state
+
+# Set a value
+state.set("username", "bob")
+
+# Get a value
+print(state.get("username"))
+```
+
+---
+
+## API Reference
+
+### set(key, value)
+
+Store a value in global state.
+
+### get(key, default=None)
+
+Retrieve a value.
+
+### delete(key)
+
+Remove a value.
+
+### exists(key)
+
+Returns `True` if key exists.
+
+### all()
+
+Returns a copy of all current state values.
+
+---
+
+## Persistence
+
+```python
+state.save("state.json")
+state.load("state.json")
+```
+
+Saves and loads state from a file.
+
+---
+
+## Callbacks (Events)
+
+Run code whenever state changes:
+
+```python
+def on_change(key, old, new):
+    print(f"{key} changed from {old} to {new}")
+
+state.register_callback(on_change)
+
+state.set("mode", "debug")
+state.set("mode", "release")
+```
+
+---
+
+## Example
+
+```python
+import state_handler as sh
+
+sh.state.set("mode", "debug")
+
+if sh.state.get("mode") == "debug":
+    print("Debug mode is ON")
+```
+
+---
+
+## Why use this?
+
+Sometimes you need shared state across multiple files without passing variables around. This package provides a simple global state system for Python projects.
+
+---
+
+## Roadmap
+
+* Nested state support
+* Async event listeners
+* Thread-safe mode
+* State syncing between processes
+
+---
+
+## License
+
+MIT License

state_handler-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+state_handler/State_handler.py,sha256=__eW-ddFXA-Y_xMHwDlcg_sOCNzRQMJ8YnKvJZRItdQ,1028
+state_handler/__init__.py,sha256=G3P4krZfgRyNQiiLjD_ndLPxErXqKlz1ooD7C0Go2Sg,32
+state_handler-0.1.0.dist-info/licenses/LICENCE,sha256=QYwKdHu4iYcJAq88Q8-ii4FpMbtaSlUnyB6EpCCCung,1097
+state_handler-0.1.0.dist-info/METADATA,sha256=T1Y5RbJ9YYcZdTHA7nZByvgmOZn-dG_HGQ2ZuPzZzL8,2011
+state_handler-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+state_handler-0.1.0.dist-info/top_level.txt,sha256=ptHBnejqngfE0vp_A49hLUXVOOAzA6izw47J4jp3i-k,14
+state_handler-0.1.0.dist-info/RECORD,,

state_handler-0.1.0.dist-info/WHEEL

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

state_handler-0.1.0.dist-info/licenses/LICENCE

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

state_handler-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+state_handler