robot-wrapper-sdk 0.2.4__tar.gz → 0.2.5__tar.gz

robot_wrapper_sdk-0.2.5/PKG-INFO

@@ -0,0 +1,171 @@
+Metadata-Version: 2.4
+Name: robot-wrapper-sdk
+Version: 0.2.5
+Summary: Robot Platform API SDK
+Author-email: GH Robot Platform Team <team@ghrobot.com>
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: httpx[socks]>=0.24.1
+
+# Robot Platform SDK (Python)
+
+Python SDK for Robot Platform with:
+- develop-app authentication (`app_id`/`app_secret`),
+- sync + async clients,
+- auto token refresh,
+- robot operations and login/hardening task flow.
+
+## Installation
+
+```bash
+pip install robot-wrapper-sdk
+```
+
+## Configuration
+
+Set environment variables (recommended):
+
+- `ROBOT_PLATFORM_BASE_URL`
+- `ROBOT_PLATFORM_APP_ID`
+- `ROBOT_PLATFORM_APP_SECRET`
+- `ROBOT_PLATFORM_PROXY_URL` (optional)
+
+Or pass values directly when creating the module.
+
+---
+
+## Quick Start (Sync)
+
+```python
+from robot_sdk import RobotPlatformModule
+
+sdk = RobotPlatformModule(
+    base_url="http://localhost:8085",
+    app_id="your_app_id",
+    app_secret="your_app_secret",
+    # proxy_url="socks5h://192.168.3.100:1080",  # optional
+)
+
+# Read robot
+robot = sdk.get_robot("2047631542552334336")
+print(robot.platform if robot else "not found")
+
+# Update lifecycle status
+sdk.update_status("2047631542552334336", "live")
+
+# Acquire login tasks
+login_tasks = sdk.acquire_need_login(limit=20, lock_minutes=30)
+
+# Update auth status after worker result
+sdk.update_auth_status("2047631542552334336", "authorized")
+# allowed values: authorized | unauthorized | logged_out
+
+# Acquire hardening tasks
+hardening_tasks = sdk.acquire_unhardened(limit=20, lock_minutes=30, min_age_days=0)
+
+# Update hardening status after worker result
+sdk.update_security_hardened("2047631542552334336", True)
+
+sdk.close()
+```
+
+## Quick Start (Async)
+
+```python
+import asyncio
+from robot_sdk import AsyncRobotPlatformModule
+
+async def main():
+    sdk = AsyncRobotPlatformModule(
+        base_url="http://localhost:8085",
+        app_id="your_app_id",
+        app_secret="your_app_secret",
+    )
+
+    robot = await sdk.get_robot("2047631542552334336")
+    print(robot.platform if robot else "not found")
+
+    await sdk.update_auth_status("2047631542552334336", "authorized")
+    await sdk.update_security_hardened("2047631542552334336", True)
+
+    await sdk.close()
+
+asyncio.run(main())
+```
+
+---
+
+## Response Shape (Placeholder)
+
+Acquire endpoints return:
+
+```json
+{
+  "status": "success",
+  "code": 200,
+  "message": "OK",
+  "data": [
+    {
+      "id": "2047631542552334336",
+      "username": "example_user_1",
+      "platform": "facebook",
+      "status": "live",
+      "auth_status": "unauthorized",
+      "metadata": {
+        "security_hardened": false
+      }
+    }
+  ]
+}
+```
+
+Update endpoints return:
+
+```json
+{
+  "status": "success",
+  "code": 200,
+  "message": "OK",
+  "data": null
+}
+```
+
+---
+
+## Main API
+
+### `RobotPlatformModule` (sync)
+- `list_robots(platform=None, status=None, project_id=None, page=1, limit=20)`
+- `get_robot(robot_id)`
+- `delete_robot(robot_id)`
+- `get_secrets(robot_id)`
+- `update_status(robot_id, status)`
+- `acquire_need_login(limit=20, lock_minutes=30)`
+- `acquire_unhardened(limit=20, lock_minutes=30, min_age_days=0)`
+- `update_auth_status(robot_id, auth_status)`
+- `update_security_hardened(robot_id, security_hardened)`
+- `close()`
+
+### `AsyncRobotPlatformModule` (async)
+Async equivalents of all methods above, plus `await close()`.
+
+---
+
+## Documentation
+
+- Usage guide: [`docs/guide.md`](docs/guide.md)
+- Package code: `robot_sdk/`
+
+---
+
+## Build & Publish (Maintainers)
+
+```bash
+make venv
+make install
+make build
+make publish
+```
+
+Requires valid PyPI credentials (Twine).

