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

{easyhttp_python-0.3.3/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.3
+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.3-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
 
@@ -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.3 → easyhttp_python-0.4.0a6}/README.md

@@ -2,8 +2,8 @@
 [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.3-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)
 
@@ -15,7 +15,7 @@
 > # 0.3.2 (OLD)
 > from easyhttp import ...
 >
-> # 0.3.3 (NEW)
+> # 0.3.3 - newer (NEW)
 > from easyhttp_python import ...
 >```
 
@@ -42,9 +42,6 @@ def main():
     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!")
@@ -77,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!")
@@ -111,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
 ```
@@ -120,8 +115,9 @@ easyhttp-python/
 │   └── EasyHTTPAsync.md # Async API reference
 ├── 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

{easyhttp_python-0.3.3 → 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.3-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
 
@@ -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)

{easyhttp_python-0.3.3 → easyhttp_python-0.4.0a6}/easyhttp_python/core.py

@@ -5,6 +5,7 @@ import secrets
 import time
 import logging
 import json
+import struct
 from pathlib import Path
 from enum import Enum, auto
 from typing import Optional, Union, Dict, Any, Callable
@@ -17,23 +18,44 @@ import uvicorn
 from fastapi import FastAPI, Request
 from fastapi.responses import JSONResponse
 
-__version__ = "0.3.3"
+# EasyHTTP modules
+from ._discovery import Discovery
+
+# Initializing logger
+from loggity import Logger, Colors, LoggerConfig
+log_config = LoggerConfig(
+    colored = True,
+    timestamps = False,
+    timeformat = None,
+    file = None
+)
+log = Logger(config = log_config)
 
 class EasyHTTPAsync:
     """Simple asynchronous HTTP-based core of P2P framework for IoT."""
-    
+    __version__ = "0.4.0-alpha.6"
+
     class commands(Enum):
         """Enumeration of available command types."""
 
-        PING = auto()   # Ping another device
-        PONG = auto()   # Anwser for PING
+        PING = auto()  # Ping another device
+        PONG = auto()  # Anwser for PING
         FETCH = auto()  # Request data from another device
-        DATA = auto()   # Response containing data
-        PUSH = auto()   # Send data to another device
-        ACK = auto()    # Acknowledge successful command
-        NACK = auto()   # Indicate an error occurred
-
-    def __init__(self, debug: bool = False, port: int = 5000, config_file=None):
+        DATA = auto()  # Response containing data
+        PUSH = auto()  # Send data to another device
+        ACK = auto()  # Acknowledge successful command
+        NACK = auto()  # Indicate an error occurred
+        # New for discovery
+        DISCOVERY = auto()  # Broadcast discovery request
+        DISCOVERY_ACK = auto()  # Response to discovery
+
+    def __init__(
+        self,
+        debug: bool = False,
+        port: int = 5000,
+        config_file=None,
+        enable_discovery: bool = True,
+    ):
         """Initialize the EasyHTTPAsync instance.
 
         Args:
@@ -43,12 +65,17 @@ class EasyHTTPAsync:
 
         self.debug = debug
         self.port = port
+        self.enable_discovery = enable_discovery
+
+        if self.enable_discovery:
+            self.discovery = Discovery(self)
 
         if config_file:
             self.config_file = config_file
         else:
             import sys
-            if getattr(sys, 'frozen', False):
+
+            if getattr(sys, "frozen", False):
                 base_dir = os.path.dirname(sys.executable)
             else:
                 base_dir = os.path.dirname(os.path.abspath(sys.argv[0]))
@@ -56,23 +83,24 @@ class EasyHTTPAsync:
 
         self.id = None
         self.callbacks = {
-            'on_ping': None,
-            'on_pong': None,
-            'on_fetch': None,
-            'on_data': None,
-            'on_push': None
+            "on_ping": None,
+            "on_pong": None,
+            "on_fetch": None,
+            "on_data": None,
+            "on_push": None,
         }
         self.devices = {}
         self.app = FastAPI(title="EasyHTTP API", docs_url=None, redoc_url=None)
-        self.app.post('/easyhttp/api')(self.api_handler)
+        self.app.post("/easyhttp/api")(self.api_handler)
         self.server_task = None
+
         self._load_config()
 
     async def __aenter__(self):
         """Enter the async context manager."""
         await self.start()
         return self
-    
+
     async def __aexit__(self, exc_type, exc_val, exc_tb):
         """Exit the async context manager."""
         await self.stop()
@@ -80,37 +108,33 @@ class EasyHTTPAsync:
     def _load_config(self):
         try:
             if os.path.exists(self.config_file):
-                with open(self.config_file, 'r') as f:
+                with open(self.config_file, "r") as f:
                     data = json.load(f)
-                    self.id = data.get('device_id')
-                    
+                    self.id = data.get("device_id")
+
                 if self.debug and self.id:
-                    print(f"\033[32mINFO\033[0m:\t Loaded ID: {self.id} from {self.config_file}")
+                    log.info(f"Loaded ID: {self.id} from {self.config_file}")
         except Exception as e:
             if self.debug:
-                print(f"\033[31mERROR\033[0m:\t Error loading config: {e}")
-    
+                log.error(f"Error loading config: {e}")
+
     def _save_config(self):
         try:
-            config = {
-                'device_id': self.id,
-                'port': self.port,
-                'version': __version__
-            }
-            
-            with open(self.config_file, 'w') as f:
+            config = {"device_id": self.id, "port": self.port, "version": self.__version__}
+
+            with open(self.config_file, "w") as f:
                 json.dump(config, f, indent=2)
-            
+
             if self.debug:
-                print(f"\033[32mINFO\033[0m:\t Saved ID to {self.config_file}")
+                log.info(f"Saved ID to {self.config_file}")
         except Exception as e:
             if self.debug:
-                print(f"\033[31mERROR\033[0m:\t Error saving config: {e}")
+                log.error(f"Error saving config: {e}")
 
     def _get_local_ip(self):
         try:
             s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
-            s.connect(('8.8.8.8', 80))
+            s.connect(("8.8.8.8", 80))
             local_ip = s.getsockname()[0]
             s.close()
             return local_ip
@@ -131,7 +155,7 @@ class EasyHTTPAsync:
         """
 
         alphabet = "23456789ABCDEFGHJKLMNPQRSTUVWXYZ"
