thordata-sdk 1.3.0__py3-none-any.whl → 1.4.0__py3-none-any.whl

thordata/demo.py

@@ -25,9 +25,9 @@ from pathlib import Path
 def _configure_stdio() -> None:
     # Avoid UnicodeEncodeError on Windows consoles with legacy encodings.
     if hasattr(sys.stdout, "reconfigure"):
-        sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+        sys.stdout.reconfigure(encoding="utf-8", errors="replace")  # type: ignore[attr-defined]
     if hasattr(sys.stderr, "reconfigure"):
-        sys.stderr.reconfigure(encoding="utf-8", errors="replace")
+        sys.stderr.reconfigure(encoding="utf-8", errors="replace")  # type: ignore[attr-defined]
 
 
 def _load_env() -> None:

thordata/unlimited.py

@@ -0,0 +1,102 @@
+"""
+Sync interface for Unlimited Residential Proxy management.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any
+
+from ._utils import build_public_api_headers
+from .exceptions import raise_for_code
+
+if TYPE_CHECKING:
+    from .client import ThordataClient
+
+
+class UnlimitedNamespace:
+    """
+    Namespace for Unlimited Residential Proxy operations.
+    """
+
+    def __init__(self, client: ThordataClient):
+        self._client = client
+        # Base URL for unlimited endpoints (usually same as public API base)
+        # We can reuse _locations_base_url logic to find the API root
+        # locations_base: .../api/locations -> root: .../api
+        self._api_base = client._locations_base_url.replace("/locations", "")
+
+    def list_servers(self) -> list[dict[str, Any]]:
+        """
+        Get the list of unlimited proxy servers.
+
+        Returns:
+            List of server objects.
+        """
+        self._client._require_public_credentials()
+        params = {
+            "token": self._client.public_token,
+            "key": self._client.public_key,
+        }
+        response = self._client._api_request_with_retry(
+            "GET", f"{self._api_base}/unlimited/server-list", params=params
+        )
+        response.raise_for_status()
+        data = response.json()
+        if data.get("code") != 200:
+            raise_for_code("List servers failed", code=data.get("code"), payload=data)
+
+        # API returns { "data": [...] } OR { "data": { "list": [...] } } sometimes
+        # Assuming standard list return
+        return data.get("data") or []
+
+    def restart_server(self, plan_name: str) -> dict[str, Any]:
+        """Restart an unlimited proxy server."""
+        return self._post_action("/unlimited/restart-server", {"plan_name": plan_name})
+
+    def renew(self, plan_name: str, month: int) -> dict[str, Any]:
+        """Renew an unlimited plan."""
+        return self._post_action(
+            "/unlimited/renew", {"plan_name": plan_name, "month": str(month)}
+        )
+
+    def upgrade(self, plan_name: str, target_plan: str) -> dict[str, Any]:
+        """Upgrade an unlimited plan."""
+        return self._post_action(
+            "/unlimited/upgrade",
+            {"plan_name": plan_name, "target_plan": target_plan},
+        )
+
+    def list_bound_users(self, ip: str) -> list[dict[str, Any]]:
+        """List users bound to a specific unlimited server IP."""
+        data = self._post_action("/get_unlimited_servers_bind_user", {"ip": ip})
+        # Assuming data structure similar to other lists
+        return data.get("list") or [] if isinstance(data, dict) else []
+
+    def bind_user(self, ip: str, username: str) -> dict[str, Any]:
+        """Bind a sub-user to an unlimited server IP."""
+        return self._post_action(
+            "/add_unlimited_servers_bind_user", {"ip": ip, "username": username}
+        )
+
+    def unbind_user(self, ip: str, username: str) -> dict[str, Any]:
+        """Unbind a sub-user from an unlimited server IP."""
+        return self._post_action(
+            "/del_unlimited_servers_bind_user", {"ip": ip, "username": username}
+        )
+
+    def _post_action(self, endpoint: str, payload: dict[str, Any]) -> dict[str, Any]:
+        """Helper for POST actions."""
+        self._client._require_public_credentials()
+        headers = build_public_api_headers(
+            self._client.public_token or "", self._client.public_key or ""
+        )
+        response = self._client._api_request_with_retry(
+            "POST", f"{self._api_base}{endpoint}", data=payload, headers=headers
+        )
+        response.raise_for_status()
+        data = response.json()
+        if data.get("code") != 200:
+            raise_for_code(
+                f"Action {endpoint} failed", code=data.get("code"), payload=data
+            )
+        return data.get("data", {})

{thordata_sdk-1.3.0.dist-info → thordata_sdk-1.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: thordata-sdk
-Version: 1.3.0
+Version: 1.4.0
 Summary: The Official Python SDK for Thordata - AI Data Infrastructure & Proxy Network.
 Author-email: Thordata Developer Team <support@thordata.com>
 License: MIT
@@ -35,7 +35,7 @@ Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
 Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
 Requires-Dist: pytest-httpserver>=1.0.0; extra == "dev"
 Requires-Dist: python-dotenv>=1.0.0; extra == "dev"
-Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: black>=25.11.0; extra == "dev"
 Requires-Dist: ruff>=0.1.0; extra == "dev"
 Requires-Dist: mypy>=1.0.0; extra == "dev"
 Requires-Dist: types-requests>=2.28.0; extra == "dev"

thordata_sdk-1.4.0.dist-info/RECORD

@@ -0,0 +1,18 @@
+thordata/__init__.py,sha256=WVs3pZALETqLZDoAWyUoYNEjTAtC9FPvBxJEvDHnu04,3195
+thordata/_example_utils.py,sha256=T9QtVq9BHhubOShgtGp2GSusYYd-ZFUJFJAw7ubIsa4,2199
+thordata/_utils.py,sha256=Acr_6sHgdZXU7SQozd6FEYTZV6iHw__nlhpBTDwb66U,4917
+thordata/async_client.py,sha256=U6VgjsaX3-dzaIwEHtPborwYVrw-K1flTLg9LP9Xozk,80378
+thordata/async_unlimited.py,sha256=kzTksFkN21rDM21Pwy3hcayjfyGYNGGyGR3fRLtZC6I,4510
+thordata/client.py,sha256=79XzN4VxyY9EgYSYi5FhicHzo7ASGLb4hoEWig0nT7w,84500
+thordata/demo.py,sha256=DojJRFqUm9XAMBkjmk03WGeiUdLCbXguMIwtMOzfN6M,3822
+thordata/enums.py,sha256=MpZnS9_8sg2vtcFqM6UicB94cKZm5R1t83L3ejNSbLs,8502
+thordata/exceptions.py,sha256=P9czrxkFhT439DxW3LE5W-koS595ObH4-mAQOfaDM18,9976
+thordata/models.py,sha256=qtB7jE0v5zNEQfSpmOqdiacB5DgM2QfVR2PaYs-DisM,38206
+thordata/retry.py,sha256=5kRwULl3X68Nx8PlSzr9benfyCL0nRSpVQXrwjWr45M,11456
+thordata/serp_engines.py,sha256=iuMWncelcGOskCHXFzpcPMMTL5qfiLkazHB1uj3zpZo,5985
+thordata/unlimited.py,sha256=U0MEHeowNe6js8aezPFD8vGOft0VA8cpL-TUsLNyv2k,3855
+thordata_sdk-1.4.0.dist-info/licenses/LICENSE,sha256=bAxpWgQIzb-5jl3nhLdOwOJ_vlbHLtSG7yev2B7vioY,1088
+thordata_sdk-1.4.0.dist-info/METADATA,sha256=RJvTjs-N-ZaI7X9KfBI1ST5lcNTCeNpTZ92Cz7Ky9wk,6601
+thordata_sdk-1.4.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+thordata_sdk-1.4.0.dist-info/top_level.txt,sha256=Z8R_07m0lXCCSb1hapL9_nxMtyO3rf_9wOvq4n9u2Hg,9
+thordata_sdk-1.4.0.dist-info/RECORD,,

thordata_sdk-1.3.0.dist-info/RECORD

@@ -1,16 +0,0 @@
-thordata/__init__.py,sha256=O9R2zY6qQXWIkQQ8Hcqqcwshymk4-2Bo_Pmm-Ma3SeI,3195
-thordata/_example_utils.py,sha256=T9QtVq9BHhubOShgtGp2GSusYYd-ZFUJFJAw7ubIsa4,2199
-thordata/_utils.py,sha256=Acr_6sHgdZXU7SQozd6FEYTZV6iHw__nlhpBTDwb66U,4917
-thordata/async_client.py,sha256=9swh6AoAgvLRavFzXaM1rUz9Zm66r7GKjThjfILLiSI,58082
-thordata/client.py,sha256=IvkPjm4v9ViiNMUM4uUbUOY3kNtJdw3mzSd3BT3yD0A,59039
-thordata/demo.py,sha256=HQzgaUM33bWD7mBQ6HEkK5K6zqFnSAHLvaam6BwPgFA,3762
-thordata/enums.py,sha256=MpZnS9_8sg2vtcFqM6UicB94cKZm5R1t83L3ejNSbLs,8502
-thordata/exceptions.py,sha256=P9czrxkFhT439DxW3LE5W-koS595ObH4-mAQOfaDM18,9976
-thordata/models.py,sha256=qtB7jE0v5zNEQfSpmOqdiacB5DgM2QfVR2PaYs-DisM,38206
-thordata/retry.py,sha256=5kRwULl3X68Nx8PlSzr9benfyCL0nRSpVQXrwjWr45M,11456
-thordata/serp_engines.py,sha256=iuMWncelcGOskCHXFzpcPMMTL5qfiLkazHB1uj3zpZo,5985
-thordata_sdk-1.3.0.dist-info/licenses/LICENSE,sha256=bAxpWgQIzb-5jl3nhLdOwOJ_vlbHLtSG7yev2B7vioY,1088
-thordata_sdk-1.3.0.dist-info/METADATA,sha256=x7p4JY94WCbvVmLiSaPDcUiKKiSw_4bRn3sLr1PRBPM,6600
-thordata_sdk-1.3.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-thordata_sdk-1.3.0.dist-info/top_level.txt,sha256=Z8R_07m0lXCCSb1hapL9_nxMtyO3rf_9wOvq4n9u2Hg,9
-thordata_sdk-1.3.0.dist-info/RECORD,,