robot_wrapper_sdk-0.2.5/README.md

@@ -0,0 +1,161 @@
+# Robot Platform SDK (Python)
+
+Python SDK for Robot Platform with:
+- develop-app authentication (`app_id`/`app_secret`),
+- sync + async clients,
+- auto token refresh,
+- robot operations and login/hardening task flow.
+
+## Installation
+
+```bash
+pip install robot-wrapper-sdk
+```
+
+## Configuration
+
+Set environment variables (recommended):
+
+- `ROBOT_PLATFORM_BASE_URL`
+- `ROBOT_PLATFORM_APP_ID`
+- `ROBOT_PLATFORM_APP_SECRET`
+- `ROBOT_PLATFORM_PROXY_URL` (optional)
+
+Or pass values directly when creating the module.
+
+---
+
+## Quick Start (Sync)
+
+```python
+from robot_sdk import RobotPlatformModule
+
+sdk = RobotPlatformModule(
+    base_url="http://localhost:8085",
+    app_id="your_app_id",
+    app_secret="your_app_secret",
+    # proxy_url="socks5h://192.168.3.100:1080",  # optional
+)
+
+# Read robot
+robot = sdk.get_robot("2047631542552334336")
+print(robot.platform if robot else "not found")
+
+# Update lifecycle status
+sdk.update_status("2047631542552334336", "live")
+
+# Acquire login tasks
+login_tasks = sdk.acquire_need_login(limit=20, lock_minutes=30)
+
+# Update auth status after worker result
+sdk.update_auth_status("2047631542552334336", "authorized")
+# allowed values: authorized | unauthorized | logged_out
+
+# Acquire hardening tasks
+hardening_tasks = sdk.acquire_unhardened(limit=20, lock_minutes=30, min_age_days=0)
+
+# Update hardening status after worker result
+sdk.update_security_hardened("2047631542552334336", True)
+
+sdk.close()
+```
+
+## Quick Start (Async)
+
+```python
+import asyncio
+from robot_sdk import AsyncRobotPlatformModule
+
+async def main():
+    sdk = AsyncRobotPlatformModule(
+        base_url="http://localhost:8085",
+        app_id="your_app_id",
+        app_secret="your_app_secret",
+    )
+
+    robot = await sdk.get_robot("2047631542552334336")
+    print(robot.platform if robot else "not found")
+
+    await sdk.update_auth_status("2047631542552334336", "authorized")
+    await sdk.update_security_hardened("2047631542552334336", True)
+
+    await sdk.close()
+
+asyncio.run(main())
+```
+
+---
+
+## Response Shape (Placeholder)
+
+Acquire endpoints return:
+
+```json
+{
+  "status": "success",
+  "code": 200,
+  "message": "OK",
+  "data": [
+    {
+      "id": "2047631542552334336",
+      "username": "example_user_1",
+      "platform": "facebook",
+      "status": "live",
+      "auth_status": "unauthorized",
+      "metadata": {
+        "security_hardened": false
+      }
+    }
+  ]
+}
+```
+
+Update endpoints return:
+
+```json
+{
+  "status": "success",
+  "code": 200,
+  "message": "OK",
+  "data": null
+}
+```
+
+---
+
+## Main API
+
+### `RobotPlatformModule` (sync)
+- `list_robots(platform=None, status=None, project_id=None, page=1, limit=20)`
+- `get_robot(robot_id)`
+- `delete_robot(robot_id)`
+- `get_secrets(robot_id)`
+- `update_status(robot_id, status)`
+- `acquire_need_login(limit=20, lock_minutes=30)`
+- `acquire_unhardened(limit=20, lock_minutes=30, min_age_days=0)`
+- `update_auth_status(robot_id, auth_status)`
+- `update_security_hardened(robot_id, security_hardened)`
+- `close()`
+
+### `AsyncRobotPlatformModule` (async)
+Async equivalents of all methods above, plus `await close()`.
+
+---
+
+## Documentation
+
+- Usage guide: [`docs/guide.md`](docs/guide.md)
+- Package code: `robot_sdk/`
+
+---
+
+## Build & Publish (Maintainers)
+
+```bash
+make venv
+make install
+make build
+make publish
+```
+
+Requires valid PyPI credentials (Twine).

