proxyhubb 0.1.0__py3-none-any.whl

proxyhubb/__init__.py

@@ -0,0 +1,7 @@
+"""Official ProxyHubb Python SDK."""
+
+from proxyhubb.client import ProxyHubClient, DEFAULT_BASE_URL
+from proxyhubb.proxy import ProxyClient
+
+__all__ = ["ProxyHubClient", "ProxyClient", "DEFAULT_BASE_URL"]
+__version__ = "0.1.0"

proxyhubb/client.py

@@ -0,0 +1,106 @@
+"""ProxyHubb Python SDK — Bulk Proxy Pool Control API client."""
+
+from __future__ import annotations
+
+from typing import Any
+
+import requests
+
+DEFAULT_BASE_URL = "https://api.proxyhubb.com"
+
+
+class ProxyHubClient:
+    """Client for the ProxyHubb Bulk Proxy Pool API.
+
+    Parameters
+    ----------
+    api_key:
+        A ProxyHubb API key starting with ``phub_`` (or ``pk_``).
+    base_url:
+        Base URL of the Control API. Defaults to production.
+    """
+
+    def __init__(
+        self,
+        api_key: str,
+        base_url: str = DEFAULT_BASE_URL,
+    ) -> None:
+        if not api_key:
+            raise ValueError("api_key is required")
+        self._api_key = api_key
+        self._base_url = base_url.rstrip("/")
+        self._session = requests.Session()
+        self._session.headers.update({"X-API-Key": self._api_key})
+
+    def _url(self, path: str) -> str:
+        return f"{self._base_url}{path}"
+
+    def _get(self, path: str) -> dict[str, Any]:
+        resp = self._session.get(self._url(path))
+        resp.raise_for_status()
+        return resp.json()
+
+    def _post(self, path: str, payload: dict[str, Any]) -> dict[str, Any]:
+        resp = self._session.post(self._url(path), json=payload)
+        resp.raise_for_status()
+        return resp.json()
+
+    def _delete(self, path: str) -> None:
+        resp = self._session.delete(self._url(path))
+        resp.raise_for_status()
+
+    def create_pool(
+        self,
+        name: str,
+        size: int = 10,
+        session_type: str = "rotating",
+        description: str = "",
+        bytes_limit: int = 0,
+    ) -> dict[str, Any]:
+        """Create a new proxy pool."""
+        return self._post(
+            "/v1/bulk/pools",
+            {
+                "name": name,
+                "size": size,
+                "session_type": session_type,
+                "description": description,
+                "bytes_limit": bytes_limit,
+            },
+        )
+
+    def list_pools(self) -> dict[str, Any]:
+        """List proxy pools for the authenticated account."""
+        return self._get("/v1/bulk/pools")
+
+    def get_pool(self, pool_id: str) -> dict[str, Any]:
+        """Retrieve the endpoints of a proxy pool."""
+        return self._get(f"/v1/bulk/pools/{pool_id}/endpoints")
+
+    def get_proxies(self, pool_id: str) -> list[dict[str, Any]]:
+        """Return the list of endpoint dicts for a pool."""
+        data = self.get_pool(pool_id)
+        return data.get("endpoints", [])
+
+    def revoke_pool(self, pool_id: str) -> None:
+        """Soft-delete a proxy pool."""
+        self._delete(f"/v1/bulk/pools/{pool_id}")
+
+    def as_requests_proxy(self, pool_id: str, index: int = 0) -> dict[str, str]:
+        """Return a ``proxies`` dict compatible with the ``requests`` library.
+
+        Endpoint host/port come from the API (production buyer proxy is
+        ``proxy.proxyhubb.com:8090``).
+        """
+        endpoints = self.get_proxies(pool_id)
+        if not endpoints:
+            raise ValueError(f"Pool {pool_id!r} has no endpoints")
+        if index >= len(endpoints):
+            raise IndexError(
+                f"index {index} is out of range for pool with {len(endpoints)} endpoints"
+            )
+        ep = endpoints[index]
+        proxy_url = (
+            f"http://{ep['username']}:{ep['password']}@{ep['host']}:{ep['port']}"
+        )
+        return {"http": proxy_url, "https": proxy_url}

proxyhubb/proxy.py

