(ci) Add tests coverage

Author: protocolstardust

.github/workflows/coverage.yml

@@ -0,0 +1,66 @@
+name: Coverage
+
+on:
+  push:
+    branches: [master]
+
+jobs:
+  coverage:
+    name: Coverage
+    runs-on: ubuntu-latest
+
+    env:
+      RAYFORCE_GITHUB: "https://github.com/RayforceDB/rayforce.git"
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          submodules: false
+
+      - name: Set up Python 3.14
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.14'
+          cache: 'pip'
+
+      - name: Install system dependencies
+        run: |
+          sudo apt-get update -qq
+          sudo apt-get install -y -qq git gcc clang gcc-c++ make
+
+      - name: Install build dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install setuptools wheel setuptools-scm
+
+      - name: Build rayforce binaries
+        run: make app
+
+      - name: Install test dependencies
+        run: |
+          pip install pytest pytest-cov coverage pandas>=2.0.0 polars>=0.19.0
+
+      - name: Run tests with coverage
+        run: |
+          python -m pytest -x -vv --cov=rayforce --cov-report=term-missing --cov-report=xml --cov-report=html tests/
+
+      - name: Coverage Report
+        run: |
+          python -m coverage report
+          echo "Coverage HTML report generated in htmlcov/index.html"
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v4
+        with:
+          file: ./coverage.xml
+          flags: unittests
+          name: codecov-umbrella
+          fail_ci_if_error: false
+
+      - name: Upload coverage HTML report
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-report
+          path: htmlcov/
+          retention-days: 30

.gitignore

@@ -3,6 +3,17 @@
 .pytest_cache
 .mypy_cache
 
+# Coverage
+.coverage
+.coverage.*
+htmlcov/
+.coverage.*
+*.cover
+.hypothesis/
+.pytest_cache/
+coverage.xml
+*.coveragerc
+
 # Binaries
 rayforce/bin/
 rayforce/rayforce/

Makefile

@@ -73,6 +73,10 @@ app: pull_rayforce_from_github patch_rayforce_makefile rayforce_binaries
 test:
 	python3 -m pytest -x -vv tests/
 
+test-cov:
+	python3 -m pytest -x -vv --cov=rayforce --cov-report=term-missing --cov-report=html tests/
+	python3 -m pytest -x -vv --cov=rayforce --cov-report=term-missing tests/
+
 lint:
 	python3 -m ruff format tests/ rayforce/
 	python3 -m ruff check rayforce/ --fix

pyproject.toml

@@ -30,6 +30,15 @@ rayforce = "rayforce.cli:main"
 pandas = ["pandas>=2.0.0"]
 polars = ["polars>=0.19.0"]
 all = ["pandas>=2.0.0", "polars>=0.19.0"]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+    "coverage>=7.0.0",
+    "ruff>=0.1.0",
+    "mypy>=1.0.0",
+    "pandas>=2.0.0",
+    "polars>=0.19.0",
+]
 
 [tool.cibuildwheel]
 build = "cp311-* cp312-* cp313-* cp314-*"
@@ -141,3 +150,36 @@ quote-style = "double"
 indent-style = "space"
 skip-magic-trailing-comma = false
 line-ending = "auto"
+
+[tool.coverage.run]
+source = ["rayforce"]
+omit = [
+    "*/tests/*",
+    "*/test_*.py",
+    "*/__pycache__/*",
+    "*/setup.py",
+    "*/benchmark/*",
+    "*/scripts/*",
+    "rayforce/rayforce/*",  # C extension code
+    "rayforce/capi/*",  # C API code
+    "rayforce/_rayforce_c.pyi",  # Type stubs
+]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "def __repr__",
+    "raise AssertionError",
+    "raise NotImplementedError",
+    "if __name__ == .__main__.:",
+    "if TYPE_CHECKING:",
+    "@abstractmethod",
+    "class .*\\bProtocol\\):",
+    "@(abc\\.)?abstractmethod",
+]
+precision = 2
+show_missing = true
+skip_covered = false
+
+[tool.coverage.html]
+directory = "htmlcov"