{robot_wrapper_sdk-0.2.4 → robot_wrapper_sdk-0.2.5}/pyproject.toml

@@ -8,7 +8,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "robot-wrapper-sdk"
-version = "0.2.4"
+version = "0.2.5"
 description = "Robot Platform API SDK"
 readme = "README.md"
 requires-python = ">=3.10"

{robot_wrapper_sdk-0.2.4 → robot_wrapper_sdk-0.2.5}/robot_sdk/__init__.py

@@ -31,6 +31,18 @@ class RobotPlatformModule:
     def update_status(self, robot_id: str, status: str) -> None:
         self.robot_usecase.update_status(robot_id, status)
 
+    def acquire_need_login(self, limit: int = 20, lock_minutes: int = 30):
+        return self.robot_usecase.acquire_need_login(limit, lock_minutes)
+
+    def acquire_unhardened(self, limit: int = 20, lock_minutes: int = 30, min_age_days: int = 0):
+        return self.robot_usecase.acquire_unhardened(limit, lock_minutes, min_age_days)
+
+    def update_auth_status(self, robot_id: str, auth_status: str) -> None:
+        self.robot_usecase.update_auth_status(robot_id, auth_status)
+
+    def update_security_hardened(self, robot_id: str, security_hardened: bool) -> None:
+        self.robot_usecase.update_security_hardened(robot_id, security_hardened)
+
 
 class AsyncRobotPlatformModule:
     """Asynchronous Facade for the Robot Platform SDK."""
@@ -57,4 +69,16 @@ class AsyncRobotPlatformModule:
     async def update_status(self, robot_id: str, status: str) -> None:
         await self.robot_usecase.update_status(robot_id, status)
 
-__all__ = ["RobotPlatformModule", "AsyncRobotPlatformModule"]
+    async def acquire_need_login(self, limit: int = 20, lock_minutes: int = 30):
+        return await self.robot_usecase.acquire_need_login(limit, lock_minutes)
+
+    async def acquire_unhardened(self, limit: int = 20, lock_minutes: int = 30, min_age_days: int = 0):
+        return await self.robot_usecase.acquire_unhardened(limit, lock_minutes, min_age_days)
+
+    async def update_auth_status(self, robot_id: str, auth_status: str) -> None:
+        await self.robot_usecase.update_auth_status(robot_id, auth_status)
+
+    async def update_security_hardened(self, robot_id: str, security_hardened: bool) -> None:
+        await self.robot_usecase.update_security_hardened(robot_id, security_hardened)
+
+__all__ = ["RobotPlatformModule", "AsyncRobotPlatformModule", "Robot", "RobotSecrets"]

{robot_wrapper_sdk-0.2.4 → robot_wrapper_sdk-0.2.5}/robot_sdk/application/usecases.py

@@ -21,12 +21,24 @@ class RobotUsecase:
     def list_robots(self, platform: Optional[str] = None, status: Optional[str] = None, project_id: Optional[int] = None, page: int = 1, limit: int = 20) -> Dict[str, Any]:
         items, total = self.repo.list_robots(platform, status, project_id, page, limit)
         return {
-            "data": [r.__dict__ for r in items], 
+            "data": [r.__dict__ for r in items],
             "total": total,
             "page": page,
             "limit": limit
         }
 
+    def acquire_need_login(self, limit: int = 20, lock_minutes: int = 30) -> List[Robot]:
+        return self.repo.acquire_need_login(limit, lock_minutes)
+
+    def acquire_unhardened(self, limit: int = 20, lock_minutes: int = 30, min_age_days: int = 0) -> List[Robot]:
+        return self.repo.acquire_unhardened(limit, lock_minutes, min_age_days)
+
+    def update_auth_status(self, robot_id: str, auth_status: str) -> None:
+        self.repo.update_auth_status(robot_id, auth_status)
+
+    def update_security_hardened(self, robot_id: str, security_hardened: bool) -> None:
+        self.repo.update_security_hardened(robot_id, security_hardened)
+
 
 class AsyncRobotUsecase:
     def __init__(self, repo: AsyncRobotRepository):
@@ -47,8 +59,20 @@ class AsyncRobotUsecase:
     async def list_robots(self, platform: Optional[str] = None, status: Optional[str] = None, project_id: Optional[int] = None, page: int = 1, limit: int = 20) -> Dict[str, Any]:
         items, total = await self.repo.list_robots(platform, status, project_id, page, limit)
         return {
-            "data": [r.__dict__ for r in items], 
+            "data": [r.__dict__ for r in items],
             "total": total,
             "page": page,
             "limit": limit
         }
