hackerrank-cli 2026.10.1.1__tar.gz

hackerrank_cli-2026.10.1.1/.dockerignore

@@ -0,0 +1,11 @@
+.git
+.venv
+__pycache__
+*.egg-info
+build
+dist
+docs/build
+.pytest_cache
+.mypy_cache
+.ruff_cache
+.coverage*

hackerrank_cli-2026.10.1.1/.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

hackerrank_cli-2026.10.1.1/.github/dependabot.yml

@@ -0,0 +1,12 @@
+---
+version: 2
+
+updates:
+  - package-ecosystem: uv
+    directory: /
+    schedule:
+      interval: daily
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly

hackerrank_cli-2026.10.1.1/.github/workflows/autofix.yml

@@ -0,0 +1,28 @@
+---
+name: autofix.ci
+
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  autofix:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@v10.2.0
+        with:
+          version: 0.12.19
+          python-version: '3.13'
+      - name: Run repository fixers and checks
+        run: uv run --locked prek run --all-files --stage pre-commit --no-fail-fast
+      - uses: autofix-ci/action@v1.3.4
+        if: always()

hackerrank_cli-2026.10.1.1/.github/workflows/binaries.yml

@@ -0,0 +1,135 @@
+---
+name: Standalone binaries
+
+on:
+  workflow_dispatch:
+    inputs:
+      notarize:
+        description: Sign and notarize the macOS artifact without publishing a release
+        type: boolean
+        default: false
+  workflow_call:
+    inputs:
+      notarize:
+        description: Require Developer ID signing and notarization for macOS releases
+        type: boolean
+        default: false
+    secrets:
+      DEVELOPER_ID_APP_CERT_P12_BASE64:
+        required: false
+      DEVELOPER_ID_APP_CERT_PASSWORD:
+        required: false
+      APPLE_ID:
+        required: false
+      APPLE_TEAM_ID:
+        required: false
+      APPLE_APP_PASSWORD:
+        required: false
+
+permissions:
+  contents: read
+
+jobs:
+  binary:
+    if: ${{ !inputs.notarize || github.ref == 'refs/heads/main' || startsWith(github.ref, 'refs/tags/20') }}
+    strategy:
+      matrix:
+        include:
+          - os: ubuntu-latest
+            name: hackerrank-linux
+          - os: macos-latest
+            name: hackerrank-macos
+          - os: windows-latest
+            name: hackerrank-windows
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+          fetch-depth: 0
+      - uses: astral-sh/setup-uv@v10.2.0
+        with:
+          version: 0.12.19
+          python-version: '3.13'
+      - name: Require release credentials
+        if: runner.os == 'macOS' && inputs.notarize
+        env:
+          CERTIFICATE: ${{ secrets.DEVELOPER_ID_APP_CERT_P12_BASE64 }}
+          CERTIFICATE_PASSWORD: ${{ secrets.DEVELOPER_ID_APP_CERT_PASSWORD }}
+          APPLE_ID: ${{ secrets.APPLE_ID }}
+          APPLE_TEAM_ID: ${{ secrets.APPLE_TEAM_ID }}
+          APPLE_APP_PASSWORD: ${{ secrets.APPLE_APP_PASSWORD }}
+        run: |
+          : "${CERTIFICATE:?Missing DEVELOPER_ID_APP_CERT_P12_BASE64}"
+          : "${CERTIFICATE_PASSWORD:?Missing DEVELOPER_ID_APP_CERT_PASSWORD}"
+          : "${APPLE_ID:?Missing APPLE_ID}" "${APPLE_TEAM_ID:?Missing APPLE_TEAM_ID}" "${APPLE_APP_PASSWORD:?Missing APPLE_APP_PASSWORD}"
+      # The action removes its temporary keychain in its post step.
+      - name: Import the Developer ID certificate
+        if: runner.os == 'macOS' && inputs.notarize
+        uses: Apple-Actions/import-codesign-certs@5142e029c445c10ffc7149d172e540235a065466  # v7.0.0
+        with:
+          p12-file-base64: ${{ secrets.DEVELOPER_ID_APP_CERT_P12_BASE64 }}
+          p12-password: ${{ secrets.DEVELOPER_ID_APP_CERT_PASSWORD }}
+      - name: Build binary
+        shell: bash
+        env:
+          NAME: ${{ matrix.name }}
+          NOTARIZE: ${{ inputs.notarize }}
+        run: |
+          signing=()
+          if [ "$RUNNER_OS" = macOS ] && [ "$NOTARIZE" = true ]; then
+            # Sign embedded libraries before packing the one-file archive.
+            # PyInstaller enables the hardened runtime and secure timestamp.
+            signing=(--codesign-identity "Developer ID Application")
+          fi
+          uv run --locked --group binary pyinstaller --clean --onefile --copy-metadata hackerrank-cli --name "$NAME" "${signing[@]}" bin/hackerrank_wrapper.py
+      - name: Verify Developer ID signature
+        if: runner.os == 'macOS' && inputs.notarize
+        run: codesign --verify --strict --verbose=2 dist/hackerrank-macos
+      - name: Smoke binary
+        shell: bash
+        env:
+          NAME: ${{ matrix.name }}
+        run: |
+          executable="dist/$NAME"
+          if [ "$RUNNER_OS" = Windows ]; then executable="$executable.exe"; fi
+          "$executable" --help
+          "$executable" --version
+          "$executable" questions upload --help
+      - name: Notarize macOS binary
+        if: runner.os == 'macOS' && inputs.notarize
+        env:
+          APPLE_ID: ${{ secrets.APPLE_ID }}
+          APPLE_TEAM_ID: ${{ secrets.APPLE_TEAM_ID }}
+          APPLE_APP_PASSWORD: ${{ secrets.APPLE_APP_PASSWORD }}
+        run: |
+          archive="$RUNNER_TEMP/hackerrank-macos.zip"
+          result="$RUNNER_TEMP/notarization.json"
+          ditto -c -k --sequesterRsrc dist/hackerrank-macos "$archive"
+          xcrun notarytool submit "$archive" \
+            --apple-id "$APPLE_ID" --team-id "$APPLE_TEAM_ID" --password "$APPLE_APP_PASSWORD" \
+            --wait --timeout 30m --output-format json > "$result" || true
+          cat "$result"
+          # A rejected submission can still return exit status zero.
+          if ! jq -e '.status == "Accepted"' "$result" > /dev/null; then
+            submission_id=$(jq -r '.id // empty' "$result")
+            if [ -n "$submission_id" ]; then
+              xcrun notarytool log "$submission_id" \
+                --apple-id "$APPLE_ID" --team-id "$APPLE_TEAM_ID" --password "$APPLE_APP_PASSWORD" || true
+            fi
+            exit 1
+          fi
+      # A bare Mach-O cannot be stapled. Verify the online ticket, allowing
+      # time for Apple's service to propagate it after acceptance.
+      - name: Verify notarization ticket
+        if: runner.os == 'macOS' && inputs.notarize
+        uses: nick-fields/retry@v4
+        with:
+          timeout_seconds: 60
+          max_attempts: 10
+          retry_wait_seconds: 30
+          command: codesign -vvvv -R="notarized" --check-notarization dist/hackerrank-macos
+      - uses: actions/upload-artifact@v7
+        with:
+          name: ${{ matrix.name }}
+          path: dist/hackerrank-*

