hackerrank 2026.9.7__tar.gz → 2026.9.16__tar.gz

{hackerrank-2026.9.7 → hackerrank-2026.9.16}/.github/workflows/autofix.yml

@@ -21,7 +21,7 @@ jobs:
           persist-credentials: false
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v9.0.0
+        uses: astral-sh/setup-uv@v10.1.0
 
       - name: Run fixers
         uses: j178/prek-action@v3.0.0

{hackerrank-2026.9.7 → hackerrank-2026.9.16}/.github/workflows/ci.yml

@@ -28,7 +28,7 @@ jobs:
           persist-credentials: false
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v7
+        uses: astral-sh/setup-uv@v10.1.0
         with:
           enable-cache: true
           cache-dependency-glob: '**/pyproject.toml'
@@ -37,7 +37,7 @@ jobs:
         run: |
           # We run tests against "." and not the tests directory as we test the README
           # and documentation.
-          uv run --extra=dev --python=${{ matrix.python-version }} pytest -s -vvv --cov-fail-under 100 --cov=src/ --cov=tests/ .
+          uv run --group=dev --python=${{ matrix.python-version }} pytest -s -vvv --cov-fail-under 100 --cov=src/ --cov=tests/ .
 
   completion-ci:
     needs: build

{hackerrank-2026.9.7 → hackerrank-2026.9.16}/.github/workflows/lint.yml

@@ -29,7 +29,7 @@ jobs:
           persist-credentials: false
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v7
+        uses: astral-sh/setup-uv@v10.1.0
         with:
           enable-cache: true
           cache-dependency-glob: '**/pyproject.toml'

{hackerrank-2026.9.7 → hackerrank-2026.9.16}/.github/workflows/publish-site.yml

@@ -21,7 +21,7 @@ jobs:
         uses: sphinx-notes/pages@v3
         with:
           documentation_path: docs/source
-          pyproject_extras: dev
+          pyproject_group: dev
           python_version: '3.13'
           sphinx_build_options: -W
           cache: true

{hackerrank-2026.9.7 → hackerrank-2026.9.16}/.github/workflows/release.yml

@@ -33,7 +33,7 @@ jobs:
           fetch-depth: 0
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v7
+        uses: astral-sh/setup-uv@v10.1.0
         with:
           enable-cache: true
           cache-dependency-glob: '**/pyproject.toml'
@@ -53,7 +53,7 @@ jobs:
       - name: Generate the GitHub release notes
         env:
           RELEASE: ${{ steps.calver.outputs.release }}
-        run: uv run --extra=release towncrier build --draft --version "$RELEASE" >
+        run: uv run --group=release towncrier build --draft --version "$RELEASE" >
           release-notes.md
 
       # Assemble the same fragments into CHANGELOG.rst under a new
@@ -61,7 +61,7 @@ jobs:
       - name: Update the changelog
         env:
           RELEASE: ${{ steps.calver.outputs.release }}
-        run: uv run --extra=release towncrier build --yes --version "$RELEASE"
+        run: uv run --group=release towncrier build --yes --version "$RELEASE"
 
       - uses: stefanzweifel/git-auto-commit-action@v7
         id: commit
@@ -95,7 +95,7 @@ jobs:
           git fetch --tags
           git checkout "$NEW_TAG"
           uv build --sdist --wheel --out-dir dist/