+
+    async def acquire_need_login(self, limit: int = 20, lock_minutes: int = 30) -> List[Robot]:
+        return await self.repo.acquire_need_login(limit, lock_minutes)
+
+    async def acquire_unhardened(self, limit: int = 20, lock_minutes: int = 30, min_age_days: int = 0) -> List[Robot]:
+        return await self.repo.acquire_unhardened(limit, lock_minutes, min_age_days)
+
+    async def update_auth_status(self, robot_id: str, auth_status: str) -> None:
+        await self.repo.update_auth_status(robot_id, auth_status)
+
+    async def update_security_hardened(self, robot_id: str, security_hardened: bool) -> None:
+        await self.repo.update_security_hardened(robot_id, security_hardened)

{robot_wrapper_sdk-0.2.4 → robot_wrapper_sdk-0.2.5}/robot_sdk/domain/entities.py

@@ -23,3 +23,29 @@ class RobotActivity:
     activity_type: str
     status: str
     message: str
+
+@dataclass
+class AcquireNeedLoginRequest:
+    limit: int = 20
+    lock_minutes: int = 30
+
+@dataclass
+class AcquireUnhardenedRequest:
+    limit: int = 20
+    lock_minutes: int = 30
+    min_age_days: int = 0
+
+@dataclass
+class UpdateAuthStatusRequest:
+    auth_status: str
+
+@dataclass
+class UpdateSecurityHardenedRequest:
+    security_hardened: bool
+
+@dataclass
+class StandardResponse:
+    status: str
+    code: int
+    message: str
+    data: Any = None

{robot_wrapper_sdk-0.2.4 → robot_wrapper_sdk-0.2.5}/robot_sdk/domain/repositories.py

@@ -23,6 +23,22 @@ class RobotRepository(ABC):
     def list_robots(self, platform: Optional[str] = None, status: Optional[str] = None, project_id: Optional[int] = None, page: int = 1, limit: int = 20) -> Tuple[List[Robot], int]:
         pass
 
+    @abstractmethod
+    def acquire_need_login(self, limit: int = 20, lock_minutes: int = 30) -> List[Robot]:
+        pass
+
+    @abstractmethod
+    def acquire_unhardened(self, limit: int = 20, lock_minutes: int = 30, min_age_days: int = 0) -> List[Robot]:
+        pass
+
+    @abstractmethod
+    def update_auth_status(self, robot_id: str, auth_status: str) -> None:
+        pass
+
+    @abstractmethod
+    def update_security_hardened(self, robot_id: str, security_hardened: bool) -> None:
+        pass
+
 class AsyncRobotRepository(ABC):
     @abstractmethod
     async def find_by_id(self, robot_id: str) -> Optional[Robot]:
@@ -43,3 +59,19 @@ class AsyncRobotRepository(ABC):
     @abstractmethod
     async def list_robots(self, platform: Optional[str] = None, status: Optional[str] = None, project_id: Optional[int] = None, page: int = 1, limit: int = 20) -> Tuple[List[Robot], int]:
         pass
+
+    @abstractmethod
+    async def acquire_need_login(self, limit: int = 20, lock_minutes: int = 30) -> List[Robot]:
+        pass
+
+    @abstractmethod
+    async def acquire_unhardened(self, limit: int = 20, lock_minutes: int = 30, min_age_days: int = 0) -> List[Robot]:
+        pass
+
+    @abstractmethod
+    async def update_auth_status(self, robot_id: str, auth_status: str) -> None:
+        pass
+
+    @abstractmethod
+    async def update_security_hardened(self, robot_id: str, security_hardened: bool) -> None:
+        pass

{robot_wrapper_sdk-0.2.4 → robot_wrapper_sdk-0.2.5}/robot_sdk/infrastructure/robot_api_repository.py

@@ -26,12 +26,44 @@ class RobotAPIRepository(RobotRepository):
         if platform: params["platform"] = platform
         if status: params["status"] = status
         if project_id: params["project_id"] = project_id
-        
+
         resp = self.client.request("GET", "/robots", params=params)
         data = resp.get("data", [])
         total = resp.get("total", 0)
         return [Robot(**r) for r in data], total
 
