nonecap 0.8.2__tar.gz → 0.8.4__tar.gz

{nonecap-0.8.2 → nonecap-0.8.4}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.5
 Name: nonecap
-Version: 0.8.2
-Summary: Official Python client for the NoneCap hCaptcha solving API.
-Project-URL: Homepage, https://nonecap.com
+Version: 0.8.4
+Summary: Official Python client for NoneCap, the hCaptcha solver API.
+Project-URL: Homepage, https://nonecap.com/
 Project-URL: Documentation, https://nonecap.com/api-reference
 Project-URL: Repository, https://github.com/nonecap/nonecap-py
 Project-URL: Issues, https://github.com/nonecap/nonecap-py/issues
@@ -38,7 +38,7 @@ Description-Content-Type: text/markdown
   <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a>
 </p>
 
-<p align="center">Official Python client for the <a href="https://nonecap.com">NoneCap</a> hCaptcha solving API.</p>
+<p align="center">Official Python client for the NoneCap <a href="https://nonecap.com/">hCaptcha solver</a> API.</p>
 
 Submit a captcha, get back a token. The client handles the polling, the timeouts, and the error cases so you don't write the request loop yourself. Sync and async, fully typed.
 
@@ -171,7 +171,7 @@ except RateLimitError as err:
     time.sleep(err.retry_after or 1)
 ```
 
-The subclasses are `AuthenticationError` (401), `PermissionDeniedError` (403), `InsufficientCreditsError` (402, with `KeyCreditLimitError` when one API key hit its own cap), `ValidationError` (422/400, with a `param` naming the bad field; `PayloadTooLargeError` for 413 and `UnsupportedMediaTypeError` for 415), `NotFoundError` (404), `ConflictError` (409), `RateLimitError` (429, with `ConcurrencyLimitError`, `SitekeyRateLimitedError` and `ProxyUnavailableError` (your own proxy is refusing connections) telling them apart; `retry_after` is the seconds the API asked you to wait), `APIError` (5xx, with `ServiceUnavailableError` for a maintenance pause), `APIConnectionError` and `APITimeoutError` (the request never landed), and `SolveTimeoutError` (your `solve()` budget ran out). Every error from a response carries `request_id`, the id to quote to support.
+The subclasses are `AuthenticationError` (401), `PermissionDeniedError` (403), `InsufficientCreditsError` (402, with `KeyCreditLimitError` when one API key hit its own cap), `ValidationError` (422/400, with a `param` naming the bad field; `PayloadTooLargeError` for 413 and `UnsupportedMediaTypeError` for 415), `NotFoundError` (404), `ConflictError` (409), `RateLimitError` (429, with `ConcurrencyLimitError`, `SitekeyRateLimitedError`, `ProxyUnavailableError` (your own proxy is refusing connections) and `RateCappedError` (your account reached its submit rate cap on this sitekey) telling them apart; `retry_after` is the seconds the API asked you to wait), `APIError` (5xx, with `ServiceUnavailableError` for a maintenance pause), `APIConnectionError` and `APITimeoutError` (the request never landed), and `SolveTimeoutError` (your `solve()` budget ran out). Every error from a response carries `request_id`, the id to quote to support.
 
 `SolveFailedError` carries the full `solve`. `solve.error.code` is a `SolveErrorCode`, `solve.error.reason` a typed sub-reason or `None` (`proxy_rejected`, `sitekey_rate_limited`, …), and `solve.error.retryable` says whether resubmitting the same request unchanged can succeed; `err.retryable`, `err.reason` and `err.solve_code` are shortcuts to those fields. Failed solves are never charged.
 

{nonecap-0.8.2 → nonecap-0.8.4}/README.md

@@ -7,7 +7,7 @@
   <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a>
 </p>
 
-<p align="center">Official Python client for the <a href="https://nonecap.com">NoneCap</a> hCaptcha solving API.</p>
+<p align="center">Official Python client for the NoneCap <a href="https://nonecap.com/">hCaptcha solver</a> API.</p>
 
 Submit a captcha, get back a token. The client handles the polling, the timeouts, and the error cases so you don't write the request loop yourself. Sync and async, fully typed.
 
@@ -140,7 +140,7 @@ except RateLimitError as err:
     time.sleep(err.retry_after or 1)
 ```
 