hackerrank_cli-2026.10.1.1/.github/workflows/ci.yml

@@ -0,0 +1,56 @@
+---
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+  schedule:
+    - cron: 0 1 * * *
+
+permissions:
+  contents: read
+
+jobs:
+  tests:
+    strategy:
+      matrix:
+        python: ['3.13', '3.14']
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+          fetch-depth: 0
+      - uses: astral-sh/setup-uv@v10.2.0
+        with:
+          version: 0.12.19
+          python-version: ${{ matrix.python }}
+          enable-cache: true
+      - run: uv run --locked pytest
+  package:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+          fetch-depth: 0
+      - uses: astral-sh/setup-uv@v10.2.0
+        with:
+          version: 0.12.19
+          python-version: '3.13'
+      - run: uv build
+      - run: uv run --locked twine check dist/*
+      - run: uv run --locked check-wheel-contents dist/*.whl
+      - name: Smoke installed wheel
+        run: |
+          uv venv /tmp/hackerrank-wheel
+          uv pip install --python /tmp/hackerrank-wheel/bin/python dist/*.whl
+          cd /tmp
+          /tmp/hackerrank-wheel/bin/hackerrank --help
+          /tmp/hackerrank-wheel/bin/hackerrank --version
+          /tmp/hackerrank-wheel/bin/python -m hackerrank_cli questions upload --help
+      - run: docker build -t hackerrank-cli .
+      - run: docker run --rm hackerrank-cli --help

hackerrank_cli-2026.10.1.1/.github/workflows/dependabot-merge.yml

@@ -0,0 +1,19 @@
+---
+
+name: Dependabot auto-merge
+on: pull_request
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  dependabot:
+    runs-on: ubuntu-latest
+    if: github.event.pull_request.user.login == 'dependabot[bot]'
+    steps:
+      - name: Enable auto-merge for Dependabot PRs
+        run: gh pr merge --auto --merge "$PR_URL"
+        env:
+          PR_URL: ${{github.event.pull_request.html_url}}
+          GH_TOKEN: ${{secrets.GITHUB_TOKEN}}

hackerrank_cli-2026.10.1.1/.github/workflows/docs.yml

@@ -0,0 +1,31 @@
+---
+name: Documentation
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  docs:
+    runs-on: ubuntu-latest
+    steps:
+      - run: sudo apt-get update && sudo apt-get install --yes libenchant-2-2 hunspell-en-us
+      - uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+          fetch-depth: 0
+      - uses: astral-sh/setup-uv@v10.2.0
+        with:
+          version: 0.12.19
+          python-version: '3.13'
+      - run: uv run --locked prek run --all-files --stage manual --group docs
+      - run: uv run --locked towncrier build --draft --version unreleased
+      - uses: actions/upload-artifact@v7
+        with:
+          name: documentation
+          path: docs/build/html

hackerrank_cli-2026.10.1.1/.github/workflows/lint.yml

@@ -0,0 +1,37 @@
+---
+name: Lint
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+  schedule:
+    - cron: 0 1 * * *
+
+permissions:
+  contents: read
+
+jobs:
+  lint:
+    name: ${{ matrix.os == 'ubuntu-latest' && 'lint' || 'lint-windows' }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - if: runner.os == 'Linux'
+        run: sudo apt-get update && sudo apt-get install --yes libenchant-2-2 hunspell-en-us
+      - uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+          fetch-depth: 0
+      - uses: astral-sh/setup-uv@v10.2.0
+        with:
+          version: 0.12.19
+          python-version: '3.13'
+          enable-cache: true
+      - run: uv run --locked prek run --all-files --no-fail-fast
+      - run: uv run --locked prek run --all-files --no-fail-fast --stage pre-push
+      - run: uv run --locked prek run --all-files --no-fail-fast --stage manual

hackerrank_cli-2026.10.1.1/.github/workflows/nix.yml

@@ -0,0 +1,27 @@
+---
+name: Nix
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+          fetch-depth: 0
+      - uses: DeterminateSystems/nix-installer-action@v23
+      - run: nix flake check
+      - run: nix build
+      - run: nix run . -- --help

hackerrank_cli-2026.10.1.1/.github/workflows/publish-site.yml

@@ -0,0 +1,36 @@
+---
+name: Deploy documentation
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  pages:
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    permissions:
+      contents: read
+      pages: write
+      id-token: write
+    steps:
+      - run: sudo apt-get update && sudo apt-get install --yes libenchant-2-2 hunspell-en-us
+      - uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+          fetch-depth: 0
+      - uses: astral-sh/setup-uv@v10.2.0
+        with:
+          version: 0.12.19
+          python-version: '3.13'
+      - run: uv run --locked sphinx-build -W --keep-going -b html docs/source docs/build/html
+      - uses: actions/configure-pages@v6
+      - uses: actions/upload-pages-artifact@v5
+        with:
+          path: docs/build/html
+      - id: deployment
+        uses: actions/deploy-pages@v5

hackerrank_cli-2026.10.1.1/.github/workflows/release.yml

@@ -0,0 +1,97 @@
+---
+name: Release
+
+on:
+  push:
+    tags: [20*]
+
+permissions:
+  contents: read
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+          fetch-depth: 0
+      - uses: astral-sh/setup-uv@v10.2.0
+        with:
+          version: 0.12.19
+          python-version: '3.13'
+      - run: uv run --locked pytest
+      - run: uv run --locked prek run --all-files
+      - run: uv run --locked prek run --all-files --stage pre-push
+      - run: uv run --locked sphinx-build -W -b html docs/source docs/build/html
+      - run: uv build
+      - run: uv run --locked twine check dist/*
+      - run: uv run --locked check-wheel-contents dist/*.whl
+      - uses: actions/upload-artifact@v7
+        with:
+          name: distributions
+          path: dist/*
+  binaries:
+    # actionlint 1.7.12 accepts ./ for local workflows and rejects $/.
+    uses: ./.github/workflows/binaries.yml  # zizmor: ignore[self-repository]
+    with:
+      notarize: true
+    secrets:
+      DEVELOPER_ID_APP_CERT_P12_BASE64: ${{ secrets.DEVELOPER_ID_APP_CERT_P12_BASE64 }}
+      DEVELOPER_ID_APP_CERT_PASSWORD: ${{ secrets.DEVELOPER_ID_APP_CERT_PASSWORD }}
+      APPLE_ID: ${{ secrets.APPLE_ID }}
+      APPLE_TEAM_ID: ${{ secrets.APPLE_TEAM_ID }}
+      APPLE_APP_PASSWORD: ${{ secrets.APPLE_APP_PASSWORD }}
+  publish:
+    needs: [validate, binaries]
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          name: distributions
+          path: dist
+      - uses: pypa/gh-action-pypi-publish@release/v1
+  github-release:
+    needs: publish
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+      - uses: actions/download-artifact@v8
+        with:
+          path: artifacts
+      - name: Attach distributions and binaries
+        env:
+          GH_TOKEN: ${{ github.token }}
+          TAG: ${{ github.ref_name }}
+        run: gh release create "$TAG" artifacts/distributions/* artifacts/hackerrank-*/*
+          --title "$TAG" --notes-file CHANGELOG.rst --verify-tag
+  docker:
+    needs: publish
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+          fetch-depth: 0
+      - uses: docker/setup-buildx-action@v4
+      - uses: docker/login-action@v4
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ github.token }}
+      - uses: docker/build-push-action@v7
+        with:
+          context: .
+          push: true
+          tags: ghcr.io/adamtheturtle/hackerrank-cli:${{ github.ref_name }},ghcr.io/adamtheturtle/hackerrank-cli:latest
+          build-args: HACKERRANK_CLI_VERSION=${{ github.ref_name }}

