chore: replace black/isort/flake8 with ruff and add ty + deptry

Author: raederan

.coveragerc

@@ -1,55 +1,29 @@
+# Legacy sphinx config; excluded until it is removed in the docs phase
 exclude: '^docs/conf.py'
 
 minimum_pre_commit_version: 3.2.0
 repos:
-- repo: https://github.com/pre-commit/pre-commit-hooks
-  rev: v5.0.0
-  hooks:
-  - id: trailing-whitespace
-  - id: check-added-large-files
-  - id: check-ast
-  - id: check-json
-  - id: check-merge-conflict
-  - id: check-xml
-  - id: check-yaml
-  - id: debug-statements
-  - id: end-of-file-fixer
-  - id: requirements-txt-fixer
-  - id: mixed-line-ending
-    args: ['--fix=auto']  # replace 'auto' with 'lf' to enforce Linux/Mac line endings or 'crlf' for Windows
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: check-added-large-files
+      - id: check-ast
+      - id: check-case-conflict
+      - id: check-json
+      - id: check-merge-conflict
+      - id: check-toml
+      - id: check-xml
+      - id: check-yaml
+      - id: debug-statements
+      - id: end-of-file-fixer
+      - id: mixed-line-ending
+        args: ['--fix=auto']
 
-# If you want to avoid flake8 errors due to unused vars or imports:
-- repo: https://github.com/myint/autoflake
-  rev: v2.3.1
-  hooks:
-  - id: autoflake
-    args: [
-      --in-place,
-      --remove-all-unused-imports,
-      --remove-unused-variables,
-    ]
-
-- repo: https://github.com/pycqa/isort
-  rev: 5.13.2
-  hooks:
-  - id: isort
-
-- repo: https://github.com/psf/black
-  rev: 24.10.0
-  hooks:
-  - id: black
-    language_version: python3
-
-## If like to embrace black styles even in the docs:
-# - repo: https://github.com/asottile/blacken-docs
-#   rev: v1.12.0
-#   hooks:
-#   - id: blacken-docs
-#     additional_dependencies: [black]
-
-- repo: https://github.com/PyCQA/flake8
-  rev: 7.1.1
-  hooks:
-  - id: flake8
-  ## You can add flake8 plugins via `additional_dependencies`:
-    additional_dependencies: [flake8-bugbear]
+  # ruff replaces autoflake, isort, black and flake8(+bugbear)
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.7
+    hooks:
+      - id: ruff-check
+        args: [--exit-non-zero-on-fix]
+      - id: ruff-format

.isort.cfg

@@ -0,0 +1,50 @@
+.DEFAULT_GOAL := help
+
+.PHONY: install
+install: ## Install the virtual environment and pre-commit hooks
+	@echo ">> Creating virtual environment using uv"
+	@uv sync
+	@uv run pre-commit install
+
+.PHONY: check
+check: ## Run code quality tools
+	@echo ">> Checking lock file consistency with 'pyproject.toml'"
+	@uv lock --locked
+	@echo ">> Linting code: Running pre-commit"
+	@uv run pre-commit run -a
+	@echo ">> Static type checking: Running ty"
+	@uv run ty check
+	@echo ">> Checking for obsolete dependencies: Running deptry"
+	@uv run deptry src
+
+.PHONY: test
+test: ## Test the code with pytest (integration tests excluded, see pyproject.toml)
+	@echo ">> Testing code: Running pytest"
+	@uv run python -m pytest --cov --cov-config=pyproject.toml --cov-report=xml
+
+.PHONY: build
+build: clean-build ## Build wheel and sdist
+	@echo ">> Creating wheel and sdist files"
+	@uv build
+
+.PHONY: clean-build
+clean-build: ## Remove build artifacts
+	@echo ">> Removing build artifacts"
+	@uv run python -c "import shutil; shutil.rmtree('dist', ignore_errors=True)"
+
+.PHONY: publish
+publish: ## Publish a release to PyPI (CI-only via OIDC trusted publishing)
+	@echo "Publishing happens in CI via OIDC trusted publishing (on-release-main.yml)."
+	@echo "Push a version tag (v*) to trigger a release."
+
+.PHONY: docs
+docs: ## Build and serve the documentation (available after the docs phase)
+	@echo "Docs are built with zensical from the docs phase onward."
+
+.PHONY: docs-test
+docs-test: ## Test if documentation can be built without errors (available after the docs phase)
+	@echo "Docs are built with zensical from the docs phase onward."
+
+.PHONY: help
+help:
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-20s\033[0m %s\n", $$1, $$2}'