+    def acquire_need_login(self, limit: int = 20, lock_minutes: int = 30) -> List[Robot]:
+        resp = self.client.request(
+            "POST",
+            "/robots/login/acquire",
+            json={"limit": limit, "lock_minutes": lock_minutes},
+        )
+        data = resp.get("data", [])
+        return [Robot(**r) for r in data]
+
+    def acquire_unhardened(self, limit: int = 20, lock_minutes: int = 30, min_age_days: int = 0) -> List[Robot]:
+        resp = self.client.request(
+            "POST",
+            "/robots/security-hardened/acquire",
+            json={"limit": limit, "lock_minutes": lock_minutes, "min_age_days": min_age_days},
+        )
+        data = resp.get("data", [])
+        return [Robot(**r) for r in data]
+
+    def update_auth_status(self, robot_id: str, auth_status: str) -> None:
+        self.client.request(
+            "PATCH",
+            f"/robots/{robot_id}/auth-status",
+            json={"auth_status": auth_status},
+        )
+
+    def update_security_hardened(self, robot_id: str, security_hardened: bool) -> None:
+        self.client.request(
+            "PATCH",
+            f"/robots/{robot_id}/security-hardened",
+            json={"security_hardened": security_hardened},
+        )
+
 class AsyncRobotAPIRepository(AsyncRobotRepository):
     def __init__(self, client: AsyncHTTPClient):
         self.client = client
@@ -55,8 +87,40 @@ class AsyncRobotAPIRepository(AsyncRobotRepository):
         if platform: params["platform"] = platform
         if status: params["status"] = status
         if project_id: params["project_id"] = project_id
-        
+
         resp = await self.client.request("GET", "/robots", params=params)
         data = resp.get("data", [])
         total = resp.get("total", 0)
         return [Robot(**r) for r in data], total
+
+    async def acquire_need_login(self, limit: int = 20, lock_minutes: int = 30) -> List[Robot]:
+        resp = await self.client.request(
+            "POST",
+            "/robots/login/acquire",
+            json={"limit": limit, "lock_minutes": lock_minutes},
+        )
+        data = resp.get("data", [])
+        return [Robot(**r) for r in data]
+
+    async def acquire_unhardened(self, limit: int = 20, lock_minutes: int = 30, min_age_days: int = 0) -> List[Robot]:
+        resp = await self.client.request(
+            "POST",
+            "/robots/security-hardened/acquire",
+            json={"limit": limit, "lock_minutes": lock_minutes, "min_age_days": min_age_days},
+        )
+        data = resp.get("data", [])
+        return [Robot(**r) for r in data]
+
+    async def update_auth_status(self, robot_id: str, auth_status: str) -> None:
+        await self.client.request(
+            "PATCH",
+            f"/robots/{robot_id}/auth-status",
+            json={"auth_status": auth_status},
+        )
+
+    async def update_security_hardened(self, robot_id: str, security_hardened: bool) -> None:
+        await self.client.request(
+            "PATCH",
+            f"/robots/{robot_id}/security-hardened",
+            json={"security_hardened": security_hardened},
+        )

robot_wrapper_sdk-0.2.5/robot_wrapper_sdk.egg-info/PKG-INFO