-The subclasses are `AuthenticationError` (401), `PermissionDeniedError` (403), `InsufficientCreditsError` (402, with `KeyCreditLimitError` when one API key hit its own cap), `ValidationError` (422/400, with a `param` naming the bad field; `PayloadTooLargeError` for 413 and `UnsupportedMediaTypeError` for 415), `NotFoundError` (404), `ConflictError` (409), `RateLimitError` (429, with `ConcurrencyLimitError`, `SitekeyRateLimitedError` and `ProxyUnavailableError` (your own proxy is refusing connections) telling them apart; `retry_after` is the seconds the API asked you to wait), `APIError` (5xx, with `ServiceUnavailableError` for a maintenance pause), `APIConnectionError` and `APITimeoutError` (the request never landed), and `SolveTimeoutError` (your `solve()` budget ran out). Every error from a response carries `request_id`, the id to quote to support.
+The subclasses are `AuthenticationError` (401), `PermissionDeniedError` (403), `InsufficientCreditsError` (402, with `KeyCreditLimitError` when one API key hit its own cap), `ValidationError` (422/400, with a `param` naming the bad field; `PayloadTooLargeError` for 413 and `UnsupportedMediaTypeError` for 415), `NotFoundError` (404), `ConflictError` (409), `RateLimitError` (429, with `ConcurrencyLimitError`, `SitekeyRateLimitedError`, `ProxyUnavailableError` (your own proxy is refusing connections) and `RateCappedError` (your account reached its submit rate cap on this sitekey) telling them apart; `retry_after` is the seconds the API asked you to wait), `APIError` (5xx, with `ServiceUnavailableError` for a maintenance pause), `APIConnectionError` and `APITimeoutError` (the request never landed), and `SolveTimeoutError` (your `solve()` budget ran out). Every error from a response carries `request_id`, the id to quote to support.
 
 `SolveFailedError` carries the full `solve`. `solve.error.code` is a `SolveErrorCode`, `solve.error.reason` a typed sub-reason or `None` (`proxy_rejected`, `sitekey_rate_limited`, …), and `solve.error.retryable` says whether resubmitting the same request unchanged can succeed; `err.retryable`, `err.reason` and `err.solve_code` are shortcuts to those fields. Failed solves are never charged.
 

{nonecap-0.8.2 → nonecap-0.8.4}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "hatchling.build"
 [project]
 name = "nonecap"
 dynamic = ["version"]
-description = "Official Python client for the NoneCap hCaptcha solving API."
+description = "Official Python client for NoneCap, the hCaptcha solver API."
 readme = "README.md"
 license = "MIT"
 license-files = ["LICENSE"]
@@ -35,7 +35,7 @@ classifiers = [
 ]
 
 [project.urls]
-Homepage = "https://nonecap.com"
+Homepage = "https://nonecap.com/"
 Documentation = "https://nonecap.com/api-reference"
 Repository = "https://github.com/nonecap/nonecap-py"
 Issues = "https://github.com/nonecap/nonecap-py/issues"

{nonecap-0.8.2 → nonecap-0.8.4}/src/nonecap/__init__.py

