Release 052025

.gitattributes

@@ -0,0 +1,6 @@
+*.yml text eol=lf
+*.yaml text eol=lf
+*.py text eol=lf
+*.toml text eol=lf
+*.md text eol=lf
+*.txt text eol=lf

.github/dependabot.yml

@@ -0,0 +1,17 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "00:00"
+    groups:
+      all-actions:
+        patterns: [ "*" ]
+
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "daily"
+      time: "00:00"

.github/workflows/actions/prepare/action.yml

@@ -0,0 +1,77 @@
+name: 'Prepare environment'
+description: 'Prepare environment'
+
+inputs:
+  python-version:
+    description: 'Python version to use'
+    required: true
+
+runs:
+  using: "composite"
+  steps:
+    - name: Set up Python paths (Unix)
+      if: runner.os != 'Windows'
+      run: echo "$HOME/.local/bin" >> $GITHUB_PATH
+      shell: bash
+
+    - name: Set up Python paths (Windows)
+      if: runner.os == 'Windows'
+      run: echo "$env:APPDATA\Python\Scripts" | Out-File -FilePath $env:GITHUB_PATH -Encoding utf8 -Append
+      shell: pwsh
+
+    - name: Get Poetry version
+      id: poetry-version
+      run: |
+        [ -f .poetry-version ] && echo "version=$(head -n 1 .poetry-version)" >> $GITHUB_OUTPUT
+      shell: bash
+
+    - name: Install Poetry (Unix)
+      if: runner.os != 'Windows'
+      run: pipx install poetry==${{ steps.poetry-version.outputs.version }}
+      shell: bash
+
+    - name: Install Poetry (Windows)
+      if: runner.os == 'Windows'
+      run: pipx install poetry==${{ steps.poetry-version.outputs.version }}
+      shell: pwsh
+
+    - uses: actions/setup-python@v5
+      with:
+        python-version: ${{ inputs.python-version }}
+        cache: 'poetry'
+
+    - name: Clear Poetry cache (Unix)
+      if: runner.os != 'Windows'
+      run: poetry cache clear --all pypi
+      shell: bash
+
+    - name: Clear Poetry cache (Windows)
+      if: runner.os == 'Windows'
+      run: poetry cache clear --all pypi
+      shell: pwsh
+
+    - name: Install dependencies and package (Unix)
+      if: runner.os != 'Windows'
+      run: poetry install --no-interaction --no-ansi
+      shell: bash
+
+    - name: Install dependencies and package (Windows)
+      if: runner.os == 'Windows'
+      run: poetry install --no-interaction --no-ansi
+      shell: pwsh
+
+    # Setup Node.js for JavaScript tests
+    - uses: actions/setup-node@v4
+      with:
+        node-version: '20'
+
+    # Install Node.js dependencies
+    - name: Install Node.js dependencies
+      run: npm install
+      shell: bash
+
+    # Setup Go for Go language tests
+    - uses: actions/setup-go@v5
+      with:
+        go-version: '1.21'
+        cache: false

.github/workflows/auto-author-assign.yml

@@ -0,0 +1,16 @@
+name: Auto Author Assign
+
+on:
+  pull_request_target:
+    types: [ opened, reopened ]
+
+permissions:
+  pull-requests: write
+
+jobs:
+  assign-author:
+    runs-on: arc-runners-small
+    timeout-minutes: 30
+    if: ${{ !github.event.pull_request.assignee }}
+    steps:
+      - uses: toshimaru/auto-author-assign@v2.1.0

.github/workflows/auto-format.yml

@@ -0,0 +1,46 @@
+name: Auto format
+
+on:
+  push:
+    branches:
+      - master
+      - release
+  pull_request:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref_name }}
+  cancel-in-progress: true
+
+jobs:
+  auto_format:
+    name: Auto format with ruff
+    runs-on: arc-runners-small
+    timeout-minutes: 30
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          repository: ${{ github.event.pull_request.head.repo.full_name }}
+          ref: ${{ github.event.pull_request.head.ref }}
+
+      - name: Get Python version
+        id: python_version
+        run: echo "python_version=$(head -n 1 .python-version)" >> $GITHUB_OUTPUT
+        shell: bash
+
+      - uses: ./.github/workflows/actions/prepare
+        with:
+          python-version: ${{ steps.python_version.outputs.python_version }}
+
+      - name: Check files using the ruff formatter
+        run: |
+          poetry run ruff check --fix --unsafe-fixes --preview --exit-zero .
+          poetry run ruff format .
+        shell: bash
+
+      - name: Commit changes
+        uses: EndBug/add-and-commit@v9
+        with:
+          fetch: false
+          default_author: github_actions
+          message: 'Backend: Auto format'
+          add: '.'

.github/workflows/ci.yml

@@ -0,0 +1,82 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - master
+      - release
+  pull_request:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref_name }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: Lint with ruff
+    runs-on: arc-runners-small
+    timeout-minutes: 30
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ./.github/workflows/actions/prepare
+        with:
+          python-version: "3.11"
+      - name: Check files using the ruff formatter
+        run: poetry run ruff check --fix --unsafe-fixes --preview .
+        shell: bash
+
+  mypy:
+    name: Static Type Checking
+    runs-on: arc-runners-small
+    timeout-minutes: 30
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ./.github/workflows/actions/prepare
+        with:
+          python-version: "3.11"
+      - name: Mypy
+        run: poetry run mypy .
+        shell: bash
+
+  test:
+    name: Run unit test on ${{ matrix.os }} with Python ${{ matrix.python-version }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          # Self-hosted runner
+          - os: arc-runners-small
+            python-version: "3.10"
+          - os: arc-runners-small
+            python-version: "3.11"
+          - os: arc-runners-small
+            python-version: "3.12"
+          - os: arc-runners-small
+            python-version: "3.13"
+
+          # Windows
+          - os: windows-latest
+            python-version: "3.10.11"
+          - os: windows-latest
+            python-version: "3.11"
+          - os: windows-latest
+            python-version: "3.12"
+          - os: windows-latest
+            python-version: "3.13"
+
+          # macOS (arm64)
+          - os: macos-14
+            python-version: "3.11"
+          - os: macos-14
+            python-version: "3.12"
+          - os: macos-14
+            python-version: "3.13"
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ./.github/workflows/actions/prepare
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Run Tests
+        run: poetry run python tests/testing.py
+        shell: bash

.poetry-version

@@ -0,0 +1 @@
+2.0.1

.python-version

@@ -0,0 +1 @@
+3.10.13

README.md

@@ -1,10 +1,33 @@
 # hs-test-python
+
+Python testing library for Hyperskill projects
+
 It is a framework that simplifies testing educational projects for [Hyperskill](https://hyperskill.org).
 
-It is required to use for Hyperskill projects. The main features are:
+The main features are:
 * black box testing
 * multiple types of tests in a simple unified way (without stdin, with stdin, files, Django, Flask, Matplotlib)
 * generating learner-friendly feedback (filtering stack-traces, hints)
 
+## Installation
+
+Install the package directly from GitHub:
+
+```bash
+pip install https://github.com/hyperskill/hs-test-python/archive/release.tar.gz
+```
+
+The package includes pre-built wheels for psutil, so you don't need a C++ compiler to install it.
+
+## Development
+
+To contribute to the project:
+
+1. Clone the repository
+2. Install dependencies with poetry:
+```bash
+poetry install
+```
+
 To learn how to use this library you can go here:
 https://github.com/hyperskill/hs-test-python/wiki