roboreactor 0.1.0__py3-none-any.whl

roboreactor/__init__.py

@@ -0,0 +1,4 @@
+from .client import RoboReactor
+
+__version__ = "0.1.0"
+__all__ = ["RoboReactor"]

roboreactor/client.py

@@ -0,0 +1,108 @@
+import math
+import time
+import requests
+from typing import Dict, Any, Optional
+
+class RoboReactor:
+    """
+    A unified production-ready Python client for the RoboReactor API.
+    Handles motion control, navigation telemetry, and streaming multi-category sensor structures.
+    """
+    def __init__(self, email: str, project_name: str, base_url: str = "https://roboreactor.com"):
+        self.email = email
+        self.project_name = project_name
+        self.base_url = base_url.rstrip("/")
+
+    @staticmethod
+    def euler_to_quaternion(roll_deg: float, pitch_deg: float, yaw_deg: float) -> Dict[str, float]:
+        """Converts Euler angles (in degrees) to a Quaternion dictionary format."""
+        roll = math.radians(roll_deg)
+        pitch = math.radians(pitch_deg)
+        yaw = math.radians(yaw_deg)
+
+        cy = math.cos(yaw * 0.5)
+        sy = math.sin(yaw * 0.5)
+        cp = math.cos(pitch * 0.5)
+        sp = math.sin(pitch * 0.5)
+        cr = math.cos(roll * 0.5)
+        sr = math.sin(roll * 0.5)
+
+        return {
+            "x": sr * cp * cy - cr * sp * sy,
+            "y": cr * sp * cy + sr * cp * sy,
+            "z": cr * cp * sy - sr * sp * cy,
+            "w": cr * cp * cy + sr * sp * sy
+        }
+
+    def _send_post(self, endpoint: str, json_payload: Dict[str, Any], timeout: int = 5) -> Optional[Dict[str, Any]]:
+        url = f"{self.base_url}{endpoint}"
+        try:
+            response = requests.post(url, json=json_payload, timeout=timeout)
+            response.raise_for_status()
+            return response.json()
+        except requests.exceptions.RequestException as e:
+            print(f"Error communicating with {url}: {e}")
+            if hasattr(e, 'response') and e.response is not None:
+                print(f"Response body: {e.response.text}")
+            return None
+
+    def update_feedback_sensors(self, joints_data: Dict[str, Dict[str, float]]) -> Optional[Dict[str, Any]]:
+        """
+        Sends analog angular reading feedback for joint arrays.
+        Endpoint: /feedback_sensor
+        """
+        payload = {self.email: {self.project_name: joints_data}}
+        return self._send_post("/feedback_sensor", payload)
+
+    def send_navigation_control(
+        self, 
+        x: float, 
+        y: float, 
+        z: float, 
+        roll_deg: float, 
+        pitch_deg: float, 
+        yaw_deg: float, 
+        joint_targets_rad: Dict[str, float], 
+        steering_angle_deg: Optional[float] = None,
+        robot_name: str = "Robot_arm_01"
+    ) -> Optional[Dict[str, Any]]:
+        """
+        Sends absolute target coordinates, orientations, and target joint arrays.
+        Endpoint: /api/sim3/input
+        """
+        if steering_angle_deg is None:
+            steering_angle_deg = math.degrees(x / z) if z != 0 else 0.0
+
+        payload = {
+            self.email: {
+                self.project_name: {
+                    "target_position": {"x": x, "y": y, "z": z},
+                    "target_quaternion": self.euler_to_quaternion(roll_deg, pitch_deg, yaw_deg),
+                    "joint_targets": joint_targets_rad,
+                    "steering_angle_deg": steering_angle_deg,
+                    "timestamp": int(time.time() * 1000),
+                    "robot_name": robot_name
+                }
+            }
+        }
+        return self._send_post("/api/sim3/input", payload)
+
+    def post_sensor_data(self, category_payload: Dict[str, Any]) -> Optional[Dict[str, Any]]:
+        """
+        Generic telemetry gateway routing specific structured sensor category payloads.
+        Endpoint: /sensor_postdata
+        """
+        payload = {
+            "email": self.email,
+            "project_name": self.project_name,
+            "sensor_payload": category_payload
+        }
+        return self._send_post("/sensor_postdata", payload)
+
+    def fetch_iot_control(self) -> Optional[Dict[str, Any]]:
+        """
+        Retrieves remote structural commands sent back down to the target package edge loop.
+        Endpoint: /package_iot_control
+        """
+        payload = {self.email: {}}
+        return self._send_post("/package_iot_control", payload)

roboreactor-0.1.0.dist-info/METADATA

@@ -0,0 +1,24 @@
+Metadata-Version: 2.4
+Name: roboreactor
+Version: 0.1.0
+Summary: A unified Python client for Roboreactor edge devices and robot simulators.
+Author-email: Your Name <kornbot380@hotmail.com>
+Project-URL: Homepage, https://roboreactor.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Dynamic: license-file
+
+# roboreactor
+
+Official Python client library for connecting edge devices, emulators, and robot controls directly to the RoboReactor ecosystem.
+
+## Installation
+
+```bash
+pip install roboreactor

roboreactor-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+roboreactor/__init__.py,sha256=t7EmOGRZLP8f2FJby9Nx3CAqNLqm7i6LMQiUZoPgo8k,81
+roboreactor/client.py,sha256=HC36pCxEj1oYR52TCYMv2zxDhZJxDwBdi4A0Qc9-rlQ,4130
+roboreactor-0.1.0.dist-info/licenses/LICENSE,sha256=-TShHLQ6hsGY-glfVKJoM1VucAF7ZjOfH-HArphHgww,1068
+roboreactor-0.1.0.dist-info/METADATA,sha256=anM0CzNdfK5_Irkr1yMN3Xs1U6pddlhgJ24uHHq2A9o,788
+roboreactor-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+roboreactor-0.1.0.dist-info/top_level.txt,sha256=3Fm2qj-dzZbb9fF77jwy7MxPIiuFgVK_iO4L8_Vv11I,12
+roboreactor-0.1.0.dist-info/RECORD,,

roboreactor-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
+

roboreactor-0.1.0.dist-info/licenses/LICENSE

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

roboreactor-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+roboreactor