Feature/544 add ruff to remove unused imports (#605)

* Add ruff to dependencies

* Remove unused imports via ruff

* Add ruff setting and ignore F401 in tasks where we need to share all the defined nox sessions

* Modify project:fix and project:format to include ruff

* Add ruff settings to cookiecutter template & update documentation

* Adapt changelog

* Add on unit tests for other formatting tools

* Update isort to latest version

* Prepare release 3.0.0

Author: ArBridgeman

.github/actions/security-issues/action.yml

@@ -39,7 +39,7 @@ runs:
     - name: Install Python Toolbox / Security tool
       shell: bash
       run: |
-        pip install exasol-toolbox==2.0.0
+        pip install exasol-toolbox==3.0.0
 
     - name: Create Security Issue Report
       shell: bash

doc/changes/changelog.md

@@ -0,0 +1,43 @@
+# 3.0.0 - 2025-11-20
+
+## Summary
+
+This is a major release with potentially breaking changes as nox session `project:fix` has been modified and potentially can create many unexpected changes.
+
+This release adds [ruff](https://docs.astral.sh/ruff/) to Nox sessions `project:format` and `project:fix` to check for and remove unused imports.
+
+As `ruff` potentially can also apply many other changes, we recommend updating the `pyproject.toml` file in your project as specified here: [Formatting Code Configuration](https://exasol.github.io/python-toolbox/main/user_guide/features/formatting_code/index.html#configuration).
+
+Additionally, `isort` has been updated from `^6.0.0` to `^7.0.0`. In 7.x, `isort` has provided fixes for Python 3.14.
+
+## Documentation
+
+* #589: Corrected configuration for Sonar documentation for host.url
+* #535: Added more information about Sonar's usage of ``exclusions``
+* #596: Corrected and added more information regarding ``pyupgrade``
+
+## Features
+
+* #595: Created class `ResolvedVulnerabilities` to track resolved vulnerabilities between versions
+* #544: Modified nox sessions `project:fix` and `project:format` to use ruff to remove unused imports
+
+## Refactoring
+
+* #596: Added newline after header in versioned changelog
+
+## Dependency Updates
+
+### `main`
+* Updated dependency `bandit:1.8.6` to `1.9.1`
+* Updated dependency `black:25.9.0` to `25.11.0`
+* Updated dependency `coverage:7.11.0` to `7.12.0`
+* Updated dependency `import-linter:2.5.2` to `2.7`
+* Updated dependency `isort:6.1.0` to `7.0.0`
+* Updated dependency `nox:2025.10.16` to `2025.11.12`
+* Updated dependency `pre-commit:4.3.0` to `4.4.0`
+* Updated dependency `pydantic:2.12.3` to `2.12.4`
+* Updated dependency `pylint:4.0.2` to `4.0.3`
+* Updated dependency `pytest:8.4.2` to `9.0.1`
+* Updated dependency `pyupgrade:3.21.0` to `3.21.2`
+* Added dependency `ruff:0.14.5`
+* Updated dependency `shibuya:2025.11.4` to `2025.11.10`

doc/changes/changes_3.0.0.md

@@ -1,15 +1 @@
 # Unreleased
-
-## Documentation
-
-* #589: Corrected configuration for Sonar documentation for host.url
-* #535: Added more information about Sonar's usage of ``exclusions``
-* #596: Corrected and added more information regarding ``pyupgrade``
-
-## Features
-
-* #595: Created class `ResolvedVulnerabilities` to track resolved vulnerabilities between versions
-
-## Refactoring
-
-* #596: Added newline after header in versioned changelog

doc/changes/unreleased.md

@@ -27,6 +27,10 @@ For autoformatting, the following tools are used:
   packages, third party packages, and local application imports).
 * `pyupgrade <https://pypi.org/project/pyupgrade/>`__ - upgrades syntax for newer
   versions of the Python language.
+* `ruff <https://docs.astral.sh/ruff/>`__ - includes a plethora of tools to check and
+  automatically format code. In the PTB, only the following checks are active:
+
+   * `unused-import (F401) <https://docs.astral.sh/ruff/rules/unused-import/>`__ - removes unused imports
 
 In the PTB, these tools are bundled into nox sessions to ensure that they are run in a
 deterministic manner.
@@ -81,3 +85,16 @@ and is defined in the :meth:`exasol.toolbox.config.BaseConfig.pyupgrade_argument
 
 For further configuration options, see the
 `pyupgrade documentation <https://pypi.org/project/pyupgrade/>`__.
+
+ruff
+^^^^
+
+Ensure ``ruff`` is configured like so:
+
+.. literalinclude:: ../../../../project-template/{{cookiecutter.repo_name}}/pyproject.toml
+  :language: toml
+  :start-at: [tool.ruff.lint]
+  :end-before: [tool.mypy.overrides]
+
+For further configuration options, see
+`ruff options <https://docs.astral.sh/ruff/configuration>`__.

doc/user_guide/features/formatting_code/index.rst

@@ -38,6 +38,10 @@ might want to ignore automatically applied formatting.
 |                       |                                |                       |
 |                       |   <line-to-ignore> # isort:skip|    # isort:skip_file  |
 +-----------------------+--------------------------------+-----------------------+
+| formatting from ruff  | .. code-block:: python         | .. code-block:: python|
+| (example with F401)   |                                |                       |
+|                       |   <line-to-ignore> # noqa: F401|    # ruff: noqa F401  |
++-----------------------+--------------------------------+-----------------------+
 
 
 In the ``checks.yml``, ``project:format`` wants me to reformat code I did not modify

doc/user_guide/features/formatting_code/troubleshooting.rst

@@ -19,10 +19,6 @@
 from tempfile import TemporaryDirectory
 from typing import (
     Any,
-    Dict,
-    List,
-    Optional,
-    Union,
 )
 
 

exasol/toolbox/metrics.py

@@ -7,7 +7,6 @@
 import sys
 from collections.abc import Iterable
 from pathlib import Path
-from typing import Optional
 
 import nox
 from nox import Session

exasol/toolbox/nox/_artifacts.py

@@ -35,17 +35,26 @@ def _pyupgrade(session: Session, config: Config, files: Iterable[str]) -> None:
     )
 
 
+def _ruff(session: Session, mode: Mode, files: Iterable[str]):
+    def command(*args: str) -> Iterable[str]:
+        return args if mode == Mode.Check else list(args) + ["--fix"]
+
+    session.run(*command("ruff", "check"), *files)
+
+
 @nox.session(name="project:fix", python=False)
 def fix(session: Session) -> None:
     """Runs all automated fixes on the code base"""
     py_files = python_files(PROJECT_CONFIG.root)
     _version(session, Mode.Fix)
     _pyupgrade(session, config=PROJECT_CONFIG, files=py_files)
+    _ruff(session, mode=Mode.Fix, files=py_files)
     _code_format(session, Mode.Fix, py_files)
 
 
 @nox.session(name="project:format", python=False)
 def fmt_check(session: Session) -> None:
     """Checks the project for correct formatting"""
     py_files = python_files(PROJECT_CONFIG.root)
+    _ruff(session, mode=Mode.Check, files=py_files)
     _code_format(session=session, mode=Mode.Check, files=py_files)

exasol/toolbox/nox/_format.py

@@ -19,6 +19,7 @@
 import nox
 from nox import Session
 
+# ruff: noqa F401
 from exasol.toolbox.nox._format import (
     _code_format,
     fix,