@@ -0,0 +1,47 @@
+"""Gateway helper for routing HTTP via the ProxyHubb buyer proxy."""
+
+from __future__ import annotations
+
+import time
+import uuid
+from typing import Any, Optional
+
+import requests
+
+DEFAULT_GATEWAY = "http://proxy.proxyhubb.com:8090"
+
+
+class ProxyClient:
+    """Thin helper that builds ``requests``-compatible proxy URLs for the gateway.
+
+    Prefer :class:`proxyhubb.ProxyHubClient` to create pools and obtain credentials.
+    """
+
+    def __init__(
+        self,
+        gateway_url: str = DEFAULT_GATEWAY,
+        proxy_auth: Optional[str] = None,
+    ) -> None:
+        self.gateway_url = gateway_url
+        self.proxy_auth = proxy_auth
+        self.current_session_id = str(uuid.uuid4())
+        self.session_start = time.time()
+
+    def get_proxy_config(self, rotate: bool = False) -> dict[str, str]:
+        if rotate:
+            self.current_session_id = str(uuid.uuid4())
+            self.session_start = time.time()
+
+        auth_str = self.proxy_auth if self.proxy_auth else "anonymous"
+        host = self.gateway_url.split("//")[-1]
+        proxy_str = f"http://{auth_str}:{self.current_session_id}@{host}"
+        return {"http": proxy_str, "https": proxy_str}
+
+    def request(self, method: str, url: str, rotate: bool = False, **kwargs: Any):
+        proxies = self.get_proxy_config(rotate=rotate)
+        try:
+            return requests.request(method, url, proxies=proxies, **kwargs)
+        except Exception:
+            return requests.request(
+                method, url, proxies=self.get_proxy_config(rotate=True), **kwargs
+            )

proxyhubb-0.1.0.dist-info/METADATA

@@ -0,0 +1,54 @@
+Metadata-Version: 2.4
+Name: proxyhubb
+Version: 0.1.0
+Summary: Official Python SDK for the ProxyHubb Bulk Proxy Pool API
+Author: ProxyHubb
+License: MIT
+Project-URL: Homepage, https://proxyhubb.com
+Project-URL: Repository, https://github.com/proxyhubb/proxyhubb
+Project-URL: Issues, https://github.com/proxyhubb/proxyhubb/issues
+Keywords: proxyhubb,proxy,sdk,api
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.31.0
+Requires-Dist: urllib3>=2.0.0
+Dynamic: license-file
+
+# proxyhubb
+
+Official Python client for the ProxyHubb Bulk Proxy Pool API.
+
+## Install
+
+```bash
+pip install proxyhubb
+```
+
+## Usage
+
+```python
+from proxyhubb import ProxyHubClient
+
+client = ProxyHubClient("phub_...")  # default: https://api.proxyhubb.com
+pool = client.create_pool("scrapers", size=5)
+proxies = client.as_requests_proxy(pool["id"])
+```
+
+Create an API key in the dashboard (`phub_…`).
+
+Gateway helper (optional):
+
+```python
+from proxyhubb import ProxyClient
+
+gw = ProxyClient(proxy_auth="user:pass")
+resp = gw.request("GET", "https://api.ipify.org")
+```
+
+## License
+
+MIT

proxyhubb-0.1.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+proxyhubb/__init__.py,sha256=L_QeDYNF0wQSbW_GIJxxAYFzUeLd97p3Haz_wuyGEmI,227
+proxyhubb/client.py,sha256=YMPbe-ZG6TH2C_MWP_KWH4oS26cf5bKQUpUuX-VBKho,3402
+proxyhubb/proxy.py,sha256=10kAgSl8CLvgshXa9-eW3ORq6N9JsNsxFhS9ZzQSP5U,1563
+proxyhubb-0.1.0.dist-info/licenses/LICENSE,sha256=RWizfvLDLh8xaESHQTymcdJFj54ZxbVn9keRWk-kvvs,1066
+proxyhubb-0.1.0.dist-info/METADATA,sha256=_8PIjlupQRk-AlKJ4WjZmsV39G9dMfra9KWo_qGygWw,1265
+proxyhubb-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+proxyhubb-0.1.0.dist-info/top_level.txt,sha256=eVFMxnGN3Ya8BD2GrnHppVOLbqbceZ0z6hXl5jApYNI,10
+proxyhubb-0.1.0.dist-info/RECORD,,

proxyhubb-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

proxyhubb-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ProxyHubb
+
+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.

proxyhubb-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+proxyhubb