Configure Python development tooling

Author: arionvlad

.vscode/extensions.json

@@ -0,0 +1,3 @@
+{  
+    "recommendations": ["ms-python.python", "ms-python.vscode-pylance", "charliermarsh.ruff"]
+}

.vscode/settings.json

@@ -0,0 +1,15 @@
+{
+  "python.pythonPath": "${workspaceFolder}/.venv/bin/python",
+  "python.analysis.extraPaths": ["${workspaceFolder}/src"],
+  "python.testing.pytestEnabled": true,
+  "python.testing.unittestEnabled": false,
+  "python.testing.pytestArgs": ["tests"],
+  "[python]": {
+    "editor.defaultFormatter": "charliermarsh.ruff",
+    "editor.formatOnSave": true,
+    "editor.codeActionsOnSave": {
+      "source.fixAll.ruff": "explicit",
+      "source.organizeImports.ruff": "explicit"
+    }
+  }
+}

pyproject.toml

@@ -16,5 +16,31 @@ dependencies = []
 [project.urls]
 Repository = "https://github.com/arionvlad/python-apprentice"
 
+[project.optional-dependencies]
+dev = [
+    "mypy",
+    "pytest",
+    "ruff",
+]
+
 [tool.setuptools.packages.find]
-where = ["src"]
+where = ["src"]
+
+[tool.ruff]
+line-length = 88
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP"]
+
+[tool.ruff.format]
+quote-style = "double"
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+files = ["src", "tests"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]

src/python_apprentice/__init__.py

@@ -2,11 +2,7 @@
 
 from __future__ import annotations
 
-
-def greet(name: str) -> str:
-    return f"Hello, {name}!"
-
-
+from .greetings import greet
 from .main import main
 
 __all__ = ["greet", "main"]

src/python_apprentice/greetings.py

@@ -0,0 +1,3 @@
+# greetings.py
+def greet(name: str) -> str:
+    return f"Hello, {name}!"

src/python_apprentice/main.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from . import greet
+from .greetings import greet
 
 
 def main() -> None:

tests/test_greeting.py

@@ -0,0 +1,5 @@
+from python_apprentice.greetings import greet
+
+
+def test_greet_returns_personalized_message() -> None:
+    assert greet("Vlad") == "Hello, Vlad!"