pyreqwest 0.9.0__cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl → 0.10.1__cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl

pyreqwest/client/__init__.py

@@ -5,7 +5,6 @@ from pyreqwest._pyreqwest.client import (
     BaseClientBuilder,
     Client,
     ClientBuilder,
-    Runtime,
     SyncClient,
     SyncClientBuilder,
 )
@@ -17,5 +16,4 @@ __all__ = [
     "BaseClient",
     "Client",
     "SyncClient",
-    "Runtime",
 ]

pyreqwest/client/__init__.pyi

@@ -103,13 +103,18 @@ class BaseClientBuilder:
     def base_url(self, url: Url | str) -> Self:
         """Set a base URL automatically prepended to relative request URLs."""
 
-    def runtime(self, runtime: "Runtime") -> Self:
-        """Use a custom runtime (advanced scenarios). Usually not needed. By default, a global runtime is used."""
+    def runtime_multithreaded(self, enable: bool) -> Self:
+        """Use multithreaded Tokio runtime for client. Default is single-threaded or as configured globally via
+        `pyreqwest.runtime` module.
+
+        Multithreaded runtime may improve performance for high concurrency workloads with complex requests.
+        See also `pyreqwest.runtime` module for configuring global multithreaded runtime behavior.
+        """
 
     def max_connections(self, max_connections: int | None) -> Self:
         """Maximum number of inflight requests. None means no limit. Default is None."""
 
-    def error_for_status(self, enable: bool) -> Self:
+    def error_for_status(self, enable: bool = True) -> Self:
         """Enable automatic HTTP error raising (4xx/5xx)."""
 
     def user_agent(self, value: str) -> Self:
@@ -205,9 +210,6 @@ class BaseClientBuilder:
         Newline codepoints will be transformed to spaces when parsing.
         """
 
-    def http1(self, enabled: bool) -> Self:
-        """Enable or disable HTTP/1 support. Default is true."""
-
     def http1_only(self) -> Self:
         """Only use HTTP/1. This is the default. This is consistent with reqwest opt-in http2 feature.
 
@@ -223,8 +225,7 @@ class BaseClientBuilder:
     def http2_prior_knowledge(self) -> Self:
         """Only use HTTP/2.
 
-        Same as `.http1(False).http2(True)`. When enabling, it is recommended to tune "http2_" settings for production
-        usage based on expected workloads.
+        When enabling, it is recommended to tune "http2_" settings for production usage based on expected workloads.
         """
 
     def http2_initial_stream_window_size(self, value: int | None) -> Self:
@@ -348,12 +349,3 @@ class SyncClientBuilder(BaseClientBuilder):
 
     def json_handler(self, *, loads: SyncJsonLoads | None = ..., dumps: JsonDumps | None = ...) -> Self:
         """Override JSON loads / dumps callables for this sync client."""
-
-class Runtime:
-    """Tokio runtime instance. Usually not needed, as library global runtime is used by default."""
-
-    def __init__(self) -> None:
-        """Create a tokio runtime instance. This is an advanced feature."""
-
-    async def close(self) -> None:
-        """Shutdown runtime resources. Clients using this runtime won't work anymore after closing."""

pyreqwest/exceptions/__init__.py

@@ -1,7 +1,7 @@
 """Exception classes."""
 
 from json import JSONDecodeError as JSONDecodeError_
-from typing import Any, Generic, TypedDict, TypeVar
+from typing import Any, TypedDict
 
 
 class Cause(TypedDict):
@@ -19,12 +19,10 @@ class CauseErrorDetails(TypedDict):
 class StatusErrorDetails(TypedDict):
     """Details for errors that have an associated HTTP status code."""
 
+    causes: list[Cause] | None
     status: int
 
 
-T = TypeVar("T", bound=CauseErrorDetails | StatusErrorDetails)
-
-
 class PyreqwestError(Exception):
     """Base class for all pyreqwest errors."""
 
@@ -35,41 +33,46 @@ class PyreqwestError(Exception):
         self.message = message
 
 
-class DetailedPyreqwestError(PyreqwestError, Generic[T]):
+class DetailedPyreqwestError(PyreqwestError):
     """Base class for all pyreqwest errors with details.
 
     Details may be available in `details`.
     """
 
-    def __init__(self, message: str, details: T) -> None:
+    def __init__(self, message: str, details: CauseErrorDetails) -> None:
         """Internally initialized."""
         assert isinstance(details, dict)
         PyreqwestError.__init__(self, message, details)