@@ -0,0 +1,171 @@
+Metadata-Version: 2.4
+Name: robot-wrapper-sdk
+Version: 0.2.5
+Summary: Robot Platform API SDK
+Author-email: GH Robot Platform Team <team@ghrobot.com>
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: httpx[socks]>=0.24.1
+
+# Robot Platform SDK (Python)
+
+Python SDK for Robot Platform with:
+- develop-app authentication (`app_id`/`app_secret`),
+- sync + async clients,
+- auto token refresh,
+- robot operations and login/hardening task flow.
+
+## Installation
+
+```bash
+pip install robot-wrapper-sdk
+```
+
+## Configuration
+
+Set environment variables (recommended):
+
+- `ROBOT_PLATFORM_BASE_URL`
+- `ROBOT_PLATFORM_APP_ID`
+- `ROBOT_PLATFORM_APP_SECRET`
+- `ROBOT_PLATFORM_PROXY_URL` (optional)
+
+Or pass values directly when creating the module.
+
+---
+
+## Quick Start (Sync)
+
+```python
+from robot_sdk import RobotPlatformModule
+
+sdk = RobotPlatformModule(
+    base_url="http://localhost:8085",
+    app_id="your_app_id",
+    app_secret="your_app_secret",
+    # proxy_url="socks5h://192.168.3.100:1080",  # optional
+)
+
+# Read robot
+robot = sdk.get_robot("2047631542552334336")
+print(robot.platform if robot else "not found")
+
+# Update lifecycle status
+sdk.update_status("2047631542552334336", "live")
+
+# Acquire login tasks
+login_tasks = sdk.acquire_need_login(limit=20, lock_minutes=30)
+
+# Update auth status after worker result
+sdk.update_auth_status("2047631542552334336", "authorized")
+# allowed values: authorized | unauthorized | logged_out
+
+# Acquire hardening tasks
+hardening_tasks = sdk.acquire_unhardened(limit=20, lock_minutes=30, min_age_days=0)
+
+# Update hardening status after worker result
+sdk.update_security_hardened("2047631542552334336", True)
+
+sdk.close()
+```
+
+## Quick Start (Async)
+
+```python
+import asyncio
+from robot_sdk import AsyncRobotPlatformModule
+
+async def main():
+    sdk = AsyncRobotPlatformModule(
+        base_url="http://localhost:8085",
+        app_id="your_app_id",
+        app_secret="your_app_secret",
+    )
+
+    robot = await sdk.get_robot("2047631542552334336")
+    print(robot.platform if robot else "not found")
+
+    await sdk.update_auth_status("2047631542552334336", "authorized")
+    await sdk.update_security_hardened("2047631542552334336", True)
+
+    await sdk.close()
+
+asyncio.run(main())
+```
+
+---
+
+## Response Shape (Placeholder)
+
+Acquire endpoints return:
+
+```json
+{
+  "status": "success",
+  "code": 200,
+  "message": "OK",
+  "data": [
+    {
+      "id": "2047631542552334336",
+      "username": "example_user_1",
+      "platform": "facebook",
+      "status": "live",
+      "auth_status": "unauthorized",
+      "metadata": {
+        "security_hardened": false
+      }
+    }
+  ]
+}
+```
+
+Update endpoints return:
+
+```json
+{
+  "status": "success",
+  "code": 200,
+  "message": "OK",
+  "data": null
+}
+```
+
+---
+
+## Main API
+
+### `RobotPlatformModule` (sync)
+- `list_robots(platform=None, status=None, project_id=None, page=1, limit=20)`
+- `get_robot(robot_id)`
+- `delete_robot(robot_id)`
+- `get_secrets(robot_id)`
+- `update_status(robot_id, status)`
+- `acquire_need_login(limit=20, lock_minutes=30)`
+- `acquire_unhardened(limit=20, lock_minutes=30, min_age_days=0)`
+- `update_auth_status(robot_id, auth_status)`
+- `update_security_hardened(robot_id, security_hardened)`
+- `close()`
+
+### `AsyncRobotPlatformModule` (async)
+Async equivalents of all methods above, plus `await close()`.
+
+---
+
+## Documentation
+
+- Usage guide: [`docs/guide.md`](docs/guide.md)
+- Package code: `robot_sdk/`
+
+---
+
+## Build & Publish (Maintainers)
+
+```bash
+make venv
+make install
+make build
+make publish
+```
+
+Requires valid PyPI credentials (Twine).

robot_wrapper_sdk-0.2.4/PKG-INFO