-        self.id = ''.join(secrets.choice(alphabet) for _ in range(length))
+        self.id = "".join(secrets.choice(alphabet) for _ in range(length))
         self._save_config()
 
     def on(self, event: str, callback_func: Callable) -> None:
@@ -164,18 +188,18 @@ class EasyHTTPAsync:
 
         if len(device_id) != 6:
             raise ValueError("Device ID must be 6 characters")
-    
+
         if device_id not in self.devices:
             self.devices[device_id] = {
-                'ip': device_ip,
-                'port': int(device_port),
-                'last_seen': time.time(),
-                'added_manually': True
+                "ip": device_ip,
+                "port": int(device_port),
+                "last_seen": time.time(),
+                "added_manually": True,
             }
             if self.debug:
-                print(f"DEBUG:\t Added device {device_id}: {device_ip}:{device_port}")
+                log.debug(f"Added device {device_id}: {device_ip}:{device_port}")
         else:
-            print(f"DEBUG:\t Device already exists")
+            log.debug("Device already exists")
 
     async def start(self) -> None:
         """Start the HTTP server and generate a device ID if not set."""
@@ -185,35 +209,45 @@ class EasyHTTPAsync:
 
         try:
             config = uvicorn.Config(
-                self.app, 
-                host="0.0.0.0", 
+                self.app,
+                host="0.0.0.0",
                 port=self.port,
                 log_level="warning",
-                lifespan="off"
+                lifespan="off",
             )
-            
+
             server = uvicorn.Server(config)
             self.server_task = asyncio.create_task(server.serve())
 
-            logging.getLogger('werkzeug').disabled = True
-            logging.getLogger('uvicorn.error').propagate = False
-            logging.getLogger('uvicorn.access').propagate = False
+            logging.getLogger("werkzeug").disabled = True
+            logging.getLogger("uvicorn.error").propagate = False
+            logging.getLogger("uvicorn.access").propagate = False
+
+            # Starting discovery
+            if self.enable_discovery:
+                await self.discovery.start()
 
             await asyncio.sleep(2)  # Give server time to start
 
             if self.debug:
