httpstate 0.0.14__tar.gz → 0.0.15__tar.gz

httpstate-0.0.14/README.md → httpstate-0.0.15/PKG-INFO

@@ -1,3 +1,17 @@
+Metadata-Version: 2.4
+Name: httpstate
+Version: 0.0.15
+Summary: HTTPState, httpstate.com
+Author-email: "Alex Morales, HTTPState" <alex@httpstate.com>
+License-Expression: AGPL-3.0
+License-File: LICENSE
+Keywords: httpstate
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Requires-Dist: websockets>=16.0
+Description-Content-Type: text/markdown
+
 # httpstate (python)
 
 ## Quick Start
@@ -45,18 +59,24 @@ That's it! 🐙
 ### Functions
 
 - `get(uuid)`
-  Get state of UUIDv4.
+  Get state of UUIDv4. Returns `None|str`.
 
-- `post(uuid, data)`
-  Alias for `set`.
+- `message.unpack(bytes)`
+  Unpack binary WebSocket message into `MessageType(uuid, timestamp, type, value)`.
+
+- `post(uuid, data=None)`
+  Alias for `set`. Returns `None|int`.
+
+- `put(uuid, data=None)`
+  Alias for `set`. Returns `None|int`.
 
 - `read(uuid)`
   Alias for `get`.
 
-- `set(uuid, data)`
-  Set state of UUIDv4.
+- `set(uuid, data=None)`
+  Set state of UUIDv4. Returns `None|int`. If `data` is `None`, defaults to `''`.
 
-- `write(uuid, data)`
+- `write(uuid, data=None)`
   Alias for `set`.
 
 ### HttpState Class
@@ -69,14 +89,16 @@ That's it! 🐙
 <br>
 
 - `<HttpState>.get()`
-  Get state.
-- `<HttpState>.post(data)`
+  Get state. Returns `None|str`.
+- `<HttpState>.post(data=None)`
+  Alias for `set`.
+- `<HttpState>.put(data=None)`
   Alias for `set`.
 - `<HttpState>.read()`
   Alias for `get`.
-- `<HttpState>.set(data)`
-  Set state.
-- `<HttpState>.write(data)`
+- `<HttpState>.set(data=None)`
+  Set state. Returns `None|int`. If `data` is `None`, defaults to `''`.
+- `<HttpState>.write(data=None)`
   Alias for `set`.
 
 <br>

httpstate-0.0.14/PKG-INFO → httpstate-0.0.15/README.md

@@ -1,17 +1,3 @@
-Metadata-Version: 2.4
-Name: httpstate
-Version: 0.0.14
-Summary: HTTP State, httpstate.com
-Author-email: "Alex Morales, HTTP State" <alex@httpstate.com>
-License-Expression: AGPL-3.0
-License-File: LICENSE
-Keywords: httpstate
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Requires-Python: >=3.10
-Requires-Dist: websockets>=16.0
-Description-Content-Type: text/markdown
-
 # httpstate (python)
 
 ## Quick Start
@@ -59,18 +45,24 @@ That's it! 🐙
 ### Functions
 
 - `get(uuid)`
-  Get state of UUIDv4.
+  Get state of UUIDv4. Returns `None|str`.
 
-- `post(uuid, data)`
-  Alias for `set`.
+- `message.unpack(bytes)`
+  Unpack binary WebSocket message into `MessageType(uuid, timestamp, type, value)`.
+
+- `post(uuid, data=None)`
+  Alias for `set`. Returns `None|int`.
+
+- `put(uuid, data=None)`
+  Alias for `set`. Returns `None|int`.
 
 - `read(uuid)`
   Alias for `get`.
 
-- `set(uuid, data)`
-  Set state of UUIDv4.
+- `set(uuid, data=None)`
+  Set state of UUIDv4. Returns `None|int`. If `data` is `None`, defaults to `''`.
 
-- `write(uuid, data)`
+- `write(uuid, data=None)`
   Alias for `set`.
 
 ### HttpState Class
@@ -83,14 +75,16 @@ That's it! 🐙
 <br>
 
 - `<HttpState>.get()`
-  Get state.
-- `<HttpState>.post(data)`
+  Get state. Returns `None|str`.
+- `<HttpState>.post(data=None)`
+  Alias for `set`.
+- `<HttpState>.put(data=None)`
   Alias for `set`.
 - `<HttpState>.read()`
   Alias for `get`.
-- `<HttpState>.set(data)`
-  Set state.
-- `<HttpState>.write(data)`
+- `<HttpState>.set(data=None)`
+  Set state. Returns `None|int`. If `data` is `None`, defaults to `''`.
+- `<HttpState>.write(data=None)`
   Alias for `set`.
 
 <br>

