kivy-network 0.1.0__tar.gz

kivy_network-0.1.0/LICENSE

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

kivy_network-0.1.0/PKG-INFO

@@ -0,0 +1,19 @@
+Metadata-Version: 2.4
+Name: kivy-network
+Version: 0.1.0
+Summary: A real-time async WebSocket networking engine for Kivy.
+Author-email: Etherum Miners <vjs.sreenivas@gmail.com>
+Project-URL: Homepage, https://github.com/GP-commits/Kivy-Python
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: websockets>=16.0
+Requires-Dist: kivy>=2.3.1
+Provides-Extra: dev
+Requires-Dist: pytest==9.0.2; extra == "dev"
+Requires-Dist: pytest-asyncio==1.3.0; extra == "dev"
+Requires-Dist: requests==2.32.5; extra == "dev"
+Dynamic: license-file
+
+# Kivy-Python
+An open-source Python library designed to simplify and accelerate mobile app development with Kivy.

kivy_network-0.1.0/README.md

@@ -0,0 +1,2 @@
+# Kivy-Python
+An open-source Python library designed to simplify and accelerate mobile app development with Kivy.

kivy_network-0.1.0/kivy_network/kivy_bridge.py

@@ -0,0 +1,27 @@
+from kivy.event import EventDispatcher
+from kivy.clock import Clock
+
+class NetworkEventDispatcher(EventDispatcher):
+    __events__ = ('on_connected', 'on_message', 'on_error')
+
+    def __init__(self, **kwargs):
+        super().__init__(**kwargs)
+        self.bind(on_message=self.on_message_handler)
+
+    def on_connected(self, *args):
+        pass
+
+    def on_message(self, message_data):
+        pass
+
+    def on_error(self, error_msg):
+        pass
+
+    def trigger_message_safely(self, data):
+        Clock.schedule_once(lambda dt: self.dispatch('on_message', data), 0)
+
+    def trigger_connected_safely(self, *args):
+        Clock.schedule_once(lambda dt: self.dispatch('on_connected', *args), 0)
+
+    def trigger_error_safely(self, error_msg):
+        Clock.schedule_once(lambda dt: self.dispatch('on_error', error_msg), 0)

kivy_network-0.1.0/kivy_network/network_client.py

@@ -0,0 +1,96 @@
+import asyncio
+import websockets
+import json
+from dataclasses import dataclass
+from typing import Optional, Dict, Any
+from kivy.event import EventDispatcher
+from kivy.clock import Clock
+
+@dataclass
+class NetworkMessage:
+    type: str               
+    room: Optional[str]     
+    content: Optional[str] 
+    sender_id: Optional[str] 
+    raw_data: Dict[str, Any] 
+
+class NetworkEventDispatcher(EventDispatcher):
+    __events__ = ('on_connected', 'on_message', 'on_error', 'on_disconnected')
+
+    def __init__(self, **kwargs):
+        super().__init__(**kwargs)
+
+    def on_connected(self, *args): pass
+    def on_message(self, message: NetworkMessage): pass 
+    def on_error(self, error_msg: str): pass
+    def on_disconnected(self, *args): pass
+
+    def trigger_message_safely(self, message_obj: NetworkMessage):
+        Clock.schedule_once(lambda dt: self.dispatch('on_message', message_obj), 0)
+
+    def trigger_connected_safely(self):
+        Clock.schedule_once(lambda dt: self.dispatch('on_connected'), 0)
+
+    def trigger_error_safely(self, error_msg: str):
+        Clock.schedule_once(lambda dt: self.dispatch('on_error', error_msg), 0)
+        
+    def trigger_disconnected_safely(self):
+        Clock.schedule_once(lambda dt: self.dispatch('on_disconnected'), 0)
+
+
+class RealTimeClient(NetworkEventDispatcher):
+    def __init__(self, uri: str = "ws://localhost:8765", **kwargs):
+        super().__init__(**kwargs)
+        self.uri = uri
+        self.websocket = None
+        self.client_id: Optional[str] = None
+        self.connected: bool = False
+        self.reconnect_delay: int = 1
+        self.max_delay: int = 15
+
+    async def run_forever(self) -> None:
+        while True:
+            try:
+                print(f"[CLIENT] Attempting to connect to {self.uri}...")
+                async with websockets.connect(self.uri) as ws:
+                    self.websocket = ws
+                    self.connected = True
+                    self.reconnect_delay = 1
+                    self.trigger_connected_safely()
+                    await self._listen()
+                    
+            except (websockets.exceptions.ConnectionClosedError, ConnectionRefusedError):
+                self.connected = False
+                self.trigger_disconnected_safely()
+                self.trigger_error_safely("Connection dropped.")
+                await asyncio.sleep(self.reconnect_delay)
+                self.reconnect_delay = min(self.reconnect_delay * 2, self.max_delay)
+            except Exception as e:
+                print(f"[CLIENT] Critical Error: {e}")
+                await asyncio.sleep(5)
+
+    async def _listen(self) -> None:
+        async for message in self.websocket:
+            data = json.loads(message)
+            
+            if data.get("type") == "welcome":
+                self.client_id = data.get("client_id")
+            else:
+                msg_obj = NetworkMessage(
+                    type=data.get("type", "unknown"),
+                    room=data.get("room"),
+                    content=data.get("content"),
+                    sender_id=data.get("sender_id"),
+                    raw_data=data
+                )
+                self.trigger_message_safely(msg_obj)
+
+    async def join_room(self, room_name: str) -> None:
+        if self.connected and self.websocket:
+            data = {"action": "join", "room": room_name}
+            await self.websocket.send(json.dumps(data))
+
+    async def send_chat(self, room_name: str, content: str) -> None:
+        if self.connected and self.websocket:
+            data = {"action": "message", "room": room_name, "content": content}
+            await self.websocket.send(json.dumps(data))

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