-                print(f"\033[32mINFO\033[0m:\t \033[1;32mEasyHTTP \033[37m{__version__}\033[0m has been started!")
-                print(f"\033[32mINFO\033[0m:\t Device's ID: {self.id}")
-                print(f"\033[32mINFO\033[0m:\t EasyHTTP starting on port {self.port}")
-                print(f"\033[32mINFO\033[0m:\t API running on \033[1mhttp://{self._get_local_ip()}:{self.port}/easyhttp/api\033[0m")
-            
+                log.info(f"\033[1;32mEasyHTTP \033[37m{self.__version__}\033[0m has been started!")
+                log.info(f"Device's ID: {self.id}")
+                log.info(f"EasyHTTP starting on port {self.port}")
+                log.info(f"API running on \033[1mhttp://{self._get_local_ip()}:{self.port}/easyhttp/api\033[0m")
+                if self.enable_discovery:
+                    log.info(f"Discovery enabled on {self.discovery.multicast_group}:{self.discovery.multicast_port}")
+
         except Exception as e:
-            print(f"\033[31mERROR\033[0m:\t Failed to start server: {e}")
+            log.error(f"Failed to start server: {e}")
             raise
 
     async def stop(self) -> None:
         """Gracefully stop the HTTP server and cancel the server task."""
 
+        # Stopping discovery
+        if hasattr(self, 'discovery') and self.discovery:
+            await self.discovery.stop()
+
         if self.server_task:
             self.server_task.cancel()
             try:
@@ -221,7 +255,34 @@ class EasyHTTPAsync:
             except asyncio.CancelledError:
                 pass
 
-    async def send(self, device_id: str, command_type: Union[int, 'commands'], data: Optional[Any] = None) -> Optional[dict]:
+    async def start_discovery(self):
+        """Manually start discovery service."""
+        if self.debug:
+            log.debug("Enabled discovery")
+        self.enable_discovery = True
+        await self.discovery.start()
+
+    async def stop_discovery(self):
+        """Manually stop discovery service."""
+        if self.debug:
+            log.debug("Disabled discovery")
+        self.enable_discovery = False
+        await self.discovery.stop()
+
+    def get_discovered(self) -> list:
+        """Return list of auto-discovered device IDs."""
+        return [
+            did
+            for did, info in self.devices.items()
+            if not info.get("added_manually", False)
+        ]
+
+    async def send(
+        self,
+        device_id: str,
+        command_type: Union[int, "commands"],
+        data: Optional[Any] = None,
+    ) -> Optional[dict]:
         """Send a JSON-formatted command to another device.
 
         Args:
@@ -239,35 +300,41 @@ class EasyHTTPAsync:
 
         if device_id not in self.devices:
             if self.debug:
-                print(f"\033[31mERROR\033[0m:\t Device {device_id} not found in devices cache")
+                log.error(f"Device {device_id} not found in devices cache")
             return None
-    
+
         packet = {
-            "version": __version__,
-            "type": command_type if isinstance(command_type, self.commands) else command_type,
+            "version": self.__version__,
+            "type": (
+                command_type
+                if isinstance(command_type, self.commands)
+                else command_type
+            ),
             "header": {
-                "sender_id": self.id, 
+                "sender_id": self.id,
                 "sender_port": self.port,
-                "recipient_id": device_id, 
-                "timestamp": int(time.time())
-            }
+                "recipient_id": device_id,
+                "timestamp": int(time.time()),
+            },
         }
-    
+
         if data:
-            packet['data'] = data
-    
+            packet["data"] = data
+
         recipient_url = f"http://{self.devices[device_id]['ip']}:{self.devices[device_id]['port']}/easyhttp/api"
-    
+
         try:
             async with aiohttp.ClientSession() as session:
-                async with session.post(recipient_url, json=packet, timeout=3) as response:
+                async with session.post(
+                    recipient_url, json=packet, timeout=3
+                ) as response:
                     if response.status == 200:
                         return await response.json()
                     return None
-            
+
         except Exception as e:
             if self.debug:
-                print(f'\033[31mERROR\033[0m:\t Failed to send to {device_id}: {e}')
+                log.error(f"Failed to send to {device_id}: {e}")
             return None
 
     async def ping(self, device_id: str) -> bool:
@@ -281,26 +348,28 @@ class EasyHTTPAsync:
         """
 
         response = await self.send(device_id, self.commands.PING.value)
-    
-        if response and response.get('type') == self.commands.PONG.value:
+
+        if response and response.get("type") == self.commands.PONG.value:
             if self.debug:
