hackerrank 2026.8.28__tar.gz → 2026.9.7__tar.gz

{hackerrank-2026.8.28 → hackerrank-2026.9.7}/CHANGELOG.rst

@@ -3,6 +3,12 @@ Changelog
 
 .. towncrier release notes start
 
+2026.09.07
+----------
+
+- Add synchronous and asynchronous HTTPX2 transports while retaining HTTPX as
+  the default client family.
+
 2026.08.28
 ----------
 

{hackerrank-2026.8.28/src/hackerrank.egg-info → hackerrank-2026.9.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hackerrank
-Version: 2026.8.28
+Version: 2026.9.7
 Summary: Interact with the HackerRank for Work API.
 Author-email: Adam Dangoor <adamdangoor@gmail.com>
 License-Expression: MIT
@@ -19,26 +19,27 @@ Description-Content-Type: text/x-rst
 License-File: LICENSE
 Requires-Dist: beartype>=0.22.9
 Requires-Dist: httpx>=0.28.0
+Requires-Dist: httpx2>=2.12.0
 Provides-Extra: dev
 Requires-Dist: actionlint-py==1.7.12.24; extra == "dev"
 Requires-Dist: beartype==0.22.9; extra == "dev"
 Requires-Dist: check-manifest==0.51; extra == "dev"
 Requires-Dist: deptry==0.25.1; extra == "dev"
 Requires-Dist: doc8==2.0.0; extra == "dev"
-Requires-Dist: doccmd==2026.8.16; extra == "dev"
+Requires-Dist: doccmd==2026.9.1; extra == "dev"
 Requires-Dist: furo==2025.12.19; extra == "dev"
 Requires-Dist: interrogate==1.7.0; extra == "dev"
 Requires-Dist: mypy[faster-cache]==2.3.1; extra == "dev"
 Requires-Dist: mypy-strict-kwargs==2026.8.25.1; extra == "dev"
-Requires-Dist: no-defaults==2.1.0; extra == "dev"
+Requires-Dist: no-defaults==2026.9.1; extra == "dev"
 Requires-Dist: openapi-mock==2026.8.16; extra == "dev"
-Requires-Dist: prek==0.4.14; extra == "dev"
+Requires-Dist: prek==0.5.2; extra == "dev"
 Requires-Dist: pydocstringformatter==1.0.0; extra == "dev"
 Requires-Dist: pydocstyle==6.3; extra == "dev"
 Requires-Dist: pygments==2.21.0; extra == "dev"
-Requires-Dist: pylint[spelling]==4.0.7; extra == "dev"
+Requires-Dist: pylint[spelling]==4.0.8; extra == "dev"
 Requires-Dist: pylint-per-file-ignores==3.2.1; extra == "dev"
-Requires-Dist: pyproject-fmt==2.28.1; extra == "dev"
+Requires-Dist: pyproject-fmt==2.29.3; extra == "dev"
 Requires-Dist: pyrefly==1.2.0; extra == "dev"
 Requires-Dist: pyright==1.1.411; extra == "dev"
 Requires-Dist: pyroma==5.0.1; extra == "dev"
@@ -46,11 +47,12 @@ Requires-Dist: pytest==9.1.1; extra == "dev"
 Requires-Dist: pytest-asyncio==1.4.0; extra == "dev"
 Requires-Dist: pytest-beartype-tests==2026.8.16; extra == "dev"
 Requires-Dist: pytest-cov==7.1.0; extra == "dev"
+Requires-Dist: pytest-httpx2==1.0.0; extra == "dev"
 Requires-Dist: pyyaml==6.0.3; extra == "dev"
 Requires-Dist: respx==0.23.1; extra == "dev"
-Requires-Dist: ruff==0.16.4; extra == "dev"
+Requires-Dist: ruff==0.16.6; extra == "dev"
 Requires-Dist: shellcheck-py==0.11.0.1; extra == "dev"
-Requires-Dist: shfmt-py==4.0.0; extra == "dev"
+Requires-Dist: shfmt-py==4.1.0; extra == "dev"
 Requires-Dist: sphinx==9.1.0; extra == "dev"
 Requires-Dist: sphinx-copybutton==0.5.2; extra == "dev"
 Requires-Dist: sphinx-lint==1.0.2; extra == "dev"
@@ -58,14 +60,14 @@ Requires-Dist: sphinx-pyproject==0.3.0; extra == "dev"
 Requires-Dist: sphinx-substitution-extensions==2026.8.13.1; extra == "dev"
 Requires-Dist: sphinxcontrib-spelling==8.0.2; extra == "dev"
 Requires-Dist: sphinxcontrib-towncrier==0.5.0a0; extra == "dev"
-Requires-Dist: strict-kwargs==2026.8.24; extra == "dev"
+Requires-Dist: strict-kwargs==2026.8.28.post2; extra == "dev"
 Requires-Dist: sybil==10.1.0; extra == "dev"
 Requires-Dist: towncrier==25.8.0; extra == "dev"
-Requires-Dist: ty==0.0.74; extra == "dev"
-Requires-Dist: vale==3.18.0.0; extra == "dev"
+Requires-Dist: ty==0.0.78; extra == "dev"
+Requires-Dist: vale==3.20.0.0; extra == "dev"
 Requires-Dist: vulture==2.16; extra == "dev"
 Requires-Dist: yamlfix==1.19.1; extra == "dev"
-Requires-Dist: zizmor==1.29.0; extra == "dev"
+Requires-Dist: zizmor==1.30.0; extra == "dev"
 Provides-Extra: release
 Requires-Dist: check-wheel-contents==0.6.3; extra == "release"
 Requires-Dist: towncrier==25.8.0; extra == "release"
@@ -111,6 +113,33 @@ pass it as ``api_key``:
 
 .. _HackerRank for Work tokens page: https://www.hackerrank.com/work/settings/token
 
+HTTPX2 transports
+-----------------
+
+HTTPX remains the default client family. To opt in to HTTPX2, construct the
+HTTPX2 transport explicitly and pass it to the client. The standard
+``hackerrank`` installation includes both client families.
+
+.. code-block:: python
+
+   """Configure HackerRank to use HTTPX2."""
+
+   import httpx2
+
+   from hackerrank.client import HackerRank
+   from hackerrank.transports import HTTPX2Transport
+
+   transport = HTTPX2Transport(timeout=httpx2.Timeout(timeout=10))
+   with HackerRank(api_key="your-api-key", transport=transport) as client:
+       tests = client.tests.list()
+
+Use ``AsyncHTTPX2Transport`` with ``AsyncHackerRank`` for asynchronous calls.
+The ``timeout`` argument accepts an HTTPX2 timeout object or a number of
+seconds; do not pass an equivalent ``httpx`` object across the package
+boundary. Existing HTTPX users do not need to change anything. Migrating to
+HTTPX2 only requires selecting the new transport; HackerRank client methods
+and returned models are unchanged.
+
 Full Documentation
 ------------------
 

{hackerrank-2026.8.28 → hackerrank-2026.9.7}/README.rst

@@ -38,6 +38,33 @@ pass it as ``api_key``:
 
 .. _HackerRank for Work tokens page: https://www.hackerrank.com/work/settings/token
 
+HTTPX2 transports
+-----------------
+
+HTTPX remains the default client family. To opt in to HTTPX2, construct the
+HTTPX2 transport explicitly and pass it to the client. The standard
+``hackerrank`` installation includes both client families.
+
+.. code-block:: python
+
+   """Configure HackerRank to use HTTPX2."""
+
+   import httpx2
+
+   from hackerrank.client import HackerRank
+   from hackerrank.transports import HTTPX2Transport
+
+   transport = HTTPX2Transport(timeout=httpx2.Timeout(timeout=10))
+   with HackerRank(api_key="your-api-key", transport=transport) as client:
+       tests = client.tests.list()
+
+Use ``AsyncHTTPX2Transport`` with ``AsyncHackerRank`` for asynchronous calls.
+The ``timeout`` argument accepts an HTTPX2 timeout object or a number of
+seconds; do not pass an equivalent ``httpx`` object across the package
+boundary. Existing HTTPX users do not need to change anything. Migrating to
+HTTPX2 only requires selecting the new transport; HackerRank client methods
+and returned models are unchanged.
+
 Full Documentation
 ------------------
 

{hackerrank-2026.8.28 → hackerrank-2026.9.7}/docs/source/conf.py

@@ -82,6 +82,8 @@ nitpick_ignore: list[tuple[str, str]] = [
     # ``httpx`` does not publish a Sphinx object inventory, so its
     # types cannot be cross-referenced.
     ("py:class", "httpx.Timeout"),
+    # ``httpx2`` does not expose this class in its Sphinx inventory.
+    ("py:class", "httpx2.Timeout"),
 ]
 nitpick_ignore_regex = [
     (r"py:class", r"hackerrank\._dict_types\..*"),

hackerrank-2026.9.7/docs/source/index.rst

@@ -0,0 +1,75 @@
+|project|
+=========
+
+Installation
+------------
+
+.. code-block:: console
+
+   $ pip install hackerrank
+
+This is tested on Python |minimum-python-version|\+.
+
+Usage
+-----
+
+Generate an API token from the `HackerRank for Work tokens page`_ and pass
+it to :class:`hackerrank.client.HackerRank`:
+
+.. code-block:: python
+
+   """Example usage."""
+
+   import sys
+
+   from hackerrank.client import HackerRank
+
+   client = HackerRank(api_key="your-api-key")
+   for test in client.tests.list().data:
+       sys.stdout.write(test.name)
+   interview = client.interviews.create(title="My Interview")
+   sys.stdout.write(interview.url or "")
+
+HTTPX2 transports
+-----------------
+
+HTTPX remains the default client family. To opt in to HTTPX2, construct the
+HTTPX2 transport explicitly and pass it to the client. The standard
+``hackerrank`` installation includes both client families.
+
+.. code-block:: python
+
+   """Configure HackerRank to use HTTPX2."""
+
+   import httpx2
+
+   from hackerrank.client import HackerRank
+   from hackerrank.transports import HTTPX2Transport
+
+   transport = HTTPX2Transport(timeout=httpx2.Timeout(timeout=10))
+   with HackerRank(api_key="your-api-key", transport=transport) as client:
+       tests = client.tests.list()
+
+Use ``AsyncHTTPX2Transport`` with ``AsyncHackerRank`` for asynchronous calls.
+The ``timeout`` argument accepts an HTTPX2 timeout object or a number of
+seconds; do not pass an equivalent ``httpx`` object across the package
+boundary. Existing HTTPX users do not need to change anything. Migrating to
+HTTPX2 only requires selecting the new transport; HackerRank client methods
+and returned models are unchanged.
+
+See the :doc:`api-reference` for full usage details.
+
+.. _HackerRank for Work tokens page: https://www.hackerrank.com/work/settings/token
+
+Reference
+---------
+
+.. toctree::
+   :maxdepth: 3
+
+   api-reference
+   openapi-spec
+   contributing
+   release-process
+   unreleased
+   changelog

{hackerrank-2026.8.28 → hackerrank-2026.9.7}/pyproject.toml

@@ -34,6 +34,7 @@ dynamic = [
 dependencies = [
     "beartype>=0.22.9",
     "httpx>=0.28.0",
+    "httpx2>=2.12.0",
 ]
 optional-dependencies.dev = [
     "actionlint-py==1.7.12.24",
@@ -41,20 +42,20 @@ optional-dependencies.dev = [
     "check-manifest==0.51",
     "deptry==0.25.1",
     "doc8==2.0.0",
-    "doccmd==2026.8.16",
+    "doccmd==2026.9.1",
     "furo==2025.12.19",
     "interrogate==1.7.0",
     "mypy[faster-cache]==2.3.1",
     "mypy-strict-kwargs==2026.8.25.1",
-    "no-defaults==2.1.0",
+    "no-defaults==2026.9.1",
     "openapi-mock==2026.8.16",
-    "prek==0.4.14",
+    "prek==0.5.2",
     "pydocstringformatter==1.0.0",
     "pydocstyle==6.3",
     "pygments==2.21.0",
-    "pylint[spelling]==4.0.7",
+    "pylint[spelling]==4.0.8",
     "pylint-per-file-ignores==3.2.1",
-    "pyproject-fmt==2.28.1",
+    "pyproject-fmt==2.29.3",
     "pyrefly==1.2.0",
     "pyright==1.1.411",
     "pyroma==5.0.1",
@@ -62,14 +63,15 @@ optional-dependencies.dev = [
     "pytest-asyncio==1.4.0",
     "pytest-beartype-tests==2026.8.16",
     "pytest-cov==7.1.0",
+    "pytest-httpx2==1.0.0",
     "pyyaml==6.0.3",
     "respx==0.23.1",
-    "ruff==0.16.4",
+    "ruff==0.16.6",
     # We add shellcheck-py not only for shell scripts and shell code blocks,
     # but also because having it installed means that ``actionlint-py`` will
     # use it to lint shell commands in GitHub workflow files.
     "shellcheck-py==0.11.0.1",
-    "shfmt-py==4.0.0",
+    "shfmt-py==4.1.0",
     "sphinx==9.1.0",
     "sphinx-copybutton==0.5.2",
     "sphinx-lint==1.0.2",
@@ -79,14 +81,14 @@ optional-dependencies.dev = [
     # ``sphinxcontrib-towncrier`` renders unreleased news fragments
     # into docs/source/unreleased.rst during Sphinx builds.
     "sphinxcontrib-towncrier==0.5.0a0",
-    "strict-kwargs==2026.8.24",
+    "strict-kwargs==2026.8.28.post2",
     "sybil==10.1.0",
     "towncrier==25.8.0",
-    "ty==0.0.74",
-    "vale==3.18.0.0",
+    "ty==0.0.78",
+    "vale==3.20.0.0",
     "vulture==2.16",
     "yamlfix==1.19.1",
-    "zizmor==1.29.0",
+    "zizmor==1.30.0",
 ]
 optional-dependencies.release = [ "check-wheel-contents==0.6.3", "towncrier==25.8.0" ]
 urls.Documentation = "https://adamtheturtle.github.io/hackerrank/"
@@ -149,7 +151,9 @@ lint.unfixable = [
     "ERA001",
 ]
 lint.external = [ "NOD" ]
-lint.flake8-tidy-imports.banned-api."typing.cast".msg = "typing.cast is banned: use explicit type narrowing or a typed variable instead."
+lint.flake8-tidy-imports.banned-api."typing.cast".msg = """\
+    typing.cast is banned: use explicit type narrowing or a typed variable instead.\
+    """
 lint.pydocstyle.convention = "google"
 
 [tool.pylint]
@@ -537,8 +541,8 @@ plugins = [
 ]
 
 [tool.pyrefly]
-errors.non-exhaustive-match = "error"
 search-path = [ "." ]
+errors.non-exhaustive-match = "error"
 
 [tool.pyright]
 typeCheckingMode = "strict"
@@ -574,6 +578,11 @@ issue_format = "#{issue}"
 # version such as ``2026.05.18`` underlined with ``-`` matches every
 # pre-towncrier entry in CHANGELOG.rst.
 underlines = [ "-", "~", "^" ]
+# Setting ``ignore`` makes ``towncrier build`` fail on any file in
+# the fragment directory whose suffix is not a declared fragment
+# type, instead of silently dropping it.  Only the listed
+# non-fragment files are allowed through.
+ignore = [ ".gitkeep" ]
 type = [
     # A single, unnamed fragment type keeps the assembled output as one
     # flat bullet list, matching the historical changelog (which never

{hackerrank-2026.8.28 → hackerrank-2026.9.7}/spelling_private_dict.txt

@@ -40,6 +40,7 @@ html
 http
 https
 httpx
+httpx2
 invariance
 inviters
 io

{hackerrank-2026.8.28 → hackerrank-2026.9.7}/src/hackerrank/async_client.py

@@ -8,6 +8,7 @@ from types import TracebackType
 from typing import Any, BinaryIO, Self
 
 import httpx
+import httpx2
 from beartype import beartype
 
 from hackerrank._retries import (
@@ -18,6 +19,7 @@ from hackerrank._retries import (
 )
 from hackerrank.exceptions import HackerRankError
 from hackerrank.transports import (
+    AsyncHTTPX2Transport,
     AsyncHTTPXTransport,
     AsyncTransport,
     TransportResponse,
@@ -318,7 +320,7 @@ class _AsyncNamespace:
                     json=json,
                     files=files,
                 )
-            except httpx.TransportError as exc:
+            except (httpx.TransportError, httpx2.TransportError) as exc:
                 if not (retriable and rewind_files(files=files)):
                     raise
                 headers = None
@@ -3290,7 +3292,10 @@ class AsyncHackerRank:
         )
         self._owned_transport = (
             resolved_transport
-            if isinstance(resolved_transport, AsyncHTTPXTransport)
+            if isinstance(
+                resolved_transport,
+                (AsyncHTTPXTransport, AsyncHTTPX2Transport),
+            )
             else None
         )
 

{hackerrank-2026.8.28 → hackerrank-2026.9.7}/src/hackerrank/client.py

@@ -8,6 +8,7 @@ from types import TracebackType
 from typing import Any, BinaryIO, Self
 
 import httpx
+import httpx2
 from beartype import beartype
 
 from hackerrank._retries import (
@@ -18,6 +19,7 @@ from hackerrank._retries import (
 )
 from hackerrank.exceptions import HackerRankError
 from hackerrank.transports import (
+    HTTPX2Transport,
     HTTPXTransport,
     Transport,
     TransportResponse,
@@ -140,7 +142,7 @@ class _Namespace:
                     json=json,
                     files=files,
                 )
-            except httpx.TransportError as exc:
+            except (httpx.TransportError, httpx2.TransportError) as exc:
                 if not (retriable and rewind_files(files=files)):
                     raise
                 headers = None
@@ -3278,7 +3280,7 @@ class HackerRank:
             headers=headers,
             retries=retries,
         )
-        if isinstance(resolved_transport, HTTPXTransport):
+        if isinstance(resolved_transport, (HTTPXTransport, HTTPX2Transport)):
             self._close = resolved_transport.close
         else:
             self._close = lambda: None

{hackerrank-2026.8.28 → hackerrank-2026.9.7}/src/hackerrank/transports.py

@@ -8,6 +8,7 @@ from types import TracebackType
 from typing import Any, Protocol, Self, runtime_checkable
 
 import httpx
+import httpx2
 from beartype import beartype
 
 from hackerrank.types import JSONValue
@@ -15,8 +16,8 @@ from hackerrank.types import JSONValue
 DEFAULT_TIMEOUT_SECONDS = 60.0
 """The default timeout, in seconds, for the built-in transports.
 
-``httpx`` defaults to 5 seconds, which is too short for endpoints
-which carry large payloads, such as project zip uploads.
+The HTTP client libraries default to 5 seconds, which is too short for
+endpoints which carry large payloads, such as project zip uploads.
 """
 
 
@@ -194,6 +195,92 @@ class HTTPXTransport:
         )
 
 
+@beartype
+class HTTPX2Transport:
+    """HTTP transport using the ``httpx2`` library.
+
+    This opt-in transport uses a shared ``httpx2.Client`` for connection
+    pooling. Configuration objects must come from ``httpx2``, not ``httpx``.
+    """
+
+    def __init__(
+        self,
+        *,
+        # ``int`` is redundant to a type checker, which reads ``float``
+        # as "int or float", but ``beartype`` checks the annotation
+        # literally at runtime and would reject ``timeout=60``.
+        timeout: httpx2.Timeout | float | int = DEFAULT_TIMEOUT_SECONDS,  # noqa: PYI041
+    ) -> None:
+        """Create a new HTTPX2 transport.
+
+        Args:
+            timeout: The timeout to use for every request, either
+                a number of seconds or an ``httpx2.Timeout``.
+                Defaults to
+                :data:`DEFAULT_TIMEOUT_SECONDS` seconds.
+        """
+        self._client = httpx2.Client(timeout=timeout)
+
+    def close(self) -> None:
+        """Close the underlying HTTP client."""
+        self._client.close()
+
+    def __enter__(self) -> Self:
+        """Enter the context manager.
+
+        Returns:
+            This transport instance.
+        """
+        return self
+
+    def __exit__(
+        self,
+        _exc_type: type[BaseException] | None,
+        _exc_val: BaseException | None,
+        _exc_tb: TracebackType | None,
+    ) -> None:
+        """Exit the context manager and close the client."""
+        self.close()
+
+    def __call__(
+        self,
+        *,
+        method: str,
+        url: str,
+        headers: dict[str, str],
+        params: dict[str, str | int] | None,
+        json: Mapping[str, JSONValue] | None,
+        files: Mapping[str, Any] | None,
+    ) -> TransportResponse:
+        """Make an HTTP request using ``httpx2``.
+
+        Args:
+            method: The HTTP method.
+            url: The full URL.
+            headers: Request headers.
+            params: Query parameters.
+            json: A JSON-serialisable body.
+            files: Files to send as multipart form-data.
+
+        Returns:
+            A ``TransportResponse`` populated from the httpx2
+            response.
+        """
+        response = self._client.request(
+            method=method,
+            url=url,
+            headers=headers,
+            params=params,
+            json=json,
+            files=files,
+        )
+        return TransportResponse(
+            status_code=response.status_code,
+            headers=dict(response.headers),
+            content=response.content,
+        )
+
+
 @runtime_checkable
 class AsyncTransport(Protocol):
     """Protocol for async HTTP transports."""
@@ -306,3 +393,86 @@ class AsyncHTTPXTransport:
             headers=dict(response.headers),
             content=response.content,
         )
+
+
+@beartype
+class AsyncHTTPX2Transport:
+    """Async HTTP transport using the ``httpx2`` library."""
+
+    def __init__(
+        self,
+        *,
+        # ``int`` is redundant to a type checker, which reads ``float``
+        # as "int or float", but ``beartype`` checks the annotation
+        # literally at runtime and would reject ``timeout=60``.
+        timeout: httpx2.Timeout | float | int = DEFAULT_TIMEOUT_SECONDS,  # noqa: PYI041
+    ) -> None:
+        """Create a new async HTTPX2 transport.
+
+        Args:
+            timeout: The timeout to use for every request, either
+                a number of seconds or an ``httpx2.Timeout``.
+                Defaults to
+                :data:`DEFAULT_TIMEOUT_SECONDS` seconds.
+        """
+        self._client = httpx2.AsyncClient(timeout=timeout)
+
+    async def aclose(self) -> None:
+        """Close the underlying async HTTP client."""
+        await self._client.aclose()
+
+    async def __aenter__(self) -> Self:
+        """Enter the async context manager.
+
+        Returns:
+            This transport instance.
+        """
+        return self
+
+    async def __aexit__(
+        self,
+        _exc_type: type[BaseException] | None,
+        _exc_val: BaseException | None,
+        _exc_tb: TracebackType | None,
+        /,
+    ) -> None:
+        """Exit the async context manager and close."""
+        await self.aclose()
+
+    async def __call__(
+        self,
+        *,
+        method: str,
+        url: str,
+        headers: dict[str, str],
+        params: dict[str, str | int] | None,
+        json: Mapping[str, JSONValue] | None,
+        files: Mapping[str, Any] | None,
+    ) -> TransportResponse:
+        """Make an async HTTP request using ``httpx2``.
+
+        Args:
+            method: The HTTP method.
+            url: The full URL.
+            headers: Request headers.
+            params: Query parameters.
+            json: A JSON-serialisable body.
+            files: Files to send as multipart form-data.
+
+        Returns:
+            A ``TransportResponse`` populated from the httpx2
+            response.
+        """
+        response = await self._client.request(
+            method=method,
+            url=url,
+            headers=headers,
+            params=params,
+            json=json,
+            files=files,
+        )
+        return TransportResponse(
+            status_code=response.status_code,
+            headers=dict(response.headers),
+            content=response.content,
+        )