Update linting and formatting setup to use latest actions and enhance commands

Co-authored-by: Copilot <copilot@github.com>

Author: yuriverweij

.github/workflows/LintFormatCheck.yml

@@ -7,10 +7,10 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
 
     - name: Set up Python
-      uses: actions/setup-python@v5
+      uses: actions/setup-python@v6
       with:
         python-version: "3.13"
 
@@ -20,9 +20,22 @@ jobs:
         pip install -r requirements-dev.txt
 
     - name: Ruff format check
+      id: format
+      continue-on-error: true
       run: |
-        python -m ruff format --check --diff src/ utest/ atest/
+        python -m invoke format --check
 
     - name: Ruff lint
+      id: lint
+      continue-on-error: true
       run: |
-        python -m invoke lint
+        python -m invoke lint
+
+    - name: Fail if any Ruff step failed
+      if: always()
+      run: |
+        echo "format outcome: ${{ steps.format.outcome }}"
+        echo "lint outcome:   ${{ steps.lint.outcome }}"
+        if [ "${{ steps.format.outcome }}" != "success" ] || [ "${{ steps.lint.outcome }}" != "success" ]; then
+          exit 1
+        fi

CONTRIBUTING.rst

@@ -118,10 +118,23 @@ needed in internal code. When docstrings are added, they should follow
 `PEP-257`_. See `Documentation`_ section below for more details about
 documentation syntax, generating docs, etc.
 
-The code should be formatted and linted with `Ruff`_. Ruff can be run by
-using command::
+The code should be formatted and linted with `Ruff`_. See Development commands below for more details.
 
-    inv lint
+Development commands
+~~~~~~~~~~~~~~~~~~~~
+
+Use `invoke`_ tasks for common local checks and test runs::
+
+    inv format --check    # Check formatting with Ruff
+    inv format            # Format source files with Ruff
+    inv lint              # Run Ruff lint checks
+    inv lint --fix        # Apply safe Ruff lint fixes
+    inv utest             # Run unit tests
+    inv atest             # Run acceptance tests (headlesschrome)
+
+Run these before opening a pull request so local results are close to CI.
+Use the project virtual environment and pinned dependencies from
+``requirements-dev.txt`` for consistent results across local runs and CI.
 
 Documentation
 -------------
@@ -149,7 +162,7 @@ individual keywords.
 
 Keyword documentation can be easily created using `invoke`_ task::
 
-    inv keyword_documentation
+    inv kw-docs
 
 Resulting docs should be verified before the code is committed.
 

requirements-dev.txt

@@ -15,7 +15,7 @@ pytest-mockito == 0.0.4
 pytest-approvaltests == 0.2.4
 requests == 2.33.1
 robotframework-pabot == 5.2.2
-ruff == 0.4.10
+ruff == 0.15.12
 
 # Requirements needed when generating releases. See BUILD.rst for details.
 rellu == 0.7

tasks.py

@@ -187,11 +187,28 @@ def init_labels(ctx, username=None, password=None):
 
 @task
 def lint(ctx, fix=False):
-    """Runs Ruff format check and linter for project Python code."""
-    ruff_cmd = f"{sys.executable} -m ruff check --config pyproject.toml src/ utest/" # atest/"
+    """Run Ruff lint checkse.
+
+    Args:
+        fix: Apply safe fixes when True. Defaults to False.
+    """
+    cmd = f"{sys.executable} -m ruff check --config pyproject.toml src/ utest/" # atest/"
     if fix:
-        ruff_cmd = f"{ruff_cmd} --fix"
-    ctx.run(ruff_cmd)
+        cmd = f"{cmd} --fix"
+    ctx.run(cmd)
+
+@task
+def format(ctx, check=False):    
+    """Run Ruff formatter.
+
+    Args:
+        check: When True, only check formatting and show diff.
+               When False, apply formatting changes.
+    """
+    cmd = f"{sys.executable} -m ruff format --config pyproject.toml src/ utest/ atest/"
+    if check:
+        cmd = f"{cmd} --check --diff"
+    ctx.run(cmd)
 
 @task
 def gen_stub(ctx):