-                print(f"\033[32mPING\033[0m:\t {device_id} is online")
+                log.custom("PING", Colors.GREEN, f"{device_id} is online")
             if device_id in self.devices:
-                self.devices[device_id]['last_seen'] = time.time()
+                self.devices[device_id]["last_seen"] = time.time()
             return True
         else:
             if self.debug:
-                print(f"\033[31mPING\033[0m:\t {device_id} is offline or not responding")
+                log.custom("PING", Colors.RED, f"{device_id} is offline or not responding")
             return False
 
-    async def fetch(self, device_id: str, query: Optional[Any] = None) -> Optional[dict]:
+    async def fetch(
+        self, device_id: str, query: Optional[Any] = None
+    ) -> Optional[dict]:
         """Send a FETCH request to another device and return the response.
 
         Args:
             device_id: ID of the target device.
             query: Query data to send with the FETCH request.
 
-        Returns: 
+        Returns:
             Response data from the device, or None if failed.
             The dict typically contains 'type', 'header', and 'data' fields.
         """
@@ -324,16 +393,16 @@ class EasyHTTPAsync:
 
         if data is not None and not isinstance(data, (dict, list, str)):
             raise TypeError("Data must be JSON-serializable (dict, list, str)")
-        
+
         response = await self.send(device_id, self.commands.PUSH, data)
 
-        if response and response.get('type') == self.commands.ACK.value:
+        if response and response.get("type") == self.commands.ACK.value:
             if self.debug:
-                print(f"\033[32mPUSH\033[0m:\t Successfully wrote to {device_id}")
+                log.custom("PUSH", Colors.GREEN, f"Successfully wrote to {device_id}")
             return True
         else:
             if self.debug:
-                print(f"\033[31mPUSH\033[0m:\t Error writing to {device_id}")
+                log.custom("PUSH", Colors.RED, f"Error writing to {device_id}")
             return False
 
     async def api_handler(self, request: Request) -> JSONResponse:
