chore: Merge remote-tracking branch 'esp/main' into wokwi-python-client

Author: JakubAndrysek

.github/workflows/codeql.yml

@@ -16,7 +16,7 @@ jobs:
         language: [ 'python' ]
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v4
+      uses: actions/checkout@v5
     - name: Initialize CodeQL
       uses: github/codeql-action/init@v3
       with:

.github/workflows/publish_pypi.yml

@@ -9,9 +9,9 @@ jobs:
   deploy:
     runs-on: ubuntu-22.04
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: "3.7"
       - name: Build packages

.github/workflows/sync-jira.yml

@@ -46,7 +46,7 @@ jobs:
       pull-requests: write
     steps:
       - name: Check out
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
 
       - name: Run synchronization to Jira
         uses: espressif/sync-jira-actions@v1

.github/workflows/test-build-docs.yml

@@ -11,11 +11,11 @@ jobs:
   test-build-docs:
     runs-on: ubuntu-22.04
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
-          python-version: "3.7"
+          python-version: "3.10"
       - name: Install dependencies
         run: |
           bash foreach.sh install

.github/workflows/test-build-package.yml

@@ -7,9 +7,9 @@ jobs:
   test-build-packages:
     runs-on: ubuntu-22.04
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: "3.7"
       - name: Build packages

.github/workflows/test-python.yml

@@ -21,7 +21,7 @@ jobs:
     strategy:
       matrix:
         include:
-          - python-version: "3.7"
+          - python-version: "3.10"
             arch: "ARM64"
           - python-version: "3.13"
             arch: "X64"
@@ -34,7 +34,7 @@ jobs:
       image: python:${{ matrix.python-version }}
       options: --privileged
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: Install dependencies
         run: |
           apt update && apt install -y socat zip

.pre-commit-config.yaml

@@ -8,19 +8,18 @@ exclude: |
 
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v5.0.0
+    rev: v6.0.0
     hooks:
       - id: trailing-whitespace
       - id: end-of-file-fixer
       - id: mixed-line-ending
         args: ["-f=lf"]
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: "v0.11.6"
+    rev: "v0.12.12"
     hooks:
-      - id: ruff
+      - id: ruff-check
         args: ["--fix"]
       - id: ruff-format
-        args: ["--preview"]
 
   # documentation
   - repo: https://github.com/sphinx-contrib/sphinx-lint

.readthedocs.yaml

@@ -11,7 +11,7 @@ sphinx:
 build:
   os: ubuntu-22.04
   tools:
-    python: "3.7"
+    python: "3.10"
 
 python:
   install:

CHANGELOG.md

@@ -1,5 +1,30 @@
 # CHANGELOG
 
+## v2.0.0 (TBD)
+
+### Breaking Changes
+
+- **Python Support**: Drop support for Python 3.7, 3.8, 3.9. Now requires Python 3.10+
+- **esptool**: Update esptool requirement to >=5.1.dev1,<6 (from ~=4.9)
+- **Deprecated Code Removal**:
+  - Remove `EsptoolArgs` class from `pytest-embedded-serial-esp`
+  - Remove deprecated parameters `hard_reset_after` and `no_stub` from `use_esptool()` decorator
+  - Remove deprecated `stub` property from `EspSerial` class (use `esp` instead)
+  - Remove deprecated `parse_test_menu()` and `parse_unity_menu_from_str()` methods from `IdfUnityDutMixin` (use `test_menu` property instead)
+  - Remove deprecated CLI option `--add-target-as-marker` (use `--add-target-as-marker-with-amount` instead)
+
+### Migration Guide
+
+1. **Python Version**: Upgrade to Python 3.10 or higher
+2. **esptool**: Update esptool to version 5.1.dev1 or higher (but less than 6.0)
+3. **Code Changes**:
+   - Replace `dut.stub` with `dut.esp`
+   - Replace `dut.parse_test_menu()` calls with `dut.test_menu` property access
+   - Replace `parse_unity_menu_from_str()` with `_parse_unity_menu_from_str()` if needed. `dut.test_menu` is preferred.
+   - Update CLI usage from `--add-target-as-marker` to `--add-target-as-marker-with-amount`
+   - Remove any usage of `EsptoolArgs` class
+   - Remove `hard_reset_after` and `no_stub` parameters from `use_esptool()` calls
+
 ## v1.17.0a0 (2025-08-07)
 
 ### Feat

conftest.py

@@ -2,7 +2,7 @@
 import shutil
 import sys
 import textwrap
-from typing import List, Pattern
+from re import Pattern
 
 import pytest
 from _pytest.config import Config
@@ -59,7 +59,7 @@ def cache_file_remove(cache_dir):
 
 @pytest.fixture
 def first_index_of_messages():
-    def _fake(_pattern: Pattern, _messages: List[str], _start: int = 0) -> int:
+    def _fake(_pattern: Pattern, _messages: list[str], _start: int = 0) -> int:
         for i, _message in enumerate(_messages):
             if _pattern.match(_message) and i >= _start:
                 return i