hackerrank-cli 2026.10.30__tar.gz → 2026.11.7__tar.gz

{hackerrank_cli-2026.10.30 → hackerrank_cli-2026.11.7}/.github/workflows/binaries.yml

@@ -67,7 +67,7 @@ jobs:
       - name: Import the Developer ID certificate
         id: signing_certificate
         if: runner.os == 'macOS' && inputs.notarize
-        uses: Apple-Actions/import-codesign-certs@77ba2a2a8f5cfc8c405ebf3159f767c323e238f9  # v7.1.0
+        uses: Apple-Actions/import-codesign-certs@288b8ec97b82c66b6f2a6baaf7acc8dfbcbe331c  # v7.2.0
         with:
           p12-file-base64: ${{ secrets.DEVELOPER_ID_APP_CERT_P12_BASE64 }}
           p12-password: ${{ secrets.DEVELOPER_ID_APP_CERT_PASSWORD }}

{hackerrank_cli-2026.10.30 → hackerrank_cli-2026.11.7}/Dockerfile

@@ -4,12 +4,14 @@ COPY --from=ghcr.io/astral-sh/uv:0.13.0 /uv /bin/uv
 WORKDIR /build
 COPY . .
 ARG HACKERRANK_CLI_VERSION=0.0.0
+RUN apt-get update && apt-get install -y --no-install-recommends git && rm -rf /var/lib/apt/lists/*
 RUN SETUPTOOLS_SCM_PRETEND_VERSION_FOR_HACKERRANK_CLI=$HACKERRANK_CLI_VERSION uv build --wheel --out-dir /wheels
+RUN uv pip compile pyproject.toml -o /tmp/runtime.txt && uv run --no-project --with pip python -m pip wheel --wheel-dir /wheels -r /tmp/runtime.txt
 
 FROM python:3.13-slim
 LABEL org.opencontainers.image.source="https://github.com/adamtheturtle/hackerrank-cli"
 LABEL org.opencontainers.image.description="Upload HackerRank question starter code"
 LABEL org.opencontainers.image.licenses="MIT"
 COPY --from=build /wheels /wheels
-RUN pip install --no-cache-dir /wheels/*.whl && rm -rf /wheels
+RUN pip install --no-cache-dir --no-index --no-deps /wheels/*.whl && rm -rf /wheels
 ENTRYPOINT ["hackerrank"]

{hackerrank_cli-2026.10.30/src/hackerrank_cli.egg-info → hackerrank_cli-2026.11.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hackerrank-cli
-Version: 2026.10.30
+Version: 2026.11.7
 Summary: Upload starter files to existing HackerRank project questions.
 Author-email: Adam Dangoor <adamdangoor@gmail.com>
 License-Expression: MIT
@@ -19,7 +19,7 @@ Requires-Python: >=3.13
 Description-Content-Type: text/x-rst
 License-File: LICENSE
 Requires-Dist: click<8.6,>=8.3
-Requires-Dist: hackerrank>=2026.10.30
+Requires-Dist: hackerrank>=2026.11.7
 Requires-Dist: httpx>=0.28
 Requires-Dist: httpx2>=2.12
 Requires-Dist: pathspec>=1
@@ -184,3 +184,28 @@ Prompts may contain up to 15,000 characters.
 Text is sent exactly as read, including whitespace and line endings.
 An empty file explicitly clears the prompt.
 The command reads the question first to preserve its other metadata.
+
+Complete API access
+-------------------
+
+The ``api`` command group exposes all 76 documented v3, ATS and SCIM
+operations.
+Use ``hackerrank api operations`` to list names and ``api describe OPERATION``
+to inspect parameters and body schemas.
+
+.. code-block:: console
+
+   hackerrank api call api_list_all_tests --query '{"limit": 10}'
+   hackerrank api call api_update_interviewer_note --path '{"interview_id": "123"}' --body-file note.json --dry-run
+
+``--path`` and ``--query`` accept JSON objects.
+``--body-file`` reads a JSON object from a UTF-8 file, or stdin when set to
+``-``.
+Real v3 requests use ``HACKERRANK_API_TOKEN``.
+SCIM requests use their own ``HACKERRANK_SCIM_API_TOKEN`` and provisioning
+host.
+Dry runs validate requests before reading credentials and make no API calls.
+Responses include status, headers and complete JSON data, including empty and
+pending responses.
+
+The complete API commands require ``hackerrank>=2026.11.7``.

{hackerrank_cli-2026.10.30 → hackerrank_cli-2026.11.7}/README.rst

@@ -157,3 +157,28 @@ Prompts may contain up to 15,000 characters.
 Text is sent exactly as read, including whitespace and line endings.
 An empty file explicitly clears the prompt.
 The command reads the question first to preserve its other metadata.
+
+Complete API access
+-------------------
+
+The ``api`` command group exposes all 76 documented v3, ATS and SCIM
+operations.
+Use ``hackerrank api operations`` to list names and ``api describe OPERATION``
+to inspect parameters and body schemas.
+
+.. code-block:: console
+
+   hackerrank api call api_list_all_tests --query '{"limit": 10}'
+   hackerrank api call api_update_interviewer_note --path '{"interview_id": "123"}' --body-file note.json --dry-run
+
+``--path`` and ``--query`` accept JSON objects.
+``--body-file`` reads a JSON object from a UTF-8 file, or stdin when set to
+``-``.
+Real v3 requests use ``HACKERRANK_API_TOKEN``.
+SCIM requests use their own ``HACKERRANK_SCIM_API_TOKEN`` and provisioning
+host.
+Dry runs validate requests before reading credentials and make no API calls.
+Responses include status, headers and complete JSON data, including empty and
+pending responses.
+
+The complete API commands require ``hackerrank>=2026.11.7``.

hackerrank_cli-2026.11.7/VERSION

@@ -0,0 +1 @@
+2026.11.7

hackerrank_cli-2026.11.7/docs/source/changelog/2026.11.7.md

@@ -0,0 +1,7 @@
+# 2026.11.7 (2026-11-07)
+
+## Features
+
+- Expose all documented HackerRank v3, ATS and SCIM operations through the API
+  command group, with offline discovery and validation.
+  ([#69](https://github.com/adamtheturtle/hackerrank-cli/issues/69))

{hackerrank_cli-2026.10.30 → hackerrank_cli-2026.11.7}/docs/source/development.rst

@@ -6,7 +6,7 @@ This standalone repository follows ``coderpad-cli`` main at
 It adapts the src layout, Click entry points, setuptools-scm versions, uv
 lockfile, strict checks, 100% branch coverage, Sphinx, Towncrier, and
 distribution workflows.
-The SDK baseline is the released ``hackerrank==2026.10.30`` in ``uv.lock``.
+The SDK baseline is the released ``hackerrank==2026.11.7`` in ``uv.lock``.
 Python 3.13 or later is required by the SDK.
 
 The released SDK exposes ``questions.upload_project_zip``.

{hackerrank_cli-2026.10.30 → hackerrank_cli-2026.11.7}/flake.nix

@@ -52,6 +52,19 @@
         else
           "0.0.0+${self.shortRev or self.dirtyShortRev or "unknown"}";
 
+      # The pinned SDK is built from source, so supply its build backend.
+      hackerrankSourceOverlay = final: prev: {
+        hackerrank = prev.hackerrank.overrideAttrs (old: {
+          nativeBuildInputs = (old.nativeBuildInputs or [ ]) ++ final.resolveBuildSystem {
+            setuptools = [ ];
+            setuptools-scm = [ ];
+          };
+          env = (old.env or { }) // {
+            SETUPTOOLS_SCM_PRETEND_VERSION = old.version;
+          };
+        });
+      };
+
       # Override hackerrank-cli to set the version
       hackerrankCliOverlay = final: prev: {
         hackerrank-cli = prev.hackerrank-cli.overrideAttrs (old: {
@@ -74,6 +87,7 @@
             lib.composeManyExtensions [
               pyproject-build-systems.overlays.wheel
               overlay
+              hackerrankSourceOverlay
               hackerrankCliOverlay
             ]
           )

{hackerrank_cli-2026.10.30 → hackerrank_cli-2026.11.7}/prek.toml

@@ -506,8 +506,6 @@ hooks = [
   {
     id = "vale-sync",
     name = "vale sync",
-    # The Python Vale wrapper may fail transiently while downloading its binary; see
-    # https://github.com/daniperez/vale-python-package/issues/77
     entry = "uv run --locked --group=dev vale sync",
     language = "system",
     pass_filenames = false,

{hackerrank_cli-2026.10.30 → hackerrank_cli-2026.11.7}/pyproject.toml

@@ -21,7 +21,13 @@ classifiers = [
   "Programming Language :: Python :: 3.15",
 ]
 dynamic = [ "version" ]
-dependencies = [ "click>=8.3,<8.6", "hackerrank>=2026.10.30", "httpx>=0.28", "httpx2>=2.12", "pathspec>=1" ]
+dependencies = [
+  "click>=8.3,<8.6",
+  "hackerrank>=2026.11.7",
+  "httpx>=0.28",
+  "httpx2>=2.12",
+  "pathspec>=1",
+]
 urls.Documentation = "https://adamtheturtle.github.io/hackerrank-cli/"
 urls.Issues = "https://github.com/adamtheturtle/hackerrank-cli/issues"
 urls.Source = "https://github.com/adamtheturtle/hackerrank-cli"
@@ -38,12 +44,12 @@ dev = [
   "doccmd==2026.9.16.1",
   "furo==2025.12.19",
   "interrogate==1.7.0",
-  "mypy==2.4.0",
+  "mypy==2.4.1",
   "mypy-pytest-parametrize==2026.10.5.1",
   "mypy-strict-kwargs==2026.10.19",
   "myst-parser==5.1.0",
   "no-defaults==2026.9.1",
-  "prek==0.5.7",
+  "prek==0.5.9",
   "pydocstringformatter==1.0.0",
   "pylint[spelling]==4.1.3",
   "pylint-per-file-ignores==4.0.0",
@@ -51,13 +57,13 @@ dev = [
   "pyrefly==1.4.0",
   "pyright==1.1.414",
   "pyroma==5.0.1",
-  "pytest==9.1.1",
+  "pytest==9.2.0",
   "pytest-beartype==0.3.0",
   "pytest-cov==7.1",
   "pytest-regressions==2.11.0",
   "pytest-xdist==3.8.0",
   "respx==0.23.1",
-  "ruff==0.17.2",
+  "ruff==0.17.3",
   "setuptools>=77",
   "setuptools-scm>=8.1",
   "shellcheck-py==0.11.0.1",
@@ -70,11 +76,11 @@ dev = [
   "strict-kwargs==2026.10.9",
   "towncrier==26.9",
   "twine==7.0.0",
-  "ty==0.0.92",
-  "vale==3.25.1.0",
+  "ty==0.0.96",
+  "vale==3.26.0.1",
   "vulture==2.16",
   "yamlfix==1.19.1",
-  "zizmor==1.31.1",
+  "zizmor==1.32.0",
 ]
 binary = [ "pyinstaller>=6.12" ]
 

{hackerrank_cli-2026.10.30 → hackerrank_cli-2026.11.7}/spelling_private_dict.txt

@@ -23,22 +23,26 @@ Symlinked
 Towncrier
 UTF
 Untagged
+api
 autofix
 backend
 backoff
 basename
 bugfix
+catalogue
 changelog
 cli
 dereference
 dereferenced
 dereferences
 dereferencing
+discoverable
 docstrings
 filesystem
 frontend
 fullstack
 hackerrank
+injectable
 jsonschema
 jsonschema's
 keychain
@@ -50,9 +54,11 @@ nonretryable
 prebuilt
 prek
 retryable
+schemas
 scm
 setuptools
 src
+stdin
 symlink
 symlinks
 uploader

{hackerrank_cli-2026.10.30 → hackerrank_cli-2026.11.7}/src/hackerrank_cli/__init__.py

@@ -15,6 +15,7 @@ from hackerrank.client import HackerRank
 from hackerrank.exceptions import HackerRankError
 from hackerrank.transports import Transport
 
+from hackerrank_cli._api import create_api_cli
 from hackerrank_cli._sources import PreparedSource, prepare_source
 
 
@@ -27,9 +28,7 @@ def create_cli(*, transport: Transport | None = None) -> click.Group:
         prog_name="hackerrank",
     )
     def cli() -> None:
-        """Upload starter files to existing HackerRank project
-        questions.
-        """
+        """Manage HackerRank uploads, prompts and the complete API."""
 
     @cli.group()
     def questions() -> None:
@@ -162,6 +161,7 @@ def create_cli(*, transport: Transport | None = None) -> click.Group:
     _ = questions.command()(set_system_prompt)
     _ = questions.command()(archive)
     _ = questions.command()(upload)
+    cli.add_command(cmd=create_api_cli(transport=transport))
     return cli
 
 

hackerrank_cli-2026.11.7/src/hackerrank_cli/_api.py

@@ -0,0 +1,205 @@
+"""Expose every documented API operation through the SDK catalogue."""
+
+import json
+import os
+from dataclasses import asdict, dataclass
+from typing import TextIO
+
+import click
+import httpx
+import httpx2
+from hackerrank.api import (
+    api_catalogue,
+    api_operations,
+    parse_api_object,
+    prepare_operation,
+)
+from hackerrank.client import HackerRank
+from hackerrank.exceptions import HackerRankError
+from hackerrank.transports import Transport
+from hackerrank.types import JSONValue
+
+
+@dataclass(frozen=True, kw_only=True)
+class APICommandRequest:
+    """The request inputs supplied to the API command."""
+
+    operation: str
+    path_json: str
+    query_json: str
+    body_file: TextIO | None
+
+
+def create_api_cli(*, transport: Transport | None) -> click.Group:
+    """Create catalogue, schema and execution commands with an injectable
+    transport.
+    """
+
+    @click.group(name="api")
+    def api() -> None:
+        """Call every documented v3, ATS and SCIM operation."""
+
+    def operations() -> None:
+        """List operation names, methods, paths and summaries without
+        credentials.
+        """
+        rows = [
+            {
+                "operation": value.id,
+                "method": value.method,
+                "path": value.path,
+                "summary": value.summary,
+                "group": value.group,
+            }
+            for value in api_operations().values()
+        ]
+        click.echo(message=json.dumps(obj=rows, indent=2))
+
+    @click.argument("operation")
+    def describe(operation: str) -> None:
+        """Show an operation's parameters, body schema and referenced
+        definitions.
+        """
+        selected = api_operations().get(operation)
+        if selected is None:
+            raise click.BadParameter(
+                message="Unknown API operation.", param_hint="OPERATION"
+            )
+        click.echo(
+            message=json.dumps(
+                obj={
+                    "operation": asdict(obj=selected),
+                    "definitions": api_catalogue()["definitions"],
+                },
+                indent=2,
+            )
+        )
+
+    @click.argument("operation")
+    @click.option(
+        "--path",
+        "path_json",
+        default="{}",
+        help="JSON object of path parameters.",
+    )
+    @click.option(
+        "--query",
+        "query_json",
+        default="{}",
+        help="JSON object of query fields; arrays use CSV encoding.",
+    )
+    @click.option(
+        "--body-file",
+        type=click.File(mode="r", encoding="utf-8"),
+        help="JSON request body file, or - for stdin.",
+    )
+    @click.option(
+        "--dry-run",
+        is_flag=True,
+        help="Validate without credentials or network access.",
+    )
+    def call(
+        operation: str,
+        path_json: str,
+        query_json: str,
+        body_file: TextIO | None,
+        *,
+        dry_run: bool,
+    ) -> None:
+        """Execute OPERATION and print status, headers and complete JSON
+        data.
+        """
+        _call_api(
+            request=APICommandRequest(
+                operation=operation,
+                path_json=path_json,
+                query_json=query_json,
+                body_file=body_file,
+            ),
+            dry_run=dry_run,
+            transport=transport,
+        )
+
+    _ = api.command(name="operations")(operations)
+    _ = api.command(name="describe")(describe)
+    _ = api.command(name="call")(call)
+    return api
+
+
+def _path_parameters(*, values: dict[str, JSONValue]) -> dict[str, str | int]:
+    """Reject structured values before the SDK encodes path segments."""
+    result: dict[str, str | int] = {}
+    for name, value in values.items():
+        if isinstance(value, bool) or not isinstance(value, str | int):
+            message = "Path parameters must be strings or integers."
+            raise TypeError(message)
+        result[name] = value
+    return result
+
+
+def _call_api(
+    *,
+    request: APICommandRequest,
+    dry_run: bool,
+    transport: Transport | None,
+) -> None:
+    """Prepare a request before credential access, then execute it through
+    the SDK.
+    """
+    operation = request.operation
+    path_json = request.path_json
+    query_json = request.query_json
+    body_file = request.body_file
+    try:
+        path_values = parse_api_object(text=path_json)
+        path_parameters = _path_parameters(values=path_values)
+        query = parse_api_object(text=query_json)
+        body = (
+            None
+            if body_file is None
+            else parse_api_object(text=body_file.read())
+        )
+        selected, path, _ = prepare_operation(
+            operation=operation,
+            path_parameters=path_parameters,
+            query=query,
+            body=body,
+        )
+    except (ValueError, TypeError, OSError) as error:
+        raise click.BadParameter(
+            message=f"Invalid API input: {error}"
+        ) from None
+    if dry_run:
+        click.echo(message=f"Would call {selected.method} {path}")
+        return
+    variable = (
+        "HACKERRANK_SCIM_API_TOKEN"
+        if selected.scim
+        else "HACKERRANK_API_TOKEN"
+    )
+    credential = os.environ.get(key=variable, default="")
+    if not bool(credential.strip()):
+        raise click.ClickException(
+            message=f"Set {variable} to a nonblank API token."
+        )
+    try:
+        with HackerRank(
+            api_key="scim-only" if selected.scim else credential,
+            transport=transport,
+        ) as client:
+            response = client.api.call(
+                operation=operation,
+                path_parameters=path_parameters,
+                query=query,
+                body=body,
+                scim_api_key=credential if selected.scim else None,
+            )
+    except HackerRankError as error:
+        raise click.ClickException(
+            message=f"HackerRank request failed (HTTP {error.status_code})."
+        ) from None
+    except (httpx.TransportError, httpx2.TransportError):
+        raise click.ClickException(
+            message="Could not reach HackerRank."
+        ) from None
+    click.echo(message=json.dumps(obj=asdict(obj=response), indent=2))

{hackerrank_cli-2026.10.30 → hackerrank_cli-2026.11.7}/src/hackerrank_cli/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '2026.10.30'
-__version_tuple__ = version_tuple = (2026, 10, 30)
+__version__ = version = '2026.11.7'
+__version_tuple__ = version_tuple = (2026, 11, 7)
 
-__commit_id__ = commit_id = 'gf7fd0dcbf'
+__commit_id__ = commit_id = 'gaed479392'

{hackerrank_cli-2026.10.30 → hackerrank_cli-2026.11.7/src/hackerrank_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hackerrank-cli
-Version: 2026.10.30
+Version: 2026.11.7
 Summary: Upload starter files to existing HackerRank project questions.
 Author-email: Adam Dangoor <adamdangoor@gmail.com>
 License-Expression: MIT
@@ -19,7 +19,7 @@ Requires-Python: >=3.13
 Description-Content-Type: text/x-rst
 License-File: LICENSE
 Requires-Dist: click<8.6,>=8.3
-Requires-Dist: hackerrank>=2026.10.30
+Requires-Dist: hackerrank>=2026.11.7
 Requires-Dist: httpx>=0.28
 Requires-Dist: httpx2>=2.12
 Requires-Dist: pathspec>=1
@@ -184,3 +184,28 @@ Prompts may contain up to 15,000 characters.
 Text is sent exactly as read, including whitespace and line endings.
 An empty file explicitly clears the prompt.
 The command reads the question first to preserve its other metadata.
+
+Complete API access
+-------------------
+
+The ``api`` command group exposes all 76 documented v3, ATS and SCIM
+operations.
+Use ``hackerrank api operations`` to list names and ``api describe OPERATION``
+to inspect parameters and body schemas.
+
+.. code-block:: console
+
+   hackerrank api call api_list_all_tests --query '{"limit": 10}'
+   hackerrank api call api_update_interviewer_note --path '{"interview_id": "123"}' --body-file note.json --dry-run
+
+``--path`` and ``--query`` accept JSON objects.
+``--body-file`` reads a JSON object from a UTF-8 file, or stdin when set to
+``-``.
+Real v3 requests use ``HACKERRANK_API_TOKEN``.
+SCIM requests use their own ``HACKERRANK_SCIM_API_TOKEN`` and provisioning
+host.
+Dry runs validate requests before reading credentials and make no API calls.
+Responses include status, headers and complete JSON data, including empty and
+pending responses.
+
+The complete API commands require ``hackerrank>=2026.11.7``.

{hackerrank_cli-2026.10.30 → hackerrank_cli-2026.11.7}/src/hackerrank_cli.egg-info/SOURCES.txt

@@ -40,9 +40,11 @@ docs/source/changelog/2026.10.1.1.md
 docs/source/changelog/2026.10.30.md
 docs/source/changelog/2026.10.7.md
 docs/source/changelog/2026.10.8.md
+docs/source/changelog/2026.11.7.md
 newsfragments/.gitkeep
 src/hackerrank_cli/__init__.py
 src/hackerrank_cli/__main__.py
+src/hackerrank_cli/_api.py
 src/hackerrank_cli/_sources.py
 src/hackerrank_cli/_version.py
 src/hackerrank_cli/py.typed
@@ -58,6 +60,7 @@ src/hackerrank_cli.egg-info/top_level.txt
 styles/snapper/LongProseLine.yml
 styles/snapper/SemanticLineBreaks.yml
 tests/__init__.py
+tests/test_api.py
 tests/test_archive.py
 tests/test_cli.py
 tests/test_help.py

{hackerrank_cli-2026.10.30 → hackerrank_cli-2026.11.7}/src/hackerrank_cli.egg-info/requires.txt

@@ -1,5 +1,5 @@
 click<8.6,>=8.3
-hackerrank>=2026.10.30
+hackerrank>=2026.11.7
 httpx>=0.28
 httpx2>=2.12
 pathspec>=1

{hackerrank_cli-2026.10.30 → hackerrank_cli-2026.11.7}/src/hackerrank_cli.egg-info/scm_file_list.json

@@ -28,6 +28,7 @@
     "docs/source/changelog/2026.10.30.md",
     "docs/source/changelog/2026.10.7.md",
     "docs/source/changelog/2026.10.8.md",
+    "docs/source/changelog/2026.11.7.md",
     "docs/source/cli.rst",
     "docs/source/conf.py",
     "docs/source/development.rst",
@@ -43,11 +44,13 @@
     "spelling_private_dict.txt",
     "src/hackerrank_cli/__init__.py",
     "src/hackerrank_cli/__main__.py",
+    "src/hackerrank_cli/_api.py",
     "src/hackerrank_cli/_sources.py",
     "src/hackerrank_cli/py.typed",
     "styles/snapper/LongProseLine.yml",
     "styles/snapper/SemanticLineBreaks.yml",
     "tests/__init__.py",
+    "tests/test_api.py",
     "tests/test_archive.py",
     "tests/test_cli.py",
     "tests/test_help.py",

hackerrank_cli-2026.11.7/src/hackerrank_cli.egg-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "2026.11.7",
+  "distance": 0,
+  "node": "gaed479392ff0082e9c01ce4abba61fb0da024195",
+  "dirty": false,
+  "branch": "HEAD",
+  "node_date": "2026-11-07"
+}