@@ -345,173 +414,176 @@ class EasyHTTPAsync:
         Returns:
             JSONResponse: Response to the client.
         """
-        
+
         try:
             data = await request.json()
         except:
             return JSONResponse({"error": "Invalid JSON data"}, status_code=400)
-            
+
         if not data:
             return JSONResponse({"error": "No JSON data"}, status_code=400)
-            
-        command_type = data.get('type')
-        header = data.get('header', {})
-        sender_id = header.get('sender_id')
-        
+
+        command_type = data.get("type")
+        header = data.get("header", {})
+        sender_id = header.get("sender_id")
+
         client_ip = request.client.host if request.client else "0.0.0.0"
 
         if sender_id and sender_id != self.id and sender_id not in self.devices:
             self.devices[sender_id] = {
-                'ip': client_ip,
-                'port': header.get('sender_port', self.port),
-                'last_seen': int(time.time())
+                "ip": client_ip,
+                "port": header.get("sender_port", self.port),
+                "last_seen": int(time.time()),
             }
 
         # Handle PING response
         if command_type == self.commands.PING.value:
-            if self.callbacks['on_ping']:
-                callback = self.callbacks['on_ping']
+            if self.callbacks["on_ping"]:
+                callback = self.callbacks["on_ping"]
                 if asyncio.iscoroutinefunction(callback):
                     await callback(
-                        sender_id=sender_id,
-                        timestamp=header.get('timestamp')
+                        sender_id=sender_id, timestamp=header.get("timestamp")
                     )
                 else:
-                    callback(
-                        sender_id=sender_id,
-                        timestamp=header.get('timestamp')
-                    )
-                
-            return JSONResponse({
-                "version": __version__,
-                "type": self.commands.PONG.value,
-                "header": {
-                    "sender_id": self.id,
-                    "sender_port": self.port,
-                    "recipient_id": sender_id,
-                    "timestamp": int(time.time())
+                    callback(sender_id=sender_id, timestamp=header.get("timestamp"))
+
+            return JSONResponse(
+                {
+                    "version": self.__version__,
+                    "type": self.commands.PONG.value,
+                    "header": {
+                        "sender_id": self.id,
+                        "sender_port": self.port,
+                        "recipient_id": sender_id,
+                        "timestamp": int(time.time()),
+                    },
                 }
-            })
+            )
 
         # Handle PONG answer
         elif command_type == self.commands.PONG.value:
-            if self.callbacks['on_pong']:
-                callback = self.callbacks['on_pong']
+            if self.callbacks["on_pong"]:
+                callback = self.callbacks["on_pong"]
                 if asyncio.iscoroutinefunction(callback):
                     await callback(
-                        sender_id=sender_id,
-                        timestamp=header.get('timestamp')
+                        sender_id=sender_id, timestamp=header.get("timestamp")
                     )
                 else:
-                    callback(
-                        sender_id=sender_id,
-                        timestamp=header.get('timestamp')
-                    )
+                    callback(sender_id=sender_id, timestamp=header.get("timestamp"))
 
             if self.debug:
-                print(f"\033[32mPONG\033[0m:\t Received from {sender_id}")
+                log.custom("PONG", Colors.GREEN, f"Received from {sender_id}")
             if sender_id in self.devices:
-                self.devices[sender_id]['last_seen'] = time.time()
+                self.devices[sender_id]["last_seen"] = time.time()
             return JSONResponse({"status": "pong_received"})
 
         # Handle FETCH response
         elif command_type == self.commands.FETCH.value:
-            if self.callbacks['on_fetch']:
-                callback = self.callbacks['on_fetch']
+            if self.callbacks["on_fetch"]:
+                callback = self.callbacks["on_fetch"]
                 if asyncio.iscoroutinefunction(callback):
-                    response_data = await callback (
+                    response_data = await callback(
                         sender_id=sender_id,
-                        query=data.get('data'),
-                        timestamp=header.get('timestamp')
+                        query=data.get("data"),
+                        timestamp=header.get("timestamp"),
                     )
                 else:
-                    response_data = callback (
+                    response_data = callback(
                         sender_id=sender_id,
-                        query=data.get('data'),
-                        timestamp=header.get('timestamp')
+                        query=data.get("data"),
+                        timestamp=header.get("timestamp"),
                     )
                 if response_data:
-                    return JSONResponse({
-                        "version": __version__,
-                        "type": self.commands.DATA.value,
+                    return JSONResponse(
+                        {
+                            "version": self.__version__,
+                            "type": self.commands.DATA.value,
+                            "header": {
+                                "sender_id": self.id,
+                                "sender_port": self.port,
+                                "recipient_id": sender_id,
+                                "timestamp": int(time.time()),
+                            },
+                            "data": response_data,
+                        }
+                    )
+            return JSONResponse({"status": "fetch_handled"})
+
+        # Handle PUSH response
+        elif command_type == self.commands.PUSH.value:
+            if not self.callbacks["on_push"]:
+                return JSONResponse(
+                    {
+                        "version": self.__version__,
+                        "type": self.commands.NACK.value,
                         "header": {
                             "sender_id": self.id,
                             "sender_port": self.port,
                             "recipient_id": sender_id,
-                            "timestamp": int(time.time())
+                            "timestamp": int(time.time()),
                         },
-                        "data": response_data
-                    })
-            return JSONResponse({"status": "fetch_handled"})
-
-        # Handle PUSH response
-        elif command_type == self.commands.PUSH.value:
-            if not self.callbacks['on_push']:
-                return JSONResponse({
-                    "version": __version__,
-                    "type": self.commands.NACK.value,
-                    "header": {
-                        "sender_id": self.id,
-                        "sender_port": self.port,
-                        "recipient_id": sender_id,
-                        "timestamp": int(time.time())
                     },
-                }, status_code=400)
+                    status_code=400,
+                )
 
-            callback = self.callbacks['on_push']
+            callback = self.callbacks["on_push"]
             if asyncio.iscoroutinefunction(callback):
                 success = await callback(
                     sender_id=sender_id,
-                    data=data.get('data'),
-                    timestamp=header.get('timestamp')
+                    data=data.get("data"),
+                    timestamp=header.get("timestamp"),
                 )
             else:
                 success = callback(
                     sender_id=sender_id,
-                    data=data.get('data'),
-                    timestamp=header.get('timestamp')
+                    data=data.get("data"),
+                    timestamp=header.get("timestamp"),
                 )
-            
+
             if success:
-                return JSONResponse({
-                    "version": __version__,
-                    "type": self.commands.ACK.value,
-                    "header": {
-                        "sender_id": self.id,
-                        "sender_port": self.port,
-                        "recipient_id": sender_id,
-                        "timestamp": int(time.time())
+                return JSONResponse(
+                    {
+                        "version": self.__version__,
+                        "type": self.commands.ACK.value,
+                        "header": {
+                            "sender_id": self.id,
+                            "sender_port": self.port,
+                            "recipient_id": sender_id,
+                            "timestamp": int(time.time()),
+                        },
                     }
-                })
+                )
             else:
-                return JSONResponse({
-                    "version": __version__,
-                    "type": self.commands.NACK.value,
-                    "header": {
-                        "sender_id": self.id,
-                        "sender_port": self.port,
-                        "recipient_id": sender_id,
-                        "timestamp": int(time.time())
+                return JSONResponse(
+                    {
+                        "version": self.__version__,
+                        "type": self.commands.NACK.value,
+                        "header": {
+                            "sender_id": self.id,
+                            "sender_port": self.port,
+                            "recipient_id": sender_id,
+                            "timestamp": int(time.time()),
+                        },
                     }
-                })
+                )
 
         # Handle DATA
         elif command_type == self.commands.DATA.value:
-            if self.callbacks['on_data']:
-                callback = self.callbacks['on_data']
+            if self.callbacks["on_data"]:
+                callback = self.callbacks["on_data"]
                 if asyncio.iscoroutinefunction(callback):
                     await callback(
                         sender_id=sender_id,
-                        data=data.get('data'),
-                        timestamp=header.get('timestamp')
+                        data=data.get("data"),
+                        timestamp=header.get("timestamp"),
                     )
                 else:
                     callback(
                         sender_id=sender_id,
-                        data=data.get('data'),
-                        timestamp=header.get('timestamp')
+                        data=data.get("data"),
+                        timestamp=header.get("timestamp"),
                     )
             return JSONResponse({"status": "data_received"})
-        
+
         # Handle unknown command types
         return JSONResponse({"error": "Unknown command type"}, status_code=400)

{easyhttp_python-0.3.3 → easyhttp_python-0.4.0a6}/easyhttp_python/wrapper.py

@@ -2,12 +2,18 @@
 
 import asyncio
 from typing import Optional, Any, Callable
-from .core import EasyHTTPAsync, __version__
+from .core import EasyHTTPAsync
 
 class EasyHTTP:
     """Simple HTTP-based P2P framework with asynchronous core for IoT."""
-    
-    def __init__(self, debug: bool = False, port: int = 5000, config_file: Optional[str] = None):
+
+    def __init__(
+        self,
+        debug: bool = False,
+        port: int = 5000,
+        config_file: Optional[str] = None,
+        enable_discovery: bool = True,
+    ):
         """Initialize the EasyHTTP instance.
 
         Args:
@@ -15,19 +21,23 @@ class EasyHTTP:
             port: Port to run the HTTP server on. Defaults to 5000.
         """
 
-        self._core = EasyHTTPAsync(debug=debug, port=port, config_file=config_file)
+        self._core = EasyHTTPAsync(
+            debug=debug,
+            port=port,
+            config_file=config_file,
+            enable_discovery=enable_discovery,
+        )
         self._loop = None
         self._running = False
-        
         self.commands = self._core.commands
-        self.__version__ = __version__
-        
+        self.__version__ = self._core.__version__
+
     def _ensure_loop(self):
         """Ensure event loop is running."""
         if not self._loop:
             self._loop = asyncio.new_event_loop()
             asyncio.set_event_loop(self._loop)
-    
+
     def on(self, event: str, callback_func: Callable) -> None:
         """Register a callback function for a specific event.
 
@@ -39,7 +49,7 @@ class EasyHTTP:
             ValueError: If the event is unknown.
         """
         self._core.on(event, callback_func)
-    
+
     def add(self, device_id: str, device_ip: str, device_port: int) -> None:
         """Manually add a device to the local devices cache.
 
@@ -58,14 +68,16 @@ class EasyHTTP:
         self._ensure_loop()
         self._loop.run_until_complete(self._core.start())
         self._running = True
-        
+
     def stop(self) -> None:
         """Gracefully stop the HTTP server and cancel the server task."""
         if self._running:
             self._loop.run_until_complete(self._core.stop())
             self._running = False
