robomart 0.1.0__tar.gz

robomart-0.1.0/PKG-INFO

@@ -0,0 +1,41 @@
+Metadata-Version: 2.4
+Name: robomart
+Version: 0.1.0
+Summary: Python client for the Robomart Network Delivery API
+Author-email: Robomart <ali@robomart.ai>
+License: MIT
+Project-URL: Homepage, https://robomart.ai
+Project-URL: Documentation, https://api.robomart.ai
+Project-URL: Repository, https://github.com/robomart-ai/api
+Keywords: robomart,delivery,robocourier,robot,api,sdk
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# robomart
+
+Python client for the Robomart Network Delivery API — coverage preview, one-step booking at posted flat rates, tracking, proof of delivery, and wallet reads. Mirrors the [TypeScript SDK](https://www.npmjs.com/package/robomart).
+
+```python
+from robomart import Robomart
+
+rm = Robomart("rm_sk_test_...")
+
+route = rm.delivery.coverage({
+    "pickup": {"address": "8080 Park Ln, Dallas, TX"},
+    "dropoff": {"address": "2323 N Field St, Dallas, TX"},
+})
+
+order = rm.delivery.book({
+    "pickup": {"address": "...", "contact": {"name": "...", "phone": "..."}},
+    "dropoff": {"address": "...", "contact": {"name": "...", "phone": "..."}},
+    "parcel": {"length_in": 12, "width_in": 10, "height_in": 8, "weight_lb": 5},
+}, idempotency_key="order-1")
+
+status = rm.delivery.get(order["id"])
+```
+
+Get a key at [console.robomart.ai](https://console.robomart.ai). AI agents can book directly through the Delivery MCP at `mcp.robomart.ai` with the same key.

robomart-0.1.0/README.md

@@ -0,0 +1,24 @@
+# robomart
+
+Python client for the Robomart Network Delivery API — coverage preview, one-step booking at posted flat rates, tracking, proof of delivery, and wallet reads. Mirrors the [TypeScript SDK](https://www.npmjs.com/package/robomart).
+
+```python
+from robomart import Robomart
+
+rm = Robomart("rm_sk_test_...")
+
+route = rm.delivery.coverage({
+    "pickup": {"address": "8080 Park Ln, Dallas, TX"},
+    "dropoff": {"address": "2323 N Field St, Dallas, TX"},
+})
+
+order = rm.delivery.book({
+    "pickup": {"address": "...", "contact": {"name": "...", "phone": "..."}},
+    "dropoff": {"address": "...", "contact": {"name": "...", "phone": "..."}},
+    "parcel": {"length_in": 12, "width_in": 10, "height_in": 8, "weight_lb": 5},
+}, idempotency_key="order-1")
+
+status = rm.delivery.get(order["id"])
+```
+
+Get a key at [console.robomart.ai](https://console.robomart.ai). AI agents can book directly through the Delivery MCP at `mcp.robomart.ai` with the same key.

robomart-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "robomart"
+version = "0.1.0"
+description = "Python client for the Robomart Network Delivery API"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [{ name = "Robomart", email = "ali@robomart.ai" }]
+keywords = ["robomart", "delivery", "robocourier", "robot", "api", "sdk"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+]
+
+[project.urls]
+Homepage = "https://robomart.ai"
+Documentation = "https://api.robomart.ai"
+Repository = "https://github.com/robomart-ai/api"
+
+[tool.setuptools.packages.find]
+include = ["robomart*"]

robomart-0.1.0/robomart/__init__.py

@@ -0,0 +1,149 @@
+"""Python client for the Robomart Network Delivery API.
+
+Prices are posted flat rates, so there is no quote step: preview a route
+with coverage() and book in one call with book().
+
+    from robomart import Robomart
+
+    rm = Robomart("rm_sk_test_...")
+    route = rm.delivery.coverage({
+        "pickup": {"address": "..."},
+        "dropoff": {"address": "..."},
+    })
+    order = rm.delivery.book({...}, idempotency_key="order-1")
+"""
+
+from __future__ import annotations
+
+import json
+import urllib.error
+import urllib.request
+
+__all__ = ["Robomart", "RobomartError"]
+__version__ = "0.1.0"
+
+DEFAULT_BASE_URL = "https://api.robomart.ai"
+DEFAULT_API_VERSION = "2026-08-27"
+
+
+class RobomartError(Exception):
+    """API error carrying the HTTP status and the error envelope."""
+
+    def __init__(self, message, status=None, type=None, code=None):
+        super().__init__(message)
+        self.status = status
+        self.type = type
+        self.code = code
+
+
+class _Http:
+    def __init__(self, api_key, base_url, api_version):
+        self.api_key = api_key
+        self.base_url = base_url.rstrip("/")
+        self.api_version = api_version
+
+    def request(self, method, path, body=None, extra_headers=None):
+        headers = {
+            "Authorization": f"Bearer {self.api_key}",
+            "Content-Type": "application/json",
+            "Robomart-Version": self.api_version,
+            "User-Agent": f"robomart-python/{__version__}",
+        }
+        if extra_headers:
+            headers.update(extra_headers)
+        data = json.dumps(body).encode() if body is not None else None
+        req = urllib.request.Request(
+            self.base_url + path, data=data, headers=headers, method=method
+        )
+        try:
+            with urllib.request.urlopen(req) as resp:
+                return json.loads(resp.read() or b"{}")
+        except urllib.error.HTTPError as err:
+            try:
+                payload = json.loads(err.read() or b"{}")
+            except ValueError:
+                payload = {}
+            detail = payload.get("error")
+            detail = detail if isinstance(detail, dict) else {}
+            message = (
+                detail.get("message")
+                or payload.get("error")
+                or payload.get("message")
+                or f"Request failed with status {err.code}"
+            )
+            raise RobomartError(
+                message, status=err.code,
+                type=detail.get("type"), code=detail.get("code"),
+            ) from None
+
+    def get(self, path):
+        return self.request("GET", path)
+
+    def post(self, path, body=None, extra_headers=None):
+        return self.request("POST", path, body, extra_headers)
+
+
+class Delivery:
+    """Coverage preview, one-step booking, tracking, cancellation, proof."""
+
+    def __init__(self, http):
+        self._http = http
+
+    def coverage(self, input):
+        """Read-only route preview: eligibility, mode, and the posted fee."""
+        return self._http.post("/v1/coverage", input)
+
+    def book(self, input, idempotency_key):
+        """One-step booking at the posted price. The idempotency key makes
+        a retried call replay the original booking instead of double booking."""
+        result = self._http.post(
+            "/v1/deliveries", input, {"Idempotency-Key": idempotency_key}
+        )
+        return result["data"]
+
+    def get(self, id):
+        return self._http.get(f"/v1/deliveries/{id}")["data"]
+
+    def list(self, limit=None):
+        qs = f"?limit={limit}" if limit else ""
+        return self._http.get(f"/v1/deliveries{qs}")["data"]
+
+    def cancel(self, id):
+        """Cancel before pickup releases the full posted price. After pickup
+        the trip stays charged and the call is refused."""
+        return self._http.post(f"/v1/deliveries/{id}/cancel")["data"]
+
+    def proof(self, id):
+        """Proof of delivery, available once the delivery is delivered."""
+        return self._http.get(f"/v1/deliveries/{id}/proof")["data"]
+
+    def simulate(self, id, action):
+        """Sandbox lifecycle driver. Test keys only."""
+        return self._http.post(f"/v1/deliveries/{id}/simulate", {"action": action})["data"]
+
+
+class Wallet:
+    """Balances, the ledger, and funding previews. Cents throughout."""
+
+    def __init__(self, http):
+        self._http = http
+
+    def balance(self):
+        return self._http.get("/v1/balance")
+
+    def ledger(self, limit=None):
+        qs = f"?limit={limit}" if limit else ""
+        return self._http.get(f"/v1/ledger{qs}")["data"]
+
+    def topup_preview(self, amount_credited_cents):
+        return self._http.get(f"/v1/topups/preview?amount_credited={amount_credited_cents}")
+
+    def topup_link(self):
+        return self._http.post("/v1/topups/link")
+
+
+class Robomart:
+    def __init__(self, api_key, base_url=DEFAULT_BASE_URL, api_version=DEFAULT_API_VERSION):
+        http = _Http(api_key, base_url, api_version)
+        self.delivery = Delivery(http)
+        self.wallet = Wallet(http)

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

@@ -0,0 +1,41 @@
+Metadata-Version: 2.4
+Name: robomart
+Version: 0.1.0
+Summary: Python client for the Robomart Network Delivery API
+Author-email: Robomart <ali@robomart.ai>
+License: MIT
+Project-URL: Homepage, https://robomart.ai
+Project-URL: Documentation, https://api.robomart.ai
+Project-URL: Repository, https://github.com/robomart-ai/api
+Keywords: robomart,delivery,robocourier,robot,api,sdk
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# robomart
+
+Python client for the Robomart Network Delivery API — coverage preview, one-step booking at posted flat rates, tracking, proof of delivery, and wallet reads. Mirrors the [TypeScript SDK](https://www.npmjs.com/package/robomart).
+
+```python
+from robomart import Robomart
+
+rm = Robomart("rm_sk_test_...")
+
+route = rm.delivery.coverage({
+    "pickup": {"address": "8080 Park Ln, Dallas, TX"},
+    "dropoff": {"address": "2323 N Field St, Dallas, TX"},
+})
+
+order = rm.delivery.book({
+    "pickup": {"address": "...", "contact": {"name": "...", "phone": "..."}},
+    "dropoff": {"address": "...", "contact": {"name": "...", "phone": "..."}},
+    "parcel": {"length_in": 12, "width_in": 10, "height_in": 8, "weight_lb": 5},
+}, idempotency_key="order-1")
+
+status = rm.delivery.get(order["id"])
+```
+
+Get a key at [console.robomart.ai](https://console.robomart.ai). AI agents can book directly through the Delivery MCP at `mcp.robomart.ai` with the same key.

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

@@ -0,0 +1,7 @@
+README.md
+pyproject.toml
+robomart/__init__.py
+robomart.egg-info/PKG-INFO
+robomart.egg-info/SOURCES.txt
+robomart.egg-info/dependency_links.txt
+robomart.egg-info/top_level.txt

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1 @@
+robomart

robomart-0.1.0/setup.cfg

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