Release 022025

.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/workflows/actions/prepare/action.yml

@@ -0,0 +1,47 @@
+name: 'Prepare environment'
+description: 'Prepare environment'
+
+inputs:
+  python-version:
+    description: 'Python version to use'
+    required: true
+
+runs:
+  using: "composite"
+  steps:
+    - name: Setup PATH
+      run: echo "/home/runner/.local/bin" >> $GITHUB_PATH
+      shell: bash
+
+    - name: Install Poetry
+      run: pipx install poetry==$(head -n 1 .poetry-version)
+      shell: bash
+
+    - uses: actions/setup-python@v5
+      with:
+        python-version: ${{ inputs.python-version }}
+        cache: 'poetry'
+
+    - name: Clear Poetry cache
+      run: poetry cache clear --all pypi
+      shell: bash
+
+    - name: Install dependencies and package
+      run: poetry install --no-interaction --no-ansi
+      shell: bash
+
+    # 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/build-wheels.yml

@@ -0,0 +1,87 @@
+name: Build Wheels
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+
+jobs:
+  build_wheels:
+    name: Build psutil wheels on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    permissions:
+      contents: write
+    strategy:
+      matrix:
+        include:
+          # Linux builds
+          - os: ubuntu-latest
+            python-version: '3.10'
+          - os: ubuntu-latest
+            python-version: '3.11'
+          - os: ubuntu-latest
+            python-version: '3.12'
+
+          # Windows builds  
+          - os: windows-latest
+            python-version: '3.10'
+          - os: windows-latest
+            python-version: '3.11'
+          - os: windows-latest
+            python-version: '3.12'
+
+          # macOS builds
+          - os: macos-latest
+            python-version: '3.10'
+          - os: macos-latest
+            python-version: '3.11'
+          - os: macos-latest
+            python-version: '3.12'
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install build dependencies
+        run: |
+          python -m pip install pip wheel
+        shell: bash
+
+      - name: Build psutil wheel
+        run: |
+          # Create dist directory
+          mkdir -p dist
+
+          # Build psutil wheel
+          pip wheel psutil==5.8.0 --wheel-dir dist/
+        shell: bash
+
+      - name: Upload to GitHub Actions
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist-${{ matrix.os }}-py${{ matrix.python-version }}
+          path: dist/*
+
+  release:
+    needs: build_wheels
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/')
+    permissions:
+      contents: write
+    steps:
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          pattern: dist-*
+          path: dist
+          merge-multiple: true
+
+      - name: Create Release
+        uses: softprops/action-gh-release@v1
+        with:
+          files: dist/*

.github/workflows/ci.yml

@@ -0,0 +1,88 @@
+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
+        with:
+          repository: ${{ github.event.pull_request.head.repo.full_name }}
+          ref: ${{ github.event.pull_request.head.ref }}
+      - 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 --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: '.'
+
+  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.12"
+      - 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: [ self-hosted, small ]
+            python-version: "3.10"
+          - os: [ self-hosted, small ]
+            python-version: "3.11"
+          - os: [ self-hosted, small ]
+            python-version: "3.12"
+
+          # Windows
+          - os: windows-latest
+            python-version: "3.10.11"
+          - os: windows-latest
+            python-version: "3.11"
+          - os: windows-latest
+            python-version: "3.12"
+
+          # macOS (arm64)
+          - os: macos-14
+            python-version: "3.11"
+          - os: macos-14
+            python-version: "3.12"
+    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

.github/workflows/main.yml

@@ -4,6 +4,7 @@ on: [ push ]
 
 jobs:
   Lint:
+    if: false
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v3
@@ -24,6 +25,7 @@ jobs:
       - name: Lint
         run: flake8
   test-ubuntu:
+    if: false
     runs-on: ${{ matrix.os }}
     strategy:
       fail-fast: false

.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

hstest/__init__.py

@@ -1,22 +1,20 @@
-__all__ = [
-    'StageTest',
-    'DjangoTest',
-    'FlaskTest',
-    'PlottingTest',
-    'SQLTest',
-
-    'TestCase',
-    'SimpleTestCase',
-
-    'CheckResult',
-    'correct',
-    'wrong',
+from __future__ import annotations
 
-    'WrongAnswer',
-    'TestPassed',
-
-    'dynamic_test',
-    'TestedProgram',
+__all__ = [
+    "CheckResult",
+    "DjangoTest",
+    "FlaskTest",
+    "PlottingTest",
+    "SQLTest",
+    "SimpleTestCase",
+    "StageTest",
+    "TestCase",
+    "TestPassed",
+    "TestedProgram",
+    "WrongAnswer",
+    "correct",
+    "dynamic_test",
+    "wrong",
 ]
 
 from hstest.dynamic.dynamic_test import dynamic_test

hstest/check_result.py

@@ -1,3 +1,5 @@
 # deprecated, but old tests use "from hstest.check_result import CheckResult"
 # new way to import is "from hstest import CheckResult"
+from __future__ import annotations
+
 from hstest.test_case import CheckResult, correct, wrong  # noqa: F401

hstest/common/file_utils.py

@@ -1,42 +1,42 @@
+from __future__ import annotations
+
+import contextlib
 import os
-from typing import Dict
 
 from hstest.exception.testing import FileDeletionError
 
 
-def create_files(files: Dict[str, str]):
+def create_files(files: dict[str, str]) -> None:
     for file, content in files.items():
-        with open(file, 'w') as f:
+        with open(file, "w", encoding="utf-8") as f:
             f.write(content)
 
 
-def delete_files(files: Dict[str, str]):
-    for file in files.keys():
+def delete_files(files: dict[str, str]) -> None:
+    for file in files:
         if os.path.isfile(file):
             try:
                 os.remove(file)
             except PermissionError:
-                raise FileDeletionError()
+                raise FileDeletionError
 
 
-def safe_delete(filename):
+def safe_delete(filename) -> None:
     if os.path.exists(filename):
-        try:
+        with contextlib.suppress(BaseException):
             os.remove(filename)
-        except BaseException:
-            pass
 
 
 def walk_user_files(folder):
     curr_folder = os.path.abspath(folder)
-    test_folder = os.path.join(curr_folder, 'test')
+    test_folder = os.path.join(curr_folder, "test")
 
     for folder, dirs, files in os.walk(curr_folder):
         if folder.startswith(test_folder):
             continue
 
         if folder == curr_folder:
-            for file in 'test.py', 'tests.py':
+            for file in "test.py", "tests.py":
                 if file in files:
                     files.remove(file)