@@ -1,104 +0,0 @@
-Metadata-Version: 2.4
-Name: robot-wrapper-sdk
-Version: 0.2.4
-Summary: Robot Platform API SDK
-Author-email: GH Robot Platform Team <team@ghrobot.com>
-License: MIT
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-Requires-Dist: httpx[socks]>=0.24.1
-
-# Robot Platform SDK (Python)
-
-**Robot Platform** provides a clean‑architecture, DDD‑compliant Python SDK for interacting with the robot management backend. The SDK ships with both synchronous and asynchronous clients, automatic authentication, and token‑refresh middleware.
-
----
-
-## 📦 Installation
-```sh
-pip install robot-wrapper-sdk
-```
-
----
-
-## 🚀 Quick start
-```python
-from robot_sdk import RobotPlatformModule
-
-# Auto‑configuration via environment variables (recommended)
-#   ROBOT_PLATFORM_BASE_URL
-#   ROBOT_PLATFORM_APP_ID
-#   ROBOT_PLATFORM_APP_SECRET
-#   ROBOT_PLATFORM_PROXY_URL (optional: socks5h://..., http://...)
-
-sdk = RobotPlatformModule()  # reads env vars automatically
-
-# Or manual configuration with proxy support
-sdk = RobotPlatformModule(
-    base_url="https://api.example.com",
-    app_id="...",
-    app_secret="...",
-    proxy_url="socks5h://192.168.3.100:1080"
-)
-
-# Synchronous call example
-robot = sdk.robot_usecase.get_robot_profile("2029943774539935744")
-print(robot.platform)
-
-# Asynchronous call example
-import asyncio
-
-async def async_demo():
-    async_sdk = await RobotPlatformModule.async_init()
-    robot = await async_sdk.robot_usecase.get_robot_profile_async("2029943774539935744")
-    print(robot.platform)
-
-asyncio.run(async_demo())
-```
-
----
-
-## 📚 Documentation
-The full API reference and usage guide live in the repository:
-- **Guide**: [`docs/guide.md`](docs/guide.md) – step‑by‑step walkthrough of all use‑cases.
-- **API reference** is generated from type‑hints and can be inspected via `help(RobotPlatformModule)`.
-
----
-
-## 💡 Examples
-The `examples/` directory contains ready‑to‑run scripts that demonstrate common scenarios:
-- [`examples/auth_flow.py`](examples/auth_flow.py) – login, token refresh, and error handling.
-- [`examples/robot_profile.py`](examples/robot_profile.py) – fetch robot details synchronously.
-- [`examples/async_robot_profile.py`](examples/async_robot_profile.py) – the same operation with `asyncio`.
-
-Run any example directly:
-```sh
-python examples/robot_profile.py
-```
-
----
-
-## 🛠️ Build & publish (maintainer guide)
-```sh
-# Create a clean virtual environment
-make venv
-
-# Install build tools
-make install
-
-# Build source and wheel distributions
-make build
-
-# Publish to PyPI (requires twine and valid credentials)
-make publish
-```
-The `Makefile` lives in the SDK root and abstracts the above commands.
-
----
-
-## 📄 License
-MIT License – see the bundled `LICENSE` file.
-
----
-
-*This README is rendered on PyPI, so all relative links (`docs/`, `examples/`) resolve to the files shipped in the source distribution, allowing developers to browse the documentation and example code directly from the package page.*

robot_wrapper_sdk-0.2.4/README.md

@@ -1,94 +0,0 @@
-# Robot Platform SDK (Python)
-
-**Robot Platform** provides a clean‑architecture, DDD‑compliant Python SDK for interacting with the robot management backend. The SDK ships with both synchronous and asynchronous clients, automatic authentication, and token‑refresh middleware.
-
----
-
-## 📦 Installation
-```sh
-pip install robot-wrapper-sdk
-```
-
----
-
-## 🚀 Quick start
-```python
-from robot_sdk import RobotPlatformModule
-
-# Auto‑configuration via environment variables (recommended)
-#   ROBOT_PLATFORM_BASE_URL
-#   ROBOT_PLATFORM_APP_ID
-#   ROBOT_PLATFORM_APP_SECRET
-#   ROBOT_PLATFORM_PROXY_URL (optional: socks5h://..., http://...)
-
-sdk = RobotPlatformModule()  # reads env vars automatically
-
-# Or manual configuration with proxy support
-sdk = RobotPlatformModule(
-    base_url="https://api.example.com",
-    app_id="...",
-    app_secret="...",
-    proxy_url="socks5h://192.168.3.100:1080"
-)
-
-# Synchronous call example
-robot = sdk.robot_usecase.get_robot_profile("2029943774539935744")
-print(robot.platform)
-
-# Asynchronous call example
-import asyncio
-
-async def async_demo():
-    async_sdk = await RobotPlatformModule.async_init()
-    robot = await async_sdk.robot_usecase.get_robot_profile_async("2029943774539935744")
-    print(robot.platform)
-
-asyncio.run(async_demo())
-```
-
----
-
-## 📚 Documentation
-The full API reference and usage guide live in the repository:
-- **Guide**: [`docs/guide.md`](docs/guide.md) – step‑by‑step walkthrough of all use‑cases.
-- **API reference** is generated from type‑hints and can be inspected via `help(RobotPlatformModule)`.
-
----
-
-## 💡 Examples
-The `examples/` directory contains ready‑to‑run scripts that demonstrate common scenarios:
-- [`examples/auth_flow.py`](examples/auth_flow.py) – login, token refresh, and error handling.
-- [`examples/robot_profile.py`](examples/robot_profile.py) – fetch robot details synchronously.
-- [`examples/async_robot_profile.py`](examples/async_robot_profile.py) – the same operation with `asyncio`.
-
-Run any example directly:
-```sh
-python examples/robot_profile.py
-```
-
----
-
-## 🛠️ Build & publish (maintainer guide)
-```sh
-# Create a clean virtual environment
-make venv
-
-# Install build tools
-make install
-
-# Build source and wheel distributions
-make build
-
-# Publish to PyPI (requires twine and valid credentials)
-make publish
-```
-The `Makefile` lives in the SDK root and abstracts the above commands.
-
----
-
-## 📄 License
-MIT License – see the bundled `LICENSE` file.
-
----
-
-*This README is rendered on PyPI, so all relative links (`docs/`, `examples/`) resolve to the files shipped in the source distribution, allowing developers to browse the documentation and example code directly from the package page.*