@@ -28,6 +28,7 @@ from ._errors import (
     PayloadTooLargeError,
     PermissionDeniedError,
     ProxyUnavailableError,
+    RateCappedError,
     RateLimitError,
     ServiceUnavailableError,
     SitekeyRateLimitedError,
@@ -99,6 +100,7 @@ __all__ = [
     "ConcurrencyLimitError",
     "SitekeyRateLimitedError",
     "ProxyUnavailableError",
+    "RateCappedError",
     "APIError",
     "ServiceUnavailableError",
     "APIConnectionError",

{nonecap-0.8.2 → nonecap-0.8.4}/src/nonecap/_errors.py

@@ -91,6 +91,11 @@ class ProxyUnavailableError(RateLimitError):
     exit; ``retry_after`` says when the next submit is let through to re-check it."""
 
 
+class RateCappedError(RateLimitError):
+    """429 — your account has a submit rate cap on this sitekey and reached it for the
+    trailing minute. Nothing was charged; wait ``retry_after`` seconds."""
+
+
 class APIError(NoneCapError):
     """5xx, or a response that was not the expected shape. ``request_id`` is the id to quote."""
 
@@ -192,6 +197,8 @@ def error_from_response(
         cls = SitekeyRateLimitedError
     elif code == "proxy_unavailable":
         cls = ProxyUnavailableError
+    elif code == "rate_capped":
+        cls = RateCappedError
     elif code in ("rate_limited", "ext_daily_limit"):
         cls = RateLimitError
     elif code == "maintenance":

{nonecap-0.8.2 → nonecap-0.8.4}/src/nonecap/_types.py

@@ -62,6 +62,7 @@ SolveErrorReason = Literal[
     "browser_lane_capped",
     "recaptcha_not_loaded",
     "refused_wording_unescaped",
+    "session_capped",
 ]
 """A typed sub-reason within :data:`SolveErrorCode`, set when the solver knows more
 than the code says."""

nonecap-0.8.4/src/nonecap/_version.py

@@ -0,0 +1 @@
+__version__ = "0.8.4"

{nonecap-0.8.2 → nonecap-0.8.4}/tests/test_client.py

@@ -17,6 +17,7 @@ from nonecap import (
     PayloadTooLargeError,
     PermissionDeniedError,
     ProxyUnavailableError,
+    RateCappedError,
     RateLimitError,
     ServiceUnavailableError,
     SitekeyRateLimitedError,
@@ -206,6 +207,8 @@ class TestErrorMapping:
             (429, "sitekey_rate_limited", SitekeyRateLimitedError),
             (429, "proxy_unavailable", ProxyUnavailableError),
             (429, "proxy_unavailable", RateLimitError),
+            (429, "rate_capped", RateCappedError),
+            (429, "rate_capped", RateLimitError),
             (429, "rate_limited", RateLimitError),
             (409, "conflict", ConflictError),
             (404, "not_found", NotFoundError),
@@ -245,6 +248,29 @@ class TestErrorMapping:
         assert info.value.retry_after == 15
         assert info.value.request_id == "req_1"
 
+    def test_rate_capped_carries_the_retry_after_delay(self) -> None:
+        def responder(request: httpx.Request) -> httpx.Response:
+            return httpx.Response(
+                429,
+                json={
+                    "error": {
+                        "code": "rate_capped",
+                        "message": "capped",
+                        "param": None,
+                        "request_id": "req_3",
+                    }
+                },
+                headers={"Retry-After": "7"},
+            )
+
+        nc = client_for(Script(responder))
+        with pytest.raises(RateCappedError) as info:
+            nc.me()
+        assert isinstance(info.value, RateLimitError)
+        assert info.value.code == "rate_capped"
+        assert info.value.retry_after == 7
+        assert info.value.request_id == "req_3"
+
     def test_request_id_falls_back_to_the_header(self) -> None:
         def responder(request: httpx.Request) -> httpx.Response:
             return httpx.Response(
@@ -313,6 +339,7 @@ class TestErrorMapping:
             ("internal_error", "type_not_served", False),
             ("challenge_not_loaded", "recaptcha_not_loaded", False),
             ("token_not_granted", "refused_wording_unescaped", True),
+            ("capacity_exhausted", "session_capped", True),
         ],
     )
     def test_uncharged_capacity_and_type_reasons_are_typed(

{nonecap-0.8.2 → nonecap-0.8.4}/tests/typing_assertions.py

@@ -94,6 +94,7 @@ def egress_blocked_reasons() -> None:
     _r5: SolveErrorReason = "browser_lane_capped"
     _r6: SolveErrorReason = "recaptcha_not_loaded"
     _r7: SolveErrorReason = "refused_wording_unescaped"
+    _r8: SolveErrorReason = "session_capped"
     # A reason the API never defined must not type-check.
     _bad: SolveErrorReason = "proxy_egress_blockd"  # type: ignore[assignment]
 

nonecap-0.8.2/src/nonecap/_version.py

@@ -1 +0,0 @@
-__version__ = "0.8.2"