@@ -0,0 +1,19 @@
+Metadata-Version: 2.4
+Name: kivy-network
+Version: 0.1.0
+Summary: A real-time async WebSocket networking engine for Kivy.
+Author-email: Etherum Miners <vjs.sreenivas@gmail.com>
+Project-URL: Homepage, https://github.com/GP-commits/Kivy-Python
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: websockets>=16.0
+Requires-Dist: kivy>=2.3.1
+Provides-Extra: dev
+Requires-Dist: pytest==9.0.2; extra == "dev"
+Requires-Dist: pytest-asyncio==1.3.0; extra == "dev"
+Requires-Dist: requests==2.32.5; extra == "dev"
+Dynamic: license-file
+
+# Kivy-Python
+An open-source Python library designed to simplify and accelerate mobile app development with Kivy.

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

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+kivy_network/__init__.py
+kivy_network/kivy_bridge.py
+kivy_network/network_client.py
+kivy_network.egg-info/PKG-INFO
+kivy_network.egg-info/SOURCES.txt
+kivy_network.egg-info/dependency_links.txt
+kivy_network.egg-info/requires.txt
+kivy_network.egg-info/top_level.txt
+tests/test_client.py

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,7 @@
+websockets>=16.0
+kivy>=2.3.1
+
+[dev]
+pytest==9.0.2
+pytest-asyncio==1.3.0
+requests==2.32.5

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

@@ -0,0 +1 @@
+kivy_network

kivy_network-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "kivy-network"
+version = "0.1.0"
+authors = [
+  { name="Etherum Miners", email="vjs.sreenivas@gmail.com" },
+]
+description = "A real-time async WebSocket networking engine for Kivy."
+readme = "README.md"
+requires-python = ">=3.8"
+dependencies = [
+    "websockets>=16.0",
+    "kivy>=2.3.1"
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest==9.0.2",
+    "pytest-asyncio==1.3.0",
+    "requests==2.32.5"
+]
+
+[project.urls]
+"Homepage" = "https://github.com/GP-commits/Kivy-Python"

kivy_network-0.1.0/setup.cfg

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

kivy_network-0.1.0/tests/test_client.py

@@ -0,0 +1,47 @@
+import asyncio
+import websockets
+import json
+import pytest
+
+URI = "ws://localhost:8765"
+    
+@pytest.mark.asyncio
+async def test_room_join_and_message():
+    async with websockets.connect(URI) as ws:
+        join_cmd = {"action": "join", "room": "lobby"}
+        await ws.send(json.dumps(join_cmd))
+    
+        raw_resp = await ws.recv()
+        resp = json.loads(raw_resp)
+        assert resp["status"] == "success"
+
+        msg_cmd = {"action": "message", "room": "lobby", "content": "Hello Team!"}
+        await ws.send(json.dumps(msg_cmd))
+        
+        raw_broadcast = await ws.recv()
+        broadcast = json.loads(raw_broadcast)
+        assert broadcast["room"] == "lobby"
+        assert broadcast["content"] == "Hello Team!"
+
+@pytest.mark.asyncio
+async def test_stress_multi_room_routing():
+    """Stress test: 50 clients in different rooms should only hear their own room's noise."""
+    
+    async def fake_client_task(client_id):
+        room_name = "room_A" if client_id % 2 == 0 else "room_B"
+        
+        async with websockets.connect(URI) as ws:
+            await ws.send(json.dumps({"action": "join", "room": room_name}))
+            await ws.recv()
+            
+            test_content = f"Message from {client_id}"
+            await ws.send(json.dumps({"action": "message", "room": room_name, "content": test_content}))
+            
+            raw_data = await ws.recv()
+            data = json.loads(raw_data)
+            
+            assert data["room"] == room_name
+            assert test_content in data["content"]
+
+    tasks = [fake_client_task(i) for i in range(50)]
+    await asyncio.gather(*tasks)