roboreactor 0.1.0__tar.gz

roboreactor-0.1.0/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/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,8 @@
+# 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/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["setuptools>=61.0.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "roboreactor"
+version = "0.1.0"
+authors = [
+    { name="Your Name", email="kornbot380@hotmail.com" }
+]
+description = "A unified Python client for Roboreactor edge devices and robot simulators."
+readme = "README.md"
+requires-python = ">=3.7"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "requests>=2.25.0",
+]
+
+[project.urls]
+"Homepage" = "https://roboreactor.com"
+
+[tool.setuptools.packages.find]
+where = ["src"]

roboreactor-0.1.0/setup.cfg

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

roboreactor-0.1.0/src/roboreactor/__init__.py

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

roboreactor-0.1.0/src/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/src/roboreactor.egg-info/PKG-INFO

@@ -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/src/roboreactor.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+src/roboreactor/__init__.py
+src/roboreactor/client.py
+src/roboreactor.egg-info/PKG-INFO
+src/roboreactor.egg-info/SOURCES.txt
+src/roboreactor.egg-info/dependency_links.txt
+src/roboreactor.egg-info/requires.txt
+src/roboreactor.egg-info/top_level.txt

roboreactor-0.1.0/src/roboreactor.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

roboreactor-0.1.0/src/roboreactor.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.25.0

roboreactor-0.1.0/src/roboreactor.egg-info/top_level.txt

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