edgeconductor 0.1.0__tar.gz

edgeconductor-0.1.0/PKG-INFO

@@ -0,0 +1,65 @@
+Metadata-Version: 2.4
+Name: edgeconductor
+Version: 0.1.0
+Summary: Official Python SDK for the EdgeConductor IoT Platform
+Home-page: https://github.com/edgeconductor-creator/ec-platform
+Author: EdgeConductor
+Author-email: EdgeConductor <edgeconductor@gmail.com>
+License: MIT
+Project-URL: Homepage, https://edgeconductor.com
+Project-URL: Repository, https://github.com/edgeconductor-creator/ec-platform
+Project-URL: Documentation, https://edgeconductor.com/developers
+Keywords: iot,mqtt,telemetry,device-management,edge-computing
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Topic :: System :: Hardware
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Dynamic: author
+Dynamic: home-page
+Dynamic: requires-python
+
+# edgeconductor
+
+Official Python SDK for the [EdgeConductor IoT Platform](https://edgeconductor.com).
+
+## Installation
+
+```bash
+pip install edgeconductor
+```
+
+## Quick Start
+
+```python
+from edgeconductor import Client
+
+ec = Client(
+    api_key  = "ec_live_xxxxxxxxxxxx",   # from /org/settings → API Keys
+    base_url = "https://ec-registry.onrender.com",
+)
+
+# Register device
+ec.devices.register(serial_no="MY-001", product_type="EC-CLIMATE-V1")
+
+# Push telemetry
+ec.telemetry.push("MY-001", temp=24.5, hum=60, co2=850, bat=4.05)
+
+# Get current state
+shadow = ec.devices.get_shadow("MY-001")
+print(shadow)  # {"temp": 24.5, "hum": 60, ...}
+
+# Create automation rule
+ec.rules.threshold(
+    org_id, name="CO₂ Alert",
+    field="co2", op=">", value=1000,
+    action={"key": "relay", "value": True},
+)
+```
+
+## Links
+
+- **Docs:** [edgeconductor.com/developers](https://edgeconductor.com/developers)
+- **API Keys:** Login → /org/settings → API Keys
+- **Support:** edgeconductor@gmail.com

edgeconductor-0.1.0/README.md

@@ -0,0 +1,43 @@
+# edgeconductor
+
+Official Python SDK for the [EdgeConductor IoT Platform](https://edgeconductor.com).
+
+## Installation
+
+```bash
+pip install edgeconductor
+```
+
+## Quick Start
+
+```python
+from edgeconductor import Client
+
+ec = Client(
+    api_key  = "ec_live_xxxxxxxxxxxx",   # from /org/settings → API Keys
+    base_url = "https://ec-registry.onrender.com",
+)
+
+# Register device
+ec.devices.register(serial_no="MY-001", product_type="EC-CLIMATE-V1")
+
+# Push telemetry
+ec.telemetry.push("MY-001", temp=24.5, hum=60, co2=850, bat=4.05)
+
+# Get current state
+shadow = ec.devices.get_shadow("MY-001")
+print(shadow)  # {"temp": 24.5, "hum": 60, ...}
+
+# Create automation rule
+ec.rules.threshold(
+    org_id, name="CO₂ Alert",
+    field="co2", op=">", value=1000,
+    action={"key": "relay", "value": True},
+)
+```
+
+## Links
+
+- **Docs:** [edgeconductor.com/developers](https://edgeconductor.com/developers)
+- **API Keys:** Login → /org/settings → API Keys
+- **Support:** edgeconductor@gmail.com

edgeconductor-0.1.0/edgeconductor/__init__.py

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

edgeconductor-0.1.0/edgeconductor/client.py

@@ -0,0 +1,197 @@
+"""
+EdgeConductor Python SDK
+
+Official Python SDK for the EdgeConductor IoT Platform.
+
+Usage:
+    from edgeconductor import Client
+
+    ec = Client(api_key="ec_live_xxxx")
+
+    ec.devices.register(serial_no="MY-001", product_type="EC-CLIMATE-V1")
+    ec.telemetry.push("MY-001", temp=24.5, hum=60, co2=850)
+    shadow = ec.devices.get_shadow("MY-001")
+"""
+
+import json
+import urllib.request
+import urllib.error
+from typing import Optional, List, Dict, Any
+
+DEFAULT_BASE_URL = "https://ec-registry.onrender.com"
+
+
+class EdgeConductorError(Exception):
+    pass
+
+
+class _BaseAPI:
+    def __init__(self, client: "Client"):
+        self._c = client
+
+
+class Client:
+    def __init__(self, api_key: str, base_url: str = DEFAULT_BASE_URL):
+        if not api_key:
+            raise ValueError("EdgeConductor: api_key is required")
+        self._api_key  = api_key
+        self._base_url = base_url.rstrip("/")
+        self.devices   = DevicesAPI(self)
+        self.telemetry = TelemetryAPI(self)
+        self.rules     = RulesAPI(self)
+        self.orgs      = OrgsAPI(self)
+        self.audit     = AuditAPI(self)
+
+    def _request(self, method: str, path: str, body: Optional[Dict] = None) -> Any:
+        url  = f"{self._base_url}{path}"
+        data = json.dumps(body).encode() if body is not None else None
+        req  = urllib.request.Request(
+            url, data=data, method=method,
+            headers={
+                "Content-Type":  "application/json",
+                "Authorization": f"Bearer {self._api_key}",
+            },
+        )
+        try:
+            with urllib.request.urlopen(req) as res:
+                return json.loads(res.read())
+        except urllib.error.HTTPError as e:
+            msg = e.read().decode()
+            try:
+                msg = json.loads(msg).get("error", msg)
+            except Exception:
+                pass
+            raise EdgeConductorError(f"EC API {e.code}: {msg}") from e
+
+
+class DevicesAPI(_BaseAPI):
+    def register(self, serial_no: str, product_type: str, fw_version: str = "1.0.0") -> Dict:
+        """Register a new device."""
+        return self._c._request("POST", "/devices/register", {
+            "serial_no": serial_no, "product_type": product_type, "fw_version": fw_version,
+        })
+
+    def list(self, org_id: Optional[str] = None, tenant_id: Optional[str] = None) -> List[Dict]:
+        """List devices filtered by org or tenant."""
+        params = f"org_id={org_id}" if org_id else f"tenant_id={tenant_id}" if tenant_id else ""
+        return self._c._request("GET", f"/devices{'?' + params if params else ''}")
+
+    def get(self, serial: str) -> Dict:
+        """Get device details + shadow."""
+        return self._c._request("GET", f"/devices/{serial}")
+
+    def get_shadow(self, serial: str) -> Optional[Dict]:
+        """Get device reported state (live sensor values)."""
+        return self.get(serial).get("shadow_reported")
+
+    def push_config(self, serial: str, **config) -> Dict:
+        """Push config to device (updates desired state → MQTT command)."""
+        return self._c._request("PATCH", f"/devices/{serial}/shadow/desired", config)
+
+    def push_ota(self, serial: str, firmware_id: str) -> Dict:
+        """Push OTA firmware update."""
+        return self._c._request("POST", f"/devices/{serial}/ota", {"firmware_id": firmware_id})
+
+    def reboot(self, serial: str) -> Dict:
+        """Remote reboot device."""
+        return self._c._request("POST", f"/devices/{serial}/reboot")
+
+    def assign(self, serial: str, org_id: Optional[str] = None, room_id: Optional[str] = None) -> Dict:
+        """Assign device to org/room."""
+        body = {}
+        if org_id:  body["org_id"]  = org_id
+        if room_id: body["room_id"] = room_id
+        return self._c._request("PATCH", f"/devices/{serial}/assign", body)
+
+
+class TelemetryAPI(_BaseAPI):
+    def push(self, serial: str, **payload) -> Dict:
+        """
+        Push telemetry from device to cloud.
+
+        Example:
+            ec.telemetry.push("MY-001", temp=24.5, hum=60, co2=850, bat=4.05)
+        """
+        return self._c._request("POST", f"/devices/{serial}/telemetry", payload)
+
+    def history(self, serial: str, hours: int = 1, limit: int = 500) -> List[Dict]:
+        """Get historical telemetry (oldest first)."""
+        return self._c._request("GET", f"/devices/{serial}/telemetry?hours={hours}&limit={limit}")
+
+    def recent(self, serial: str, limit: int = 20) -> List[Dict]:
+        """Get last N telemetry records (newest first)."""
+        return self._c._request("GET", f"/devices/{serial}/telemetry?limit={limit}")
+
+
+class RulesAPI(_BaseAPI):
+    def list(self, org_id: str) -> List[Dict]:
+        return self._c._request("GET", f"/orgs/{org_id}/rules")
+
+    def threshold(self, org_id: str, name: str, field: str, op: str, value: float,
+                  action: Dict, room_id: Optional[str] = None, webhook_url: Optional[str] = None) -> Dict:
+        """
+        Create threshold rule.
+
+        Example:
+            ec.rules.threshold(
+                org_id, name="CO2 Alert",
+                field="co2", op=">", value=1000,
+                action={"key": "relay", "value": True}
+            )
+        """
+        return self._c._request("POST", f"/orgs/{org_id}/rules", {
+            "name": name, "rule_type": "threshold",
+            "condition": {"field": field, "op": op, "value": value},
+            "action": action,
+            "room_id": room_id, "webhook_url": webhook_url,
+        })
+
+    def schedule(self, org_id: str, name: str, time: str, days: List[str],
+                 action: Dict, room_id: Optional[str] = None) -> Dict:
+        """
+        Create schedule rule.
+
+        Example:
+            ec.rules.schedule(
+                org_id, name="Morning ON",
+                time="09:00", days=["mon","tue","wed","thu","fri"],
+                action={"key": "relay", "value": True}
+            )
+        """
+        return self._c._request("POST", f"/orgs/{org_id}/rules", {
+            "name": name, "rule_type": "schedule",
+            "schedule_time": time, "schedule_days": days,
+            "action": action, "room_id": room_id,
+        })
+
+    def enable(self, rule_id: str) -> Dict:
+        return self._c._request("PATCH", f"/rules/{rule_id}", {"enabled": True})
+
+    def disable(self, rule_id: str) -> Dict:
+        return self._c._request("PATCH", f"/rules/{rule_id}", {"enabled": False})
+
+    def delete(self, rule_id: str) -> Dict:
+        return self._c._request("DELETE", f"/rules/{rule_id}")
+
+    def evaluate(self, org_id: str) -> Dict:
+        return self._c._request("POST", f"/orgs/{org_id}/rules/evaluate")
+
+
+class OrgsAPI(_BaseAPI):
+    def get(self, org_id: str) -> Dict:
+        return self._c._request("GET", f"/orgs/{org_id}")
+
+    def list(self) -> List[Dict]:
+        return self._c._request("GET", "/orgs")
+
+    def rooms(self, org_id: str) -> List[Dict]:
+        return self._c._request("GET", f"/orgs/{org_id}/rooms")
+
+    def create_room(self, org_id: str, name: str, floor: str = "", building: str = "") -> Dict:
+        return self._c._request("POST", f"/orgs/{org_id}/rooms",
+                                {"name": name, "floor": floor, "building": building})
+
+
+class AuditAPI(_BaseAPI):
+    def list(self, org_id: str, limit: int = 50) -> List[Dict]:
+        return self._c._request("GET", f"/orgs/{org_id}/audit?limit={limit}")

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

@@ -0,0 +1,65 @@
+Metadata-Version: 2.4
+Name: edgeconductor
+Version: 0.1.0
+Summary: Official Python SDK for the EdgeConductor IoT Platform
+Home-page: https://github.com/edgeconductor-creator/ec-platform
+Author: EdgeConductor
+Author-email: EdgeConductor <edgeconductor@gmail.com>
+License: MIT
+Project-URL: Homepage, https://edgeconductor.com
+Project-URL: Repository, https://github.com/edgeconductor-creator/ec-platform
+Project-URL: Documentation, https://edgeconductor.com/developers
+Keywords: iot,mqtt,telemetry,device-management,edge-computing
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Topic :: System :: Hardware
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Dynamic: author
+Dynamic: home-page
+Dynamic: requires-python
+
+# edgeconductor
+
+Official Python SDK for the [EdgeConductor IoT Platform](https://edgeconductor.com).
+
+## Installation
+
+```bash
+pip install edgeconductor
+```
+
+## Quick Start
+
+```python
+from edgeconductor import Client
+
+ec = Client(
+    api_key  = "ec_live_xxxxxxxxxxxx",   # from /org/settings → API Keys
+    base_url = "https://ec-registry.onrender.com",
+)
+
+# Register device
+ec.devices.register(serial_no="MY-001", product_type="EC-CLIMATE-V1")
+
+# Push telemetry
+ec.telemetry.push("MY-001", temp=24.5, hum=60, co2=850, bat=4.05)
+
+# Get current state
+shadow = ec.devices.get_shadow("MY-001")
+print(shadow)  # {"temp": 24.5, "hum": 60, ...}
+
+# Create automation rule
+ec.rules.threshold(
+    org_id, name="CO₂ Alert",
+    field="co2", op=">", value=1000,
+    action={"key": "relay", "value": True},
+)
+```
+
+## Links
+
+- **Docs:** [edgeconductor.com/developers](https://edgeconductor.com/developers)
+- **API Keys:** Login → /org/settings → API Keys
+- **Support:** edgeconductor@gmail.com

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

@@ -0,0 +1,9 @@
+README.md
+pyproject.toml
+setup.py
+edgeconductor/__init__.py
+edgeconductor/client.py
+edgeconductor.egg-info/PKG-INFO
+edgeconductor.egg-info/SOURCES.txt
+edgeconductor.egg-info/dependency_links.txt
+edgeconductor.egg-info/top_level.txt

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1 @@
+edgeconductor

edgeconductor-0.1.0/pyproject.toml

@@ -0,0 +1,24 @@
+[build-system]
+requires = ["setuptools>=42", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "edgeconductor"
+version = "0.1.0"
+description = "Official Python SDK for the EdgeConductor IoT Platform"
+readme = "README.md"
+license = { text = "MIT" }
+authors = [{ name = "EdgeConductor", email = "edgeconductor@gmail.com" }]
+requires-python = ">=3.8"
+keywords = ["iot", "mqtt", "telemetry", "device-management", "edge-computing"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Topic :: System :: Hardware",
+    "Topic :: Software Development :: Libraries",
+]
+
+[project.urls]
+Homepage = "https://edgeconductor.com"
+Repository = "https://github.com/edgeconductor-creator/ec-platform"
+Documentation = "https://edgeconductor.com/developers"

edgeconductor-0.1.0/setup.cfg

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

edgeconductor-0.1.0/setup.py

@@ -0,0 +1,18 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="edgeconductor",
+    version="0.1.0",
+    description="Official Python SDK for the EdgeConductor IoT Platform",
+    author="EdgeConductor",
+    author_email="edgeconductor@gmail.com",
+    url="https://github.com/edgeconductor-creator/ec-platform",
+    packages=find_packages(),
+    python_requires=">=3.8",
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Topic :: Software Development :: Libraries",
+        "Topic :: System :: Hardware",
+    ],
+)