{httpstate-0.0.14 → httpstate-0.0.15}/pyproject.toml

@@ -3,20 +3,20 @@ build-backend = "hatchling.build"
 requires = ["hatchling >= 1.26"]
 
 [project]
-authors = [{ email="alex@httpstate.com", name="Alex Morales, HTTP State" }]
+authors = [{ email="alex@httpstate.com", name="Alex Morales, HTTPState" }]
 classifiers = [
   "Operating System :: OS Independent",
   "Programming Language :: Python :: 3"
 ]
 dependencies = ["websockets>=16.0"]
-description = "HTTP State, httpstate.com"
+description = "HTTPState, httpstate.com"
 keywords = ["httpstate"]
 license = "AGPL-3.0"
 license-files = ["LICEN[CS]E*"]
 name = "httpstate"
 readme = "README.md"
 requires-python = ">=3.10"
-version = "0.0.14"
+version = "0.0.15"
 
 [project.url]
 Homepage = "https://httpstate.com"

{httpstate-0.0.14 → httpstate-0.0.15}/src/httpstate/__init__.py

@@ -1,4 +1,4 @@
-# HTTP State, https://httpstate.com/
+# HTTPState, https://httpstate.com/
 # Copyright (C) Alex Morales, 2026
 
 # Unless otherwise stated in particular files or directories, this software is free software.

{httpstate-0.0.14 → httpstate-0.0.15}/src/httpstate/httpstate.py

@@ -1,4 +1,4 @@
-# HTTP State, https://httpstate.com/
+# HTTPState, https://httpstate.com/
 # Copyright (C) Alex Morales, 2026
 
 # Unless otherwise stated in particular files or directories, this software is free software.
@@ -9,7 +9,6 @@
 import asyncio
 import struct
 import threading
-import types
 import urllib.error
 import urllib.request
 import websockets
@@ -49,16 +48,19 @@ class Message:
 
 message:type = Message
 
-def post(uuid:str, data:str) -> None|int:
+def post(uuid:str, data:None|str = None) -> None|int:
   return set(uuid, data)
 
-def put(uuid:str, data:str) -> None|int:
+def put(uuid:str, data:None|str = None) -> None|int:
   return set(uuid, data)
 
 def read(uuid:str) -> None|str:
   return get(uuid)
 
-def set(uuid:str, data:str) -> None|int:
+def set(uuid:str, data:None|str = None) -> None|int:
+  if(data is None):
+    data = ''
+
   req:urllib.request.Request = urllib.request.Request(
     f'https://httpstate.com/{uuid}',
     data=data.encode('utf-8'),
@@ -74,15 +76,16 @@ def set(uuid:str, data:str) -> None|int:
   except Exception:
     return None
 
-def write(uuid:str, data:str) -> None|int:
+def write(uuid:str, data:None|str = None) -> None|int:
   return set(uuid, data)
 
-# HTTP State
+# HTTPState
 class HttpState:
   def __init__(self, uuid:str) -> None:
     self.data:None|str = None
     self.el:None|asyncio.AbstractEventLoop = None
     self.et:Dict[str, List[Callable[[None|str], None]]] = {}
+    self.lock:threading.Lock = threading.Lock()
     self.uuid:str = uuid
     self.ws:None|websockets.WebSocketClientProtocol = None
 
@@ -120,7 +123,8 @@ class HttpState:
           and data.uuid == self.uuid
           and data.type == 1
         ):
-          self.data:None|str = data.value.decode()
+          with self.lock:
+            self.data:None|str = data.value.decode()
 
           self.emit('change', self.data)
     
@@ -154,10 +158,12 @@ class HttpState:
   def get(self) -> None|str:
     data:None|str = get(self.uuid)
 
-    if(data != self.data):
-      self.el.call_soon_threadsafe(lambda : self.emit('change', self.data))
+    with self.lock:
+      if(data != self.data):
+        if self.el is not None:
+          self.el.call_soon_threadsafe(lambda : self.emit('change', self.data))
 
-    self.data = data
+      self.data = data
 
     return self.data
 
@@ -181,17 +187,17 @@ class HttpState:
 
     return self
   
-  def post(self, data:str) -> None|int:
+  def post(self, data:None|str = None) -> None|int:
     return self.set(data)
   
-  def put(self, data:str) -> None|int:
+  def put(self, data:None|str = None) -> None|int:
     return self.set(data)
 
   def read(self) -> None|str:
     return self.get()
 
-  def set(self, data:str) -> None|int:
+  def set(self, data:None|str = None) -> None|int:
     return set(self.uuid, data)
 
-  def write(self, data:str) -> None|int:
+  def write(self, data:None|str = None) -> None|int:
     return self.set(data)