robot_wrapper_sdk-0.2.4/robot_wrapper_sdk.egg-info/PKG-INFO

@@ -1,104 +0,0 @@
-Metadata-Version: 2.4
-Name: robot-wrapper-sdk
-Version: 0.2.4
-Summary: Robot Platform API SDK
-Author-email: GH Robot Platform Team <team@ghrobot.com>
-License: MIT
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-Requires-Dist: httpx[socks]>=0.24.1
-
-# Robot Platform SDK (Python)
-
-**Robot Platform** provides a clean‑architecture, DDD‑compliant Python SDK for interacting with the robot management backend. The SDK ships with both synchronous and asynchronous clients, automatic authentication, and token‑refresh middleware.
-
----
-
-## 📦 Installation
-```sh
-pip install robot-wrapper-sdk
-```
-
----
-
-## 🚀 Quick start
-```python
-from robot_sdk import RobotPlatformModule
-
-# Auto‑configuration via environment variables (recommended)
-#   ROBOT_PLATFORM_BASE_URL
-#   ROBOT_PLATFORM_APP_ID
-#   ROBOT_PLATFORM_APP_SECRET
-#   ROBOT_PLATFORM_PROXY_URL (optional: socks5h://..., http://...)
-
-sdk = RobotPlatformModule()  # reads env vars automatically
-
-# Or manual configuration with proxy support
-sdk = RobotPlatformModule(
-    base_url="https://api.example.com",
-    app_id="...",
-    app_secret="...",
-    proxy_url="socks5h://192.168.3.100:1080"
-)
-
-# Synchronous call example
-robot = sdk.robot_usecase.get_robot_profile("2029943774539935744")
-print(robot.platform)
-
-# Asynchronous call example
-import asyncio
-
-async def async_demo():
-    async_sdk = await RobotPlatformModule.async_init()
-    robot = await async_sdk.robot_usecase.get_robot_profile_async("2029943774539935744")
-    print(robot.platform)
-
-asyncio.run(async_demo())
-```
-
----
-
-## 📚 Documentation
-The full API reference and usage guide live in the repository:
-- **Guide**: [`docs/guide.md`](docs/guide.md) – step‑by‑step walkthrough of all use‑cases.
-- **API reference** is generated from type‑hints and can be inspected via `help(RobotPlatformModule)`.
-
----
-
-## 💡 Examples
-The `examples/` directory contains ready‑to‑run scripts that demonstrate common scenarios:
-- [`examples/auth_flow.py`](examples/auth_flow.py) – login, token refresh, and error handling.
-- [`examples/robot_profile.py`](examples/robot_profile.py) – fetch robot details synchronously.
-- [`examples/async_robot_profile.py`](examples/async_robot_profile.py) – the same operation with `asyncio`.
-
-Run any example directly:
-```sh
-python examples/robot_profile.py
-```
-
----
-
-## 🛠️ Build & publish (maintainer guide)
-```sh
-# Create a clean virtual environment
-make venv
-
-# Install build tools
-make install
-
-# Build source and wheel distributions
-make build
-
-# Publish to PyPI (requires twine and valid credentials)
-make publish
-```
-The `Makefile` lives in the SDK root and abstracts the above commands.
-
----
-
-## 📄 License
-MIT License – see the bundled `LICENSE` file.
-
----
-
-*This README is rendered on PyPI, so all relative links (`docs/`, `examples/`) resolve to the files shipped in the source distribution, allowing developers to browse the documentation and example code directly from the package page.*