feat(template): add sample tests and document quality checks

- add tests/sample/test_main.py with pytest examples
- document running pytest, ruff check, and ruff format --check in README.md
- include tests/**/*.py in Ruff scope
- add Ruff per-file ignores for tests (S101, PLR2004) and fix test
  docstring lintk

Author: jamm1985

README.md

@@ -204,9 +204,11 @@ docker compose build dev
 docker compose run --rm dev
 ```
 
-Examples:
+Examples (quality checks): run tests with pytest, then run Ruff lint and
+format checks.
 
 ```bash
+docker compose run --rm dev pytest -q
 docker compose run --rm dev ruff check
 docker compose run --rm dev ruff format --check
 ```

pyproject.toml

@@ -44,6 +44,7 @@ include = [
     "**/pyproject.toml",
     "src/**/*.py",
     "src/**/*.pyi",
+    "tests/**/*.py",
 ]
 line-length = 79
 indent-width = 4
@@ -60,6 +61,10 @@ ignore = [
 ]
 
 [tool.ruff.lint.per-file-ignores]
+"tests/**/*.py" = [
+    "S101",
+    "PLR2004",
+]
 
 [tool.ruff.lint.isort]
 

src/sample/main.py

@@ -1,6 +1,29 @@
-from numpy.random import random
+"""Main template."""
 
+import numpy as np
 
-def run():
-    sample = random(size=100)
-    print("Sample mean is ", sample.mean())
+
+def get_sample(k: int) -> list[float]:
+    """Example of random sample.
+
+    Args:
+        k: how much samples to get
+
+    Returns:
+        list of sample of size k
+    """
+    rng = np.random.default_rng(seed=42)
+    floats = rng.random(k)
+    return floats.tolist()
+
+
+def run(k: int) -> list[float]:
+    """Example of run.
+
+    Args:
+        k: samples to get
+
+    Returns:
+        list samples of size k
+    """
+    return get_sample(k)

tests/sample/test_main.py

@@ -0,0 +1,31 @@
+"""Tests for sample.main module."""
+
+import pytest
+
+from sample.main import get_sample, run
+
+
+def test_get_sample_returns_requested_number_of_values() -> None:
+    """get_sample returns exactly k values in [0, 1]."""
+    sample = get_sample(5)
+    assert len(sample) == 5
+    assert all(0.0 <= value <= 1.0 for value in sample)
+
+
+def test_get_sample_is_deterministic_for_same_k() -> None:
+    """Template behavior is deterministic because seed is fixed."""
+    assert get_sample(3) == pytest.approx(
+        [0.7739560485559633, 0.4388784397520523, 0.8585979199113825],
+    )
+
+
+def test_run_uses_get_sample(monkeypatch: pytest.MonkeyPatch) -> None:
+    """Run delegates to get_sample and returns its result unchanged."""
+    expected = [0.1, 0.2]
+
+    def fake_get_sample(k: int) -> list[float]:
+        assert k == 2
+        return expected
+
+    monkeypatch.setattr("sample.main.get_sample", fake_get_sample)
+    assert run(2) == expected