hackerrank_cli-2026.10.1.1/.gitignore

@@ -0,0 +1,18 @@
+.venv/
+__pycache__/
+*.py[cod]
+*.egg-info/
+.coverage
+.coverage.*
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+src/hackerrank_cli/_version.py
+build/
+dist/
+docs/build/
+*.spec
+styles/ai-tells/
+doccmd_*
+.pyrefly_cache/
+styles/config/

hackerrank_cli-2026.10.1.1/.vale.ini

@@ -0,0 +1,8 @@
+StylesPath = styles
+MinAlertLevel = error
+
+Packages = https://github.com/tbhb/vale-ai-tells/releases/download/v1.29.0/ai-tells.zip
+
+[*.{rst,md}]
+BasedOnStyles = ai-tells, snapper
+snapper.SemanticLineBreaks = error

hackerrank_cli-2026.10.1.1/CHANGELOG.rst

@@ -0,0 +1,16 @@
+Changelog
+=========
+
+Releases are assembled from ``newsfragments/`` using Towncrier.
+
+.. towncrier release notes start
+
+2026.10.1.1 (2026-10-01)
+------------------------
+
+Features
+~~~~~~~~
+
+- Upload existing HackerRank project-question starter files from a directory or
+  a single file, with nested ignore rules, configurable exclusions, offline dry
+  runs, and SDK retry handling.

