feat: Add comprehensive Ruff documentation and update configuration in pyproject.toml

Author: kpatryk

Makefile.jinja

@@ -20,19 +20,8 @@ install: check ## Install project dependencies
 {% if "pytest" in dev_deps -%}
 test: ## Run all unit tests
 	@uv run pytest tests/unit/
-
 {% endif -%}
-{% if "ruff" in dev_deps -%}
-lint: ## Check code quality with ruff
-	uv run ruff check --fix src/ tests/
-
-format: ## Format code with ruff
-	uv run ruff format --check src/ tests/
 
-lint-fix: ## Auto-fix linting issues with ruff
-	uv run ruff check --fix --unsafe-fixes src/ tests/
-
-{% endif -%}
 clean: ## Clean build artifacts
 	@echo "Cleaning Python artifacts.."
 	@rm -rf build/ dist/ *.egg-info/ .pytest_cache/ htmlcov/ .coverage

pyproject.toml

@@ -51,3 +51,21 @@ filterwarnings = [
 [tool.ruff]
 line-length = 120
 target-version = "py310"
+
+[tool.ruff.lint]
+select = [
+    "E",    # pycodestyle errors
+    "F",    # Pyflakes
+    "UP",   # pyupgrade
+    "B",    # flake8-bugbear
+    "I",    # isort
+]
+ignore = [
+    "E501",  # line-too-long (formatter handles wrapping, but may exceed limit)
+]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+line-ending = "auto"

pyproject.toml.jinja

@@ -49,19 +49,19 @@ target-version = "py310"
 
 [tool.ruff.lint]
 select = [
-    "E",  # pycodestyle errors
-    "W",  # pycodestyle warnings
-    "F",  # pyflakes
-    "I",  # isort
-    "B",  # flake8-bugbear
-    "C4", # flake8-comprehensions
-    "UP", # pyupgrade
+    "E",    # pycodestyle errors
+    "F",    # Pyflakes
+    "UP",   # pyupgrade
+    "B",    # flake8-bugbear
+    "I",    # isort
 ]
 ignore = [
-    "E501",  # line too long, handled by black
+    "E501",  # line-too-long (formatter handles wrapping, but may exceed limit)
 ]
 
 [tool.ruff.format]
 quote-style = "double"
 indent-style = "space"
+skip-magic-trailing-comma = false
+line-ending = "auto"
 {%- endif %}