-    
-    def send(self, device_id: str, command_type: Any, data: Optional[Any] = None) -> Optional[dict]:
+
+    def send(
+        self, device_id: str, command_type: Any, data: Optional[Any] = None
+    ) -> Optional[dict]:
         """Send a JSON-formatted command to another device.
 
         Args:
@@ -85,7 +97,7 @@ class EasyHTTP:
         return self._loop.run_until_complete(
             self._core.send(device_id, command_type, data)
         )
-    
+
     def ping(self, device_id: str) -> bool:
         """Send a PING request to a device and check if it's online.
 
@@ -95,10 +107,8 @@ class EasyHTTP:
         Returns:
             True if device responded with PONG, False otherwise.
         """
-        return self._loop.run_until_complete(
-            self._core.ping(device_id)
-        )
-    
+        return self._loop.run_until_complete(self._core.ping(device_id))
+
     def fetch(self, device_id: str, query: Optional[Any] = None) -> Optional[dict]:
         """Send a FETCH request to another device and return the response.
 
@@ -106,14 +116,12 @@ class EasyHTTP:
             device_id: ID of the target device.
             query: Query data to send with the FETCH request.
 
-        Returns: 
+        Returns:
             Response data from the device, or None if failed.
             The dict typically contains 'type', 'header', and 'data' fields.
         """
-        return self._loop.run_until_complete(
-            self._core.fetch(device_id, query)
-        )
-    
+        return self._loop.run_until_complete(self._core.fetch(device_id, query))
+
     def push(self, device_id: str, data: Optional[Any] = None) -> bool:
         """Send data to another device using PUSH command.
 
@@ -127,27 +135,25 @@ class EasyHTTP:
         Raises:
             TypeError: If data is not JSON-serializable.
         """
-        return self._loop.run_until_complete(
-            self._core.push(device_id, data)
-        )
+        return self._loop.run_until_complete(self._core.push(device_id, data))
 
     # Context manager support
     def __enter__(self):
         """Enter the sync context manager."""
         self.start()
         return self
-    
+
     def __exit__(self, exc_type, exc_val, exc_tb):
         """Exit the sync context manager."""
         self.stop()
-    
+
     # Property accessors
     @property
     def id(self) -> str:
         """Get device ID."""
         return self._core.id
-    
+
     @property
     def devices(self) -> dict:
         """Get devices cache."""
-        return self._core.devices
+        return self._core.devices

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: easyhttp-python
-Version: 0.3.3
+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.3-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
 
@@ -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.3 → easyhttp_python-0.4.0a6}/easyhttp_python.egg-info/SOURCES.txt

@@ -3,6 +3,7 @@ README.md
 README_PY.md
 pyproject.toml
 easyhttp_python/__init__.py
+easyhttp_python/_discovery.py
 easyhttp_python/core.py
 easyhttp_python/wrapper.py
 easyhttp_python.egg-info/PKG-INFO

{easyhttp_python-0.3.3 → easyhttp_python-0.4.0a6}/easyhttp_python.egg-info/requires.txt

@@ -1,6 +1,7 @@
 fastapi>=0.103.2
 uvicorn[standard]>=0.22.0
 aiohttp>=3.7.0
+loggity>=0.5.0a6
 
 [dev]
 pytest>=6.0

{easyhttp_python-0.3.3 → easyhttp_python-0.4.0a6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "easyhttp-python"
-version = "0.3.3"
+version = "0.4.0-alpha.6"
 authors = [
     {name = "slpuk", email = "yarik6052@gmail.com"},
 ]
@@ -14,7 +14,7 @@ requires-python = ">=3.7"
 license = {text = "MIT"}
 keywords = ["iot", "p2p", "http", "framework"]
 classifiers = [
-    "Development Status :: 4 - Beta",
+    "Development Status :: 3 - Alpha",
     "Intended Audience :: Developers",
     "Topic :: Software Development :: Libraries :: Python Modules",
     "Topic :: Communications",
@@ -31,7 +31,8 @@ classifiers = [
 dependencies = [
     "fastapi>=0.103.2",
     "uvicorn[standard]>=0.22.0",
-    "aiohttp>=3.7.0"
+    "aiohttp>=3.7.0",
+    "loggity>=0.5.0a6"
 ]
 
 [project.urls]

easyhttp_python-0.3.3/easyhttp_python/__init__.py

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