easyhttp-python 0.3.2__tar.gz → 0.4.0a6__tar.gz

{easyhttp_python-0.3.2/easyhttp_python.egg-info → easyhttp_python-0.4.0a6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: easyhttp-python
-Version: 0.3.2
+Version: 0.4.0a6
 Summary: Simple HTTP-based P2P framework for IoT
 Author-email: slpuk <yarik6052@gmail.com>
 License: MIT
@@ -9,7 +9,7 @@ Project-URL: Documentation, https://github.com/slpuk/easyhttp-python#readme
 Project-URL: Repository, https://github.com/slpuk/easyhttp-python
 Project-URL: Issue Tracker, https://github.com/slpuk/easyhttp-python/issues
 Keywords: iot,p2p,http,framework
-Classifier: Development Status :: 4 - Beta
+Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Communications
@@ -27,6 +27,7 @@ License-File: LICENSE
 Requires-Dist: fastapi>=0.103.2
 Requires-Dist: uvicorn[standard]>=0.22.0
 Requires-Dist: aiohttp>=3.7.0
+Requires-Dist: loggity>=0.5.0a6
 Provides-Extra: dev
 Requires-Dist: pytest>=6.0; extra == "dev"
 Requires-Dist: black; extra == "dev"
@@ -36,15 +37,15 @@ Dynamic: license-file
 # EasyHTTP
 
 [![GitHub](https://img.shields.io/badge/github-%23121011.svg?style=for-the-badge&logo=github&logoColor=white)](https://github.com/slpuk/easyhttp-python)
-![Protocol Version](https://img.shields.io/badge/version-0.3.2-blue?style=for-the-badge)
-![Development Status](https://img.shields.io/badge/status-beta-orange?style=for-the-badge)
+![Protocol Version](https://img.shields.io/badge/version-0.4.0-blue?style=for-the-badge)
+![Development Status](https://img.shields.io/badge/status-alpha-red?style=for-the-badge)
 ![License](https://img.shields.io/badge/license-MIT-green?style=for-the-badge)
 ![Python](https://img.shields.io/badge/python-3.7+-blue?style=for-the-badge&logo=python&logoColor=white)
 
 > **A lightweight HTTP-based P2P framework for IoT and device-to-device communication**
 
 ## 🛠️ Changelog
-- Added context managers support
+- Added UDP multicast discovery
 - Fixed some bugs
 
 ## 📖 About
@@ -58,7 +59,7 @@ Dynamic: license-file
 - **🆔 Human-Readable Device IDs** - Base32 identifiers instead of IP addresses
 - **✅ Easy to Use** - Simple API with minimal setup
 - **🚀 Performance** - Asynchronous code and lightweight libraries(FastAPI/aiohttp)
-
+- **⚙️ Auto-detect** - Devices automatically find each other
 
 ## 🏗️ Architecture
 
@@ -86,7 +87,7 @@ EasyHTTP uses a simple JSON-based command system:
 ### Basic Example with Callbacks (synchronous)
 ```python
 import time
-from easyhttp import EasyHTTP
+from easyhttp_python import EasyHTTP
 
 # Callback function
 def handle_data(sender_id, data, timestamp):
@@ -127,10 +128,6 @@ def main():
     easy.start()  # Starting server
     print(f"Device {easy.id} is running on port 5000!")
     
-    # Adding device
-    easy.add("ABC123", "192.168.1.100", 5000)
-    print("Added device ABC123")
-    
     # Monitoring device's status
     try:
         while True:
@@ -149,4 +146,12 @@ def main():
 if __name__ == "__main__":
     main()
 ```
+## 📦 Version History
+
+| Version | Date | Changes |
+|---------|------|---------|
+| 0.4.0 | 2026-11-03 | UDP Discovery, auto-detect |
+| 0.3.3 | 2026-03-01 | Fixed imports, renamed to easyhttp_python |
+| 0.3.2 | 2026-02-14 | Context managers |
+
 **More examples available on [GitHub](https://github.com/slpuk/easyhttp-python)**

{easyhttp_python-0.3.2 → easyhttp_python-0.4.0a6}/README.md

@@ -2,57 +2,32 @@
 [EN README](README.md) | [RU README](README_RU.md)
 > **A lightweight HTTP-based P2P framework for IoT and device-to-device communication**
 
-![Protocol Version](https://img.shields.io/badge/version-0.3.2-blue?style=for-the-badge)
-![Development Status](https://img.shields.io/badge/status-beta-orange?style=for-the-badge)
+![Protocol Version](https://img.shields.io/badge/version-0.4.0-blue?style=for-the-badge)
+![Development Status](https://img.shields.io/badge/status-alpha-red?style=for-the-badge)
 ![License](https://img.shields.io/badge/license-MIT-green?style=for-the-badge)
 ![Python](https://img.shields.io/badge/python-3.7+-blue?style=for-the-badge&logo=python&logoColor=white)
 
 > [!WARNING]
-> **Breaking Changes from 0.2.0**
+> **Breaking Changes from 0.3.2**
 > 
 > ### API Changes
-> | 0.2.0 | 0.3.2 | Notes |
-> |--------|--------|-------|
-> | `get()` | `fetch()` | Same functionality |
-> | `pull()` | `push()` | Same functionality |
-> | `'on_get'` | `'on_fetch'` | Callback name |
-> | `'on_data_response'` | `'on_data'` | Callback name |
-> | `'on_pull'` | `'on_push'` | Callback name |
-> 
-> ### Migration Example
 > ```python
-> # 0.2.0 (OLD):
-> easy = EasyHTTP()
-> easy.get("ABC123")
-> easy.pull("ABC123", data)
-> 
-> # 0.3.2 (NEW):
-> # Sync
-> easy = EasyHTTP()
-> easy.fetch("ABC123")
-> easy.push("ABC123", data)
+> # 0.3.2 (OLD)
+> from easyhttp import ...
 >
-> # Async
-> easy = EasyHTTPAsync()  # Async!
-> await easy.fetch("ABC123")  # Await!
-> await easy.push("ABC123", data)
-> ```
-
+> # 0.3.3 - newer (NEW)
+> from easyhttp_python import ...
+>```
 
 ## 🚀 Quick Start
 
 ### Installation
-> [!NOTE]
-> Both methods require **Git** to be installed.<br>
-> PyPI upload is **preparing**
 
 ```bash
-# Clone and install
-git clone https://github.com/slpuk/easyhttp-python.git
-cd easyhttp-python
-pip install -e .
+# Install by PyPI
+pip install easyhttp-python
 
-# Or directly from GitHub
+# Or from GitHub
 pip install git+https://github.com/slpuk/easyhttp-python.git
 ```
 
@@ -60,16 +35,13 @@ pip install git+https://github.com/slpuk/easyhttp-python.git
 Syntax with context managers and full code is supported
 
 ```python
-from easyhttp import EasyHTTP
+from easyhttp_python import EasyHTTP
 
 def main():
     # Initialize a device with context manager
     with EasyHTTP(debug=True, port=5000) as easy:
         print(f"Device ID: {easy.id}")
     
-        # Manually add another device
-        easy.add("ABC123", "192.168.1.100", 5000)
-    
         # Ping to check if device is online
         if easy.ping("ABC123"):
             print("Device is online!")
@@ -93,7 +65,7 @@ if __name__ == "__main__":
 
 ```python
 import asyncio
-from easyhttp import EasyHTTPAsync
+from easyhttp_python import EasyHTTPAsync
 
 async def main():
     # Initialize a device
@@ -102,9 +74,6 @@ async def main():
     
     print(f"Device ID: {easy.id}")
     
-    # Manually add another device
-    easy.add("ABC123", "192.168.1.100", 5000)
-    
     # Ping to check if device is online
     if await easy.ping("ABC123"):
         print("Device is online!")
@@ -136,6 +105,7 @@ if __name__ == "__main__":
 - **🆔 Human-Readable Device IDs** - Base32 identifiers instead of IP addresses
 - **✅ Easy to Use** - Simple API with minimal setup
 - **🚀 Performance** - Asynchronous code and lightweight libraries(FastAPI/aiohttp)
+- **⚙️ Auto-detect** - Devices automatically find each other
 
 ## Project Structure
 ```
@@ -143,10 +113,11 @@ easyhttp-python/
 ├── docs/
 │   ├── EasyHTTP.md      # Sync API reference
 │   └── EasyHTTPAsync.md # Async API reference
-├── easyhttp/
+├── easyhttp_python/
 │   ├── __init__.py
-│   ├── core.py     # Main framework file/core
-│   └── wrapper.py  # Synchronous wrapper
+│   ├── core.py         # Main framework file/core
+│   ├── discovery.py    # Discovery module
+│   └── wrapper.py      # Synchronous wrapper
 ├── examples/
 │   ├── async/       # Asynchronous examples
 │   │   ├── basic_ping.py
@@ -163,6 +134,7 @@ easyhttp-python/
 ├── .gitignore
 ├── LICENSE             # MIT license
 ├── pyproject.toml      # Project config
+├── README_PY.md        # Documentation for PyPI
 ├── README_RU.md        # Russian documentation
 ├── README.md           # This file
 └── requirements.txt    # Project dependencies
@@ -209,25 +181,20 @@ sequenceDiagram
 
 ## 📦 Installation & Setup
 
-### Python Installation
-> [!NOTE]
-> Both methods require **Git** to be installed.<br>
-> PyPI upload is **preparing**
+### Installation
 
 ```bash
-# Install directly from GitHub
-pip install git+https://github.com/slpuk/easyhttp-python.git
+# Install from PyPI
+pip install easyhttp-python
 
-# Or install from source
-git clone https://github.com/slpuk/easyhttp-python
-cd easyhttp-python
-pip install -e .
+# Or from GitHub
+pip install git+https://github.com/slpuk/easyhttp-python.git
 ```
 
 ### Basic Example with Callbacks(Synchronous)
 ```python
 import time
-from easyhttp import EasyHTTP
+from easyhttp_python import EasyHTTP
 
 # Callback function
 def handle_data(sender_id, data, timestamp):

{easyhttp_python-0.3.2 → easyhttp_python-0.4.0a6}/README_PY.md

@@ -1,15 +1,15 @@
 # EasyHTTP
 
 [![GitHub](https://img.shields.io/badge/github-%23121011.svg?style=for-the-badge&logo=github&logoColor=white)](https://github.com/slpuk/easyhttp-python)
-![Protocol Version](https://img.shields.io/badge/version-0.3.2-blue?style=for-the-badge)
-![Development Status](https://img.shields.io/badge/status-beta-orange?style=for-the-badge)
+![Protocol Version](https://img.shields.io/badge/version-0.4.0-blue?style=for-the-badge)
+![Development Status](https://img.shields.io/badge/status-alpha-red?style=for-the-badge)
 ![License](https://img.shields.io/badge/license-MIT-green?style=for-the-badge)
 ![Python](https://img.shields.io/badge/python-3.7+-blue?style=for-the-badge&logo=python&logoColor=white)
 
 > **A lightweight HTTP-based P2P framework for IoT and device-to-device communication**
 
 ## 🛠️ Changelog
-- Added context managers support
+- Added UDP multicast discovery
 - Fixed some bugs
 
 ## 📖 About
@@ -23,7 +23,7 @@
 - **🆔 Human-Readable Device IDs** - Base32 identifiers instead of IP addresses
 - **✅ Easy to Use** - Simple API with minimal setup
 - **🚀 Performance** - Asynchronous code and lightweight libraries(FastAPI/aiohttp)
-
+- **⚙️ Auto-detect** - Devices automatically find each other
 
 ## 🏗️ Architecture
 
@@ -51,7 +51,7 @@ EasyHTTP uses a simple JSON-based command system:
 ### Basic Example with Callbacks (synchronous)
 ```python
 import time
-from easyhttp import EasyHTTP
+from easyhttp_python import EasyHTTP
 
 # Callback function
 def handle_data(sender_id, data, timestamp):
@@ -92,10 +92,6 @@ def main():
     easy.start()  # Starting server
     print(f"Device {easy.id} is running on port 5000!")
     
-    # Adding device
-    easy.add("ABC123", "192.168.1.100", 5000)
-    print("Added device ABC123")
-    
     # Monitoring device's status
     try:
         while True:
@@ -114,4 +110,12 @@ def main():
 if __name__ == "__main__":
     main()
 ```
+## 📦 Version History
+
+| Version | Date | Changes |
+|---------|------|---------|
+| 0.4.0 | 2026-11-03 | UDP Discovery, auto-detect |
+| 0.3.3 | 2026-03-01 | Fixed imports, renamed to easyhttp_python |
+| 0.3.2 | 2026-02-14 | Context managers |
+
 **More examples available on [GitHub](https://github.com/slpuk/easyhttp-python)**

easyhttp_python-0.4.0a6/easyhttp_python/__init__.py

@@ -0,0 +1,6 @@
+from .core import EasyHTTPAsync
+from .wrapper import EasyHTTP
+
+__version__ = EasyHTTPAsync.__version__
+__author__ = "slpuk"
+__all__ = ["EasyHTTPAsync", "EasyHTTP"]

easyhttp_python-0.4.0a6/easyhttp_python/_discovery.py

@@ -0,0 +1,145 @@
+"""UDP multicast discovery module for EasyHTTP."""
+
+import asyncio
+import socket
+import struct
+import json
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from .core import EasyHTTPAsync
+
+from loggity import Logger, Colors, LoggerConfig
+log_config = LoggerConfig(
+    colored = True,
+    timestamps = False,
+    timeformat = None,
+    file = None
+)
+log = Logger(config = log_config)
+
+class Discovery:
+    """Manages UDP multicast discovery for EasyHTTP devices."""
+
+    def __init__(
+        self,
+        parent: "EasyHTTPAsync",
+        multicast_group: str = "224.0.0.106",
+        multicast_port: int = 37020,
+    ):
+        self.parent = parent
+        self.version = self.parent.__version__
+        self.multicast_group = multicast_group
+        self.multicast_port = multicast_port
+        self.discovery_task: asyncio.Task | None = None
+        self.enabled = False
+
+    async def start(self):
+        """Start discovery listener and broadcaster."""
+        self.enabled = True
+        self.discovery_task = asyncio.create_task(self._discovery_loop())
+
+    async def stop(self):
+        """Stop discovery tasks."""
+        if self.discovery_task:
+            self.discovery_task.cancel()
+            try:
+                await self.discovery_task
+            except asyncio.CancelledError:
+                pass
+            self.discovery_task = None
+
+    async def _discovery_loop(self):
+        """Run listener and broadcaster concurrently."""
+        listener = asyncio.create_task(self._listen_multicast())
+        broadcaster = asyncio.create_task(self._broadcast_presence())
+        await asyncio.gather(listener, broadcaster)
+
+    async def _listen_multicast(self):
+        """Listen for DISCOVERY messages from other devices."""
+        sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM, socket.IPPROTO_UDP)
+        sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
+        sock.bind(("", self.multicast_port))
+
+        mreq = struct.pack(
+            "4sl", socket.inet_aton(self.multicast_group), socket.INADDR_ANY
+        )
+        sock.setsockopt(socket.IPPROTO_IP, socket.IP_ADD_MEMBERSHIP, mreq)
+        sock.setblocking(False)
+
+        loop = asyncio.get_event_loop()
+        while True:
+            try:
+                data, addr = await loop.sock_recvfrom(sock, 1024)
+                await self._handle_discovery_message(data, addr)
+            except asyncio.CancelledError:
+                break
+            except Exception as e:
+                if self.parent.debug:
+                    log.custom("DISCOVERY", Colors.RED, e)
+
+    async def _broadcast_presence(self):
+        """Periodically broadcast DISCOVERY messages."""
+        sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM, socket.IPPROTO_UDP)
+        sock.setsockopt(socket.IPPROTO_IP, socket.IP_MULTICAST_TTL, 2)
+
+        while True:
+            try:
+                packet = {
+                    "version": self.version,
+                    "type": self.parent.commands.DISCOVERY.value,
+                    "id": self.parent.id,
+                    "port": self.parent.port,
+                }
+                sock.sendto(
+                    json.dumps(packet).encode(),
+                    (self.multicast_group, self.multicast_port),
+                )
+                await asyncio.sleep(30)
+            except asyncio.CancelledError:
+                break
+            except Exception as e:
+                if self.parent.debug:
+                    log.custom("DISCOVERY", Colors.RED, e)
+
+    async def _handle_discovery_message(self, data: bytes, addr: tuple):
+        """Process incoming discovery messages."""
+        try:
+            message = json.loads(data.decode())
+            cmd_type = message.get("type")
+
+            # Received DISCOVERY -> send DISCOVERY_ACK
+            if cmd_type == self.parent.commands.DISCOVERY.value:
+                device_id = message.get("id")
+                device_port = message.get("port")
+
+                if device_id and device_id != self.parent.id:
+                    ack_packet = {
+                        "version": self.version,
+                        "type": self.parent.commands.DISCOVERY_ACK.value,
+                        "id": self.parent.id,
+                        "port": self.parent.port,
+                    }
+                    sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+                    sock.sendto(
+                        json.dumps(ack_packet).encode(),
+                        (addr[0], self.multicast_port),
+                    )
+                    if self.parent.debug:
+                        log.custom("DISCOVERY", Colors.GREEN, f"Responded to {device_id} at {addr[0]}")
+
+            # Received DISCOVERY_ACK -> add device
+            elif cmd_type == self.parent.commands.DISCOVERY_ACK.value:
+                device_id = message.get("id")
+                device_port = message.get("port")
+
+                if device_id and device_id != self.parent.id:
+                    if device_id not in self.parent.devices:
+                        self.parent.add(device_id, addr[0], device_port)
+                        if self.parent.debug:
+                            log.custom("DISCOVERY", Colors.GREEN, f"Found device {device_id} at {addr[0]}")
+                        asyncio.create_task(self.parent.ping(device_id))
+
+        except Exception as e:
+            if self.parent.debug:
+                log.custom("DISCOVERY", Colors.RED, e)