-        self.details = details
+        self.details: CauseErrorDetails = details
 
 
-class RequestError(DetailedPyreqwestError[T], Generic[T]):
+class RequestError(DetailedPyreqwestError):
     """Error while processing a request.
 
     Details may be available in `details`.
     """
 
 
-class StatusError(RequestError[StatusErrorDetails]):
+class StatusError(RequestError):
     """Error due to HTTP 4xx or 5xx status code. Raised when `error_for_status` is enabled.
 
     The status code is available in `details["status"]`.
     """
 
+    def __init__(self, message: str, details: StatusErrorDetails) -> None:
+        """Internally initialized."""
+        RequestError.__init__(self, message, details)
+        self.details: StatusErrorDetails = details
+
 
-class RedirectError(RequestError[CauseErrorDetails]):
+class RedirectError(RequestError):
     """Error due to too many redirects. Raised when `max_redirects` is exceeded.
 
     Cause details may be available in `details["causes"]`.
     """
 
 
-class DecodeError(RequestError[CauseErrorDetails]):
+class DecodeError(RequestError):
     """Error while decoding the response.
 
     Cause details may be available in `details["causes"]`.
@@ -98,7 +101,7 @@ class JSONDecodeError(BodyDecodeError, JSONDecodeError_):
         BodyDecodeError.__init__(self, message, {"causes": details["causes"]})
 
 
-class TransportError(RequestError[CauseErrorDetails]):
+class TransportError(RequestError):
     """Error while processing the transport layer.
 
     Cause details may be available in `details["causes"]`.
@@ -170,21 +173,21 @@ class WriteError(NetworkError):
     """
 
 
-class ClientClosedError(RequestError[CauseErrorDetails]):
+class ClientClosedError(RequestError):
     """Error due to user closing the client while request was being processed.
 
     Cause details may be available in `details["causes"]`.
     """
 
 
-class BuilderError(DetailedPyreqwestError[CauseErrorDetails], ValueError):
+class BuilderError(DetailedPyreqwestError, ValueError):
     """Error while building a request.
 
     Cause details may be available in `details["causes"]`.
     """
 
 
-class RequestPanicError(RequestError[CauseErrorDetails]):
+class RequestPanicError(RequestError):
     """Error due to a panic in the request processing.
 
     This indicates a bug in pyreqwest or one of its dependencies.

pyreqwest/request/__init__.pyi

@@ -123,7 +123,7 @@ class RequestBody:
         """Copy body (Zero-copied bytes. Stream supplies its own copy)."""
 
 class BaseRequestBuilder:
-    def error_for_status(self, enable: bool) -> Self:
+    def error_for_status(self, enable: bool = True) -> Self:
         """Enable automatic HTTP error raising (4xx/5xx)."""
 
     def header(self, name: str, value: str) -> Self:

pyreqwest/response/__init__.pyi

@@ -101,13 +101,13 @@ class ResponseBuilder:
     def build_sync(self) -> SyncResponse:
         """Build synchronous response (disallows async streams)."""
 
-    def status(self, value: int) -> Self:
+    def status(self, status: int) -> Self:
         """Set status code."""
 
-    def version(self, value: str) -> Self:
+    def version(self, version: str) -> Self:
         """Set HTTP version string."""
 
-    def header(self, name: str, value: str) -> Self:
+    def header(self, key: str, value: str) -> Self:
         """Append single header value (multiple allowed)."""
 
     def headers(self, headers: HeadersType) -> Self:

pyreqwest/runtime/__init__.py

@@ -0,0 +1,15 @@
+"""Runtime configuration. See Tokio runtime documentation for details about config parameters."""
+
+from pyreqwest._pyreqwest.runtime import (
+    runtime_blocking_thread_keep_alive,
+    runtime_max_blocking_threads,
+    runtime_multithreaded_default,
+    runtime_worker_threads,
+)
+
+__all__ = [
+    "runtime_multithreaded_default",
+    "runtime_worker_threads",
+    "runtime_max_blocking_threads",
+    "runtime_blocking_thread_keep_alive",
+]

pyreqwest/runtime/__init__.pyi

@@ -0,0 +1,25 @@
+from datetime import timedelta
+
+def runtime_multithreaded_default(enable: bool | None) -> None:
+    """Enable to use multithreaded runtime by default. None uses default behavior which is to use single-threaded
+    runtime.
+    """
+
+def runtime_worker_threads(threads: int | None) -> None:
+    """Set the number of worker threads for the multithreaded runtime. None uses default Tokio behavior which is the
+    number of cores available to the system.
+
+    Should be configured at startup. Can not be changed after multithreaded runtime has been initialized.
+    """
+
+def runtime_max_blocking_threads(threads: int | None) -> None:
+    """Set the maximum number of blocking threads for the multithreaded runtime. None uses default Tokio behavior.
+
+    Should be configured at startup. Can not be changed after multithreaded runtime has been initialized.
+    """
+
+def runtime_blocking_thread_keep_alive(duration: timedelta | None) -> None:
+    """Set the keep-alive time for blocking threads in the multithreaded runtime. None uses default Tokio behavior.
+
+    Should be configured at startup. Can not be changed after multithreaded runtime has been initialized.
+    """