hackerrank_cli-2026.10.1.1/Dockerfile

@@ -0,0 +1,15 @@
+FROM python:3.13-slim AS build
+LABEL org.opencontainers.image.source="https://github.com/adamtheturtle/hackerrank-cli"
+COPY --from=ghcr.io/astral-sh/uv:0.12.19 /uv /bin/uv
+WORKDIR /build
+COPY . .
+ARG HACKERRANK_CLI_VERSION=0.0.0
+RUN SETUPTOOLS_SCM_PRETEND_VERSION_FOR_HACKERRANK_CLI=$HACKERRANK_CLI_VERSION uv build --wheel --out-dir /wheels
+
+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
+ENTRYPOINT ["hackerrank"]

hackerrank_cli-2026.10.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Adam Dangoor
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

hackerrank_cli-2026.10.1.1/MANIFEST.in

@@ -0,0 +1,13 @@
+include LICENSE README.rst CHANGELOG.rst VERSION
+recursive-include src *.py *.typed
+recursive-include docs *.rst *.py
+recursive-include newsfragments *
+include .vale.ini prek.toml spelling_private_dict.txt zizmor.yml
+recursive-include styles/snapper *.yml
+include .github/dependabot.yml
+recursive-include .github/workflows *.yml
+include Dockerfile flake.nix flake.lock uv.lock
+recursive-include bin *.py
+recursive-include tests *.py *.txt
+include .dockerignore
+include .gitattributes