-          uv run --extra=release check-wheel-contents dist/*.whl
+          uv run --group=release check-wheel-contents dist/*.whl
 
       - name: Publish distribution to PyPI
         # We use PyPI trusted publishing rather than a PyPI API token.

{hackerrank-2026.9.7 → hackerrank-2026.9.16}/.vale.ini

@@ -4,7 +4,8 @@ MinAlertLevel = error
 Packages = https://github.com/tbhb/vale-ai-tells/releases/download/v1.29.0/ai-tells.zip
 
 [*.{rst,md}]
-BasedOnStyles = ai-tells
+BasedOnStyles = ai-tells, snapper
+snapper.SemanticLineBreaks = error
 
 # These rules misclassify established technical, example, or release-note prose
 # in this repository. All other ai-tells rules remain enforced.

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

@@ -3,16 +3,27 @@ Changelog
 
 .. towncrier release notes start
 
+2026.09.16
+----------
+
+- Validate interview API response shapes before constructing client models.
+
+- Type shared page fixtures and captured request bodies as JSON values.
+
+- Restored the missing ``beartype`` import so the client modules load successfully.
+
+- Add ``interview_templates.add_questions`` and ``interview_templates.remove_question`` to both clients, matching the newly documented HackerRank endpoints, and refresh ``openapi.json`` from the served spec.
+
 2026.09.07
 ----------
 
-- Add synchronous and asynchronous HTTPX2 transports while retaining HTTPX as
-  the default client family.
+- Add synchronous and asynchronous HTTPX2 transports while retaining HTTPX as the default client family.
 
 2026.08.28
 ----------
 
-- Every method which changes state now documents whether it is safe to retry, and why. ``tests.archive`` is now treated as safe to repeat, so it is retried when ``retries`` is set.
+- Every method which changes state now documents whether it is safe to retry, and why.
+  ``tests.archive`` is now treated as safe to repeat, so it is retried when ``retries`` is set.
 
 2026.08.27
 ----------
@@ -24,31 +35,20 @@ Changelog
 2026.08.22
 ----------
 
-- Accept documented object-form interviewers and candidate_details, preserve
-  interview schedule / live fields, and return invite and update response
-  bodies from sync and async clients.
+- Accept documented object-form interviewers and candidate_details, preserve interview schedule / live fields, and return invite and update response bodies from sync and async clients.
 
-- Add ``client.candidates.search`` (sync and async) for the global
-  candidate-search endpoint, with typed attempt and candidate results.
+- Add ``client.candidates.search`` (sync and async) for the global candidate-search endpoint, with typed attempt and candidate results.
 
-- Expose documented list filters and body fields for interviews,
-  questions, templates, and candidate invites on sync and async
-  clients.
+- Expose documented list filters and body fields for interviews, questions, templates, and candidate invites on sync and async clients.
 
-- Reject bare ``str`` values for list-like API fields (``interviewers``,
-  ``languages``, ``tags``, and related parameters) so they are no longer
-  split into character arrays in request bodies.
+- Reject bare ``str`` values for list-like API fields (``interviewers``, ``languages``, ``tags``, and related parameters) so they are no longer split into character arrays in request bodies.
 
-- Refresh ``openapi.json`` from the live HackerRank schema and add a
-  semantic drift check that ignores dynamic example timestamps.
+- Refresh ``openapi.json`` from the live HackerRank schema and add a semantic drift check that ignores dynamic example timestamps.
 
-- Add ``client.interview_templates.explicit_sharing_roles`` with
-  ``update_access`` and ``remove_access`` for sharing an interview template with
-  users, teams or the whole company.
+- Add ``client.interview_templates.explicit_sharing_roles`` with ``update_access`` and ``remove_access`` for sharing an interview template with users, teams or the whole company.
 
-  Remove the ``team_share`` argument from interview-template ``create`` and
-  ``update``. HackerRank ignores the parameter and has removed it from the API
-  documentation; use ``explicit_sharing_roles`` instead.
+  Remove the ``team_share`` argument from interview-template ``create`` and ``update``.
+  HackerRank ignores the parameter and has removed it from the API documentation; use ``explicit_sharing_roles`` instead.
 
 - SCIM user and group PATCH methods now parse the documented message acknowledgement instead of treating the response as a full resource.
 
@@ -72,14 +72,13 @@ No significant changes.
 2026.07.30
 ----------
 
-- Align interview-template create and update requests with the current API,
-  return updated templates, and parse live string template IDs and integer
-  question IDs.
+- Align interview-template create and update requests with the current API, return updated templates, and parse live string template IDs and integer question IDs.
 
 2026.07.19
 ----------
 
-- SCIM v2 requests are now sent to ``https://services.hackerrank.com/scim/v2`` instead of the v3 API host, so ``client.scim`` works out of the box. A new ``scim_base_url`` argument on ``HackerRank`` and ``AsyncHackerRank`` allows overriding it.
+- SCIM v2 requests are now sent to ``https://services.hackerrank.com/scim/v2`` instead of the v3 API host, so ``client.scim`` works out of the box.
+  A new ``scim_base_url`` argument on ``HackerRank`` and ``AsyncHackerRank`` allows overriding it.
 
 - Bring the async ``AsyncHackerRank`` client to full parity with the synchronous ``HackerRank`` client, adding all missing operations and aligning method shapes (``ats.codepair``/``ats.codescreen``, ``teams.memberships`` and ``scim.users``/``scim.groups`` sub-namespaces).
 

hackerrank-2026.9.16/PKG-INFO

@@ -0,0 +1,100 @@
+Metadata-Version: 2.4
+Name: hackerrank
+Version: 2026.9.16
+Summary: Interact with the HackerRank for Work API.
+Author-email: Adam Dangoor <adamdangoor@gmail.com>
+License-Expression: MIT
+Project-URL: Documentation, https://adamtheturtle.github.io/hackerrank/
+Project-URL: Source, https://github.com/adamtheturtle/hackerrank
+Keywords: client,hackerrank,interview
+Classifier: Development Status :: 1 - Planning
+Classifier: Environment :: Web Environment
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.13
+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
+Dynamic: license-file
+
+|Build Status| |PyPI|
+
+hackerrank
+==========
+
+Python library for the `HackerRank for Work API`_.
+
+.. _HackerRank for Work API: https://www.hackerrank.com/work/apidocs
+
+Installation
+------------
+
+.. code-block:: shell
+
+   pip install hackerrank
+
+This is tested on Python |minimum-python-version|\+.
+
+Getting Started
+---------------
+
+Generate an API token from the `HackerRank for Work tokens page`_ and pass it as ``api_key``:
+
+.. 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)
+
+.. _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.
+Pass only HTTPX2 timeout objects 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
+------------------
+
+See the `full documentation <https://adamtheturtle.github.io/hackerrank/>`__.
+
+.. |Build Status| image:: https://github.com/adamtheturtle/hackerrank/actions/workflows/ci.yml/badge.svg?branch=main
+   :target: https://github.com/adamtheturtle/hackerrank/actions
+.. |PyPI| image:: https://badge.fury.io/py/hackerrank.svg
+   :target: https://badge.fury.io/py/hackerrank
+.. |minimum-python-version| replace:: 3.13

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

@@ -19,8 +19,7 @@ This is tested on Python |minimum-python-version|\+.
 Getting Started
 ---------------
 
-Generate an API token from the `HackerRank for Work tokens page`_ and
-pass it as ``api_key``:
+Generate an API token from the `HackerRank for Work tokens page`_ and pass it as ``api_key``:
 
 .. code-block:: python
 
@@ -32,18 +31,18 @@ pass it as ``api_key``:
 
    client = HackerRank(api_key="your-api-key")
    for test in client.tests.list().data:
-       sys.stdout.write(test.name)
+       _ = sys.stdout.write(test.name)
    interview = client.interviews.create(title="My Interview")
-   sys.stdout.write(interview.url or "")
+   _ = sys.stdout.write(interview.url)
 
 .. _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.
+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
 
@@ -59,11 +58,11 @@ HTTPX2 transport explicitly and pass it to the client. The standard
        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.
+The ``timeout`` argument accepts an HTTPX2 timeout object or a number of seconds.
+Pass only HTTPX2 timeout objects 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.9.7 → hackerrank-2026.9.16}/conftest.py

@@ -2,12 +2,12 @@
 
 from __future__ import annotations
 
-import json
-from typing import TYPE_CHECKING, Any
+from typing import TYPE_CHECKING
 
 import pytest
 import respx
 from openapi_mock import add_openapi_to_respx
+from pydantic import TypeAdapter, ValidationError
 
 if TYPE_CHECKING:
     from collections.abc import Generator
@@ -17,27 +17,31 @@ _HTTP_METHODS = frozenset(
     {"get", "post", "put", "delete", "patch", "head", "options", "trace"},
 )
 
+type _JSONValue = (
+    bool | int | float | str | list[_JSONValue] | dict[str, _JSONValue] | None
+)
 
-def _as_str_keyed_dict(*, value: object) -> dict[str, Any] | None:
-    """Return ``value`` as a ``str``-keyed dict, or ``None``.
 
-    Uses a JSON round-trip so static checkers see concrete ``Any``
-    values rather than unknown dict items from ``isinstance`` narrowing.
-    """
-    if not isinstance(value, dict):
+def _as_json_object(*, value: object) -> dict[str, _JSONValue] | None:
+    """Return ``value`` as a JSON object, or ``None``."""
+    try:
+        return TypeAdapter(type=dict[str, _JSONValue]).validate_python(
+            value,
+            strict=True,
+        )
+    except ValidationError:
         return None
-    decoded: Any = json.loads(s=json.dumps(obj=value))
-    typed: dict[str, Any] = decoded
-    return typed
 
 
-def _as_object_list(*, value: object) -> list[object] | None:
-    """Return ``value`` as a list of objects, or ``None``."""
-    if not isinstance(value, list):
+def _as_json_list(*, value: object) -> list[_JSONValue] | None:
+    """Return ``value`` as a JSON array, or ``None``."""
+    try:
+        return TypeAdapter(type=list[_JSONValue]).validate_python(
+            value,
+            strict=True,
+        )
+    except ValidationError:
         return None
-    decoded: Any = json.loads(s=json.dumps(obj=value))
-    typed: list[object] = decoded
-    return typed
 
 
 def pytest_addoption(parser: pytest.Parser) -> None:
@@ -87,22 +91,24 @@ def pytest_collection_modifyitems(
             item.add_marker(marker=skip_network)
 
 
-def _fix_schema_required(*, schema: dict[str, Any]) -> dict[str, Any]:
+def _fix_schema_required(
+    *, schema: dict[str, _JSONValue]
+) -> dict[str, _JSONValue]:
     """Normalize Swagger-style ``required`` flags for OpenAPI 3
     schemas.
     """
-    result: dict[str, Any] = dict(schema)
-    props = _as_str_keyed_dict(value=result.get("properties"))
+    result = dict(schema)
+    props = _as_json_object(value=result.get("properties"))
     if props is not None:
-        required_names: list[str] = []
-        existing_required = _as_object_list(value=result.get("required"))
+        required_names: list[_JSONValue] = []
+        existing_required = _as_json_list(value=result.get("required"))
         if existing_required is not None:
             required_names.extend(
                 name for name in existing_required if isinstance(name, str)
             )
-        fixed_props: dict[str, Any] = {}
+        fixed_props: dict[str, _JSONValue] = {}
         for prop_name, prop_schema_raw in props.items():
-            prop_schema = _as_str_keyed_dict(value=prop_schema_raw)
+            prop_schema = _as_json_object(value=prop_schema_raw)
             if prop_schema is None:
                 continue
             fixed_prop = _fix_schema_required(schema=prop_schema)
@@ -113,28 +119,30 @@ def _fix_schema_required(*, schema: dict[str, Any]) -> dict[str, Any]:
                 required_names.append(prop_name)
             fixed_props[prop_name] = fixed_prop
         result["properties"] = fixed_props
-        if required_names:
+        if bool(required_names):
             result["required"] = required_names
         elif "required" in result and not isinstance(result["required"], list):
-            result.pop("required", None)
-    items = _as_str_keyed_dict(value=result.get("items"))
+            _ = result.pop("required", None)
+    items = _as_json_object(value=result.get("items"))
     if items is not None:
         result["items"] = _fix_schema_required(schema=items)
     return result
 
 
-def _migrate_body_parameter(*, operation: dict[str, Any]) -> dict[str, Any]:
+def _migrate_body_parameter(
+    *, operation: dict[str, _JSONValue]
+) -> dict[str, _JSONValue]:
     """Convert Swagger 2 ``in: body`` parameters to OpenAPI 3
     requestBody.
     """
-    result: dict[str, Any] = dict(operation)
-    params = _as_object_list(value=result.get("parameters"))
+    result = dict(operation)
+    params = _as_json_list(value=result.get("parameters"))
     if params is None:
         return result
-    kept: list[object] = []
-    body_param: dict[str, Any] | None = None
+    kept: list[_JSONValue] = []
+    body_param: dict[str, _JSONValue] | None = None
     for param_raw in params:
-        param = _as_str_keyed_dict(value=param_raw)
+        param = _as_json_object(value=param_raw)
         if param is not None and param.get("in") == "body":
             body_param = param
         else:
@@ -142,8 +150,8 @@ def _migrate_body_parameter(*, operation: dict[str, Any]) -> dict[str, Any]:
     result["parameters"] = kept
     if body_param is not None and "requestBody" not in result:
         schema_raw = body_param.get("schema", {})
-        schema: object = schema_raw
-        schema_dict = _as_str_keyed_dict(value=schema_raw)
+        schema: _JSONValue = schema_raw
+        schema_dict = _as_json_object(value=schema_raw)
         if schema_dict is not None:
             schema = _fix_schema_required(schema=schema_dict)
         result["requestBody"] = {
@@ -153,30 +161,33 @@ def _migrate_body_parameter(*, operation: dict[str, Any]) -> dict[str, Any]:
     return result
 
 
-def _prepare_openapi_spec(*, spec: dict[str, object]) -> dict[str, object]:
+def _prepare_openapi_spec(
+    *, spec: dict[str, _JSONValue]
+) -> dict[str, _JSONValue]:
     """Normalize the HackerRank OpenAPI document for mock route
     registration.
     """
-    prepared: dict[str, object] = dict(spec)
-    raw_paths = _as_str_keyed_dict(value=prepared.get("paths", {}))
+    prepared = dict(spec)
+    raw_paths = _as_json_object(value=prepared.get("paths", {}))
     if raw_paths is None:
         return prepared
 
-    cleaned_paths: dict[str, dict[str, object]] = {}
+    cleaned_paths: dict[str, dict[str, _JSONValue]] = {}
     for raw_key, raw_value_obj in raw_paths.items():
-        raw_value = _as_str_keyed_dict(value=raw_value_obj)
+        raw_value = _as_json_object(value=raw_value_obj)
         if raw_value is None:
             continue
         cleaned = raw_key.split(sep="?", maxsplit=1)[0]
-        merged: dict[str, object] = dict(cleaned_paths.get(cleaned, {}))
+        merged = dict(cleaned_paths.get(cleaned, {}))
         for op_key, op_val_obj in raw_value.items():
-            op_val = _as_str_keyed_dict(value=op_val_obj)
+            op_val = _as_json_object(value=op_val_obj)
             if op_key in _HTTP_METHODS and op_val is not None:
                 merged[op_key] = _migrate_body_parameter(operation=op_val)
             else:
                 merged[op_key] = op_val_obj
         cleaned_paths[cleaned] = merged
-    prepared["paths"] = cleaned_paths
+    json_paths = dict[str, _JSONValue](cleaned_paths)
+    prepared["paths"] = json_paths
     return prepared
 
 
@@ -195,7 +206,10 @@ def fixture_mock_hackerrank_api(
     """
     openapi_spec_path = request.config.rootpath / "openapi.json"
     spec_text = openapi_spec_path.read_text(encoding="utf-8")
-    openapi_spec: dict[str, object] = json.loads(s=spec_text)
+    openapi_spec = TypeAdapter(type=dict[str, _JSONValue]).validate_json(
+        spec_text,
+        strict=True,
+    )
     openapi_spec = _prepare_openapi_spec(spec=openapi_spec)
     with respx.mock(
         base_url=_BASE_URL,

{hackerrank-2026.9.7 → hackerrank-2026.9.16}/docs/source/contributing.rst

@@ -12,7 +12,7 @@ Install Python dependencies in a virtual environment.
 
 .. code-block:: console
 
-   $ pip install --editable '.[dev]'
+   $ pip install --editable . --group dev
 
 Spell checking requires ``enchant``.
 This can be installed on macOS, for example, with `Homebrew`_:
@@ -58,14 +58,10 @@ Run ``pytest``:
 Changelog entries
 -----------------
 
-Add one news fragment per user-facing change, as
-:file:`newsfragments/<issue-number>.change.rst`, containing a single
-sentence in the past or present tense.
+Add one news fragment per user-facing change, as :file:`newsfragments/<issue-number>.change.rst`, containing a single sentence in the past or present tense.
 
-``towncrier`` collects fragments by that exact filename pattern at
-release time and silently ignores anything else, including a fragment
-filed in a subdirectory, so a misnamed fragment never reaches the
-changelog. A test guards against this.
+``towncrier`` collects fragments by that exact filename pattern at release time and silently ignores anything else, including a fragment filed in a subdirectory, so a fragment with the wrong name never reaches the changelog.
+A test guards against this.
 
 Documentation
 -------------
@@ -76,7 +72,7 @@ Run the following commands to build and view documentation locally:
 
 .. code-block:: console
 
-   $ uv run --extra=dev sphinx-build -M html docs/source docs/build -W
+   $ uv run --group=dev sphinx-build -M html docs/source docs/build -W
    $ python -c 'import os, webbrowser; webbrowser.open("file://" + os.path.abspath("docs/build/html/index.html"))'
 
 Continuous integration

{hackerrank-2026.9.7 → hackerrank-2026.9.16}/docs/source/index.rst

@@ -13,8 +13,7 @@ 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`:
+Generate an API token from the `HackerRank for Work tokens page`_ and pass it to :class:`hackerrank.client.HackerRank`:
 
 .. code-block:: python
 
@@ -26,16 +25,16 @@ it to :class:`hackerrank.client.HackerRank`:
 
    client = HackerRank(api_key="your-api-key")
    for test in client.tests.list().data:
-       sys.stdout.write(test.name)
+       _ = sys.stdout.write(test.name)
    interview = client.interviews.create(title="My Interview")
-   sys.stdout.write(interview.url or "")
+   _ = sys.stdout.write(interview.url)
 
 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.
+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
 
@@ -51,11 +50,11 @@ HTTPX2 transport explicitly and pass it to the client. The standard
        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.
+The ``timeout`` argument accepts an HTTPX2 timeout object or a number of seconds.
+Pass only HTTPX2 timeout objects 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-2026.9.7 → hackerrank-2026.9.16}/docs/source/openapi-spec.rst

@@ -1,8 +1,7 @@
 OpenAPI Spec
 ============
 
-The OpenAPI spec used to generate this library is the Swagger spec served at
-``https://www.hackerrank.com/apidoc``.
+The OpenAPI spec used to generate this library is the Swagger spec served at ``https://www.hackerrank.com/apidoc``.
 This is the spec that backs the `HackerRank for Work API documentation`_.
 
 .. _HackerRank for Work API documentation: https://www.hackerrank.com/work/apidocs

{hackerrank-2026.9.7 → hackerrank-2026.9.16}/docs/source/unreleased.rst

@@ -1,8 +1,7 @@
 Unreleased changes
 ==================
 
-Changes that have landed on the main branch but are not yet part of a
-tagged release.  These entries are assembled into the
-:doc:`changelog` when the next release is published.
+Changes that have landed on the main branch but are not yet part of a tagged release.
+These entries are assembled into the :doc:`changelog` when the next release is published.
 
 .. towncrier-draft-entries::