{pyreqwest-0.9.0.dist-info → pyreqwest-0.10.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyreqwest
-Version: 0.9.0
+Version: 0.10.1
 Classifier: Development Status :: 4 - Beta
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3

{pyreqwest-0.9.0.dist-info → pyreqwest-0.10.1.dist-info}/RECORD

@@ -1,10 +1,10 @@
 pyreqwest/__init__.py,sha256=AqtJmAtOEQ6kYGY2_Qzw2f_q5K3Q5PN-TpOmIKaeiEM,86
 pyreqwest/__init__.pyi,sha256=Y25n44pyE3vp92MiABKrcK3IWRyQ1JG1rZ4Ufqy2nC0,17
-pyreqwest/_pyreqwest.cpython-313-s390x-linux-gnu.so,sha256=26I2M0KBoBdmCVkHA0RyIEWTsVchR6TRntHe1849Wwk,8575352
+pyreqwest/_pyreqwest.cpython-313-s390x-linux-gnu.so,sha256=mECHriYGsMklqQKdS1wlmod0ueUW3Ka3yCYYnWDz5cU,8670008
 pyreqwest/bytes/__init__.py,sha256=uzB8cxWbBizu0kyrdXhmnwWKWdwBcVIv4mgEhCR1LMs,465
 pyreqwest/bytes/__init__.pyi,sha256=bttN8uCg7K3gW90FBgPP4vbtNrBCOwqX4v7LAK-T1pU,4569
-pyreqwest/client/__init__.py,sha256=y6krpfN7sB7IxPvFX1kvhhoJI6Bwh9okmg5Jq1cEv7o,353
-pyreqwest/client/__init__.pyi,sha256=LUAQcldr6P0AbVUEVBz2GndoLOEwBv-9lQil57peJBw,15083
+pyreqwest/client/__init__.py,sha256=37hK94Tz4MKvCJiYl9H_ZYVXF0CExX4Om-grcPIC9oY,325
+pyreqwest/client/__init__.pyi,sha256=9QjOlirKKXAPqi49JpL8X0HOcumFXfchabUKlI9Jx5k,14832
 pyreqwest/client/types.py,sha256=CpfplqBGOyvpZNpwbOqal89dBztZlZTYuX-nM1Qrwrg,1475
 pyreqwest/compatibility/__init__.py,sha256=yJ4VD9iMzvSpYDjM6kEM-F2A_avMFCkOo1g5bgD2AGU,102
 pyreqwest/compatibility/httpx/__init__.py,sha256=Gc0jMCgmpSHkqQha_zAzxXjrbRSvS6KUOnHp4Z0UMDc,334
@@ -12,7 +12,7 @@ pyreqwest/compatibility/httpx/_internal.py,sha256=olu1ES7bV8AHUqtEMEmGHlejQCxAS3
 pyreqwest/compatibility/httpx/transport.py,sha256=2wuhREEvpWvcrCZcNv0mH_7MbuqwCO0_b9j7TMxkee8,6672
 pyreqwest/cookie/__init__.py,sha256=whcJaTtVHgqH2n_lvGYXYHP7D9BolDU6SvKjuKpewAs,128
 pyreqwest/cookie/__init__.pyi,sha256=YCOI79evRpc7xmSpY6q1MsQMCHSucGDpLmsk0ZqfXN4,6401
-pyreqwest/exceptions/__init__.py,sha256=LWD8I6hFsw0ogHwpobPVcO5tfFRhRg0rPF2Bs64XjuI,5319
+pyreqwest/exceptions/__init__.py,sha256=BiKq0hwV7nqu6f2K0Am_BXC9vvuD8snvWbkRLRFZm4Q,5360
 pyreqwest/http/__init__.py,sha256=hyzkUQ8bj_xrPfOPYwUx0NpahQFFMWzpm2wKCmBe3ug,318
 pyreqwest/http/__init__.pyi,sha256=xmG6eD1Uz0Y1nRgPb_zxUMKc57rgxWq58W5nsCRg9V0,13798
 pyreqwest/logging/__init__.py,sha256=KCmYt3ssr69rMe5u3ywFv2cbMOkj4Nz7qxdaBlu_CNc,125
@@ -36,17 +36,19 @@ pyreqwest/pytest_plugin/internal/plugin.py,sha256=NkneUC5Ui-1ATlrG0q-R4_xdkA_Ou3
 pyreqwest/pytest_plugin/mock.py,sha256=0eFdaXQB4BsfBg3R5ctOShg5yCEgyLlm1mdI44Rynpo,20995
 pyreqwest/pytest_plugin/types.py,sha256=QyFxjkth7favATSwt3d8EtUBcVjqcUYQ5BxA617T54g,895
 pyreqwest/request/__init__.py,sha256=zr4G_-kES2pN2HZ5nhbRbpwtEWooLJDX01KXrlUMET4,604
-pyreqwest/request/__init__.pyi,sha256=p-4G27vrdmfZIfbXWcXkIZYqPRESzRwMVjJbfIv8wwY,7861
+pyreqwest/request/__init__.pyi,sha256=eLbFMU9_dSMtfMhaWf79lr1TlFmXl8vRfUOq_v-LejU,7868
 pyreqwest/response/__init__.py,sha256=40wLYwCOzIALl8qZecVLT-qj14Jf5EYTnW7CPVjIvzQ,357
-pyreqwest/response/__init__.pyi,sha256=8hebHvfuWadg4zi0esEMJikTrXE296DlWHbYGGkLNfQ,5737
+pyreqwest/response/__init__.pyi,sha256=gfgXNg4q7GZfYgUesw_zyY4slwvso0bzNY-E8__iFZY,5739
+pyreqwest/runtime/__init__.py,sha256=wdw_AyBkN9a98l3nmzoUhp5Wcfa1BIKB3PpGhAWY_eI,441
+pyreqwest/runtime/__init__.pyi,sha256=ndUeESCWse43tDdg3yQa_7utPzEW4EImCvb5tyUXqs8,1168
 pyreqwest/simple/__init__.py,sha256=kNB7FA92J7OlFnPMColUkUQjEQq_3GTiNWbE2BmHG7k,52
 pyreqwest/simple/request/__init__.py,sha256=INoWzPcGE_O15wzfJ1tZwy5j0ua0GUAiPDcqwj1qI7Q,428
 pyreqwest/simple/request/__init__.pyi,sha256=p9BSuuQh1rJk44xwdJhGV8apGPvdB0qAo2HWwqQYj8E,1227
 pyreqwest/simple/sync_request/__init__.py,sha256=8Jv0wYehivbmscZvpOPkwHpIqNGEIY4x4hZPB5zv2rU,432
 pyreqwest/simple/sync_request/__init__.pyi,sha256=heyLHDzLPuePzTeX7DLpc9IyTEEHeZKOSjXis0j6BF8,1259
 pyreqwest/types.py,sha256=10lGx5uugbo5awMz6nNOcuIsyeG3NIB7DqQHiPbOHLk,643
-pyreqwest-0.9.0.dist-info/METADATA,sha256=91fHtfUsldlAzVkpldZmeZ9gigKxYhHK4fiANj9waAI,5850
-pyreqwest-0.9.0.dist-info/WHEEL,sha256=PPNd-6yB1l1g40RcYkDa5sht228uTmpdFKdcIBDzpcs,145
-pyreqwest-0.9.0.dist-info/entry_points.txt,sha256=x6BM9g8m805tw6VqKvSe_Kgd2qp4Eq3moyIoFnETeoE,61
-pyreqwest-0.9.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-pyreqwest-0.9.0.dist-info/RECORD,,
+pyreqwest-0.10.1.dist-info/METADATA,sha256=0gUNNuHUolKXcl0-t3d5UoA3ZIjiDy4_pmUF9CgFq6o,5851
+pyreqwest-0.10.1.dist-info/WHEEL,sha256=YlZHjDUVwPr4ZEOVIlWi3GsEbrB2wYQ6m9e1PsSxG-U,145
+pyreqwest-0.10.1.dist-info/entry_points.txt,sha256=x6BM9g8m805tw6VqKvSe_Kgd2qp4Eq3moyIoFnETeoE,61
+pyreqwest-0.10.1.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+pyreqwest-0.10.1.dist-info/RECORD,,

{pyreqwest-0.9.0.dist-info → pyreqwest-0.10.1.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: maturin (1.11.4)
+Generator: maturin (1.11.5)
 Root-Is-Purelib: false
 Tag: cp313-cp313-manylinux_2_17_s390x
 Tag: cp313-cp313-manylinux2014_s390x