Add temporary pytest validation workflow

Author: RamonRDR

.github/workflows/apply-phase09-pytest.yml

@@ -0,0 +1,138 @@
+name: Apply pytest chapter synchronization
+
+on:
+  push:
+    branches:
+      - phase-09-pytest-testing-contracts
+
+permissions:
+  contents: write
+
+jobs:
+  sync-and-validate:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+
+    steps:
+      - name: Check out branch
+        uses: actions/checkout@v6
+        with:
+          ref: phase-09-pytest-testing-contracts
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+
+      - name: Install external-library dependencies
+        run: python -m pip install --disable-pip-version-check -r requirements-external.txt
+
+      - name: Show dependency versions
+        run: |
+          python --version
+          python - <<'PY'
+          import openpyxl
+          import pandas
+          import pytest
+          import requests
+          print("pandas", pandas.__version__)
+          print("openpyxl", openpyxl.__version__)
+          print("requests", requests.__version__)
+          print("pytest", pytest.__version__)
+          assert pytest.__version__.startswith("9.1.")
+          PY
+
+      - name: Synchronize Phase 9 pytest chapter
+        run: |
+          python scripts/sync_phase09_pytest.py
+          python - <<'PY'
+          import re
+          from pathlib import Path
+
+          paths = [
+              Path("external-libraries/04-pytest/README.md"),
+              Path("external-libraries/04-pytest/README.pt-BR.md"),
+              Path("external-libraries/04-pytest/README.es.md"),
+          ]
+          texts = [path.read_text(encoding="utf-8") for path in paths]
+          sections = [len(re.findall(r"^## \d+\.", text, flags=re.MULTILINE)) for text in texts]
+          blocks = [re.findall(r"```python\n(.*?)```", text, flags=re.DOTALL) for text in texts]
+          if sections != [97, 97, 97]:
+              raise SystemExit(f"unexpected section counts: {sections}")
+          if not (blocks[0] == blocks[1] == blocks[2]):
+              raise SystemExit("Python fenced blocks differ across languages")
+          print("pytest sections:", sections[0])
+          print("pytest Python blocks:", len(blocks[0]))
+          manifest = Path("scripts/example_manifest.txt").read_text(encoding="utf-8").splitlines()
+          print("approved examples after sync:", len([line for line in manifest if line.strip()]))
+          PY
+
+      - name: Compile Python files
+        run: python -m compileall -q -x '(^|/)\.git/' .
+
+      - name: Run repository unittest suite
+        run: python -m unittest discover -s tests -p 'test_*.py'
+
+      - name: Run repository tests with pytest
+        run: python -m pytest -q tests
+
+      - name: Run approved examples
+        run: python scripts/run_examples.py
+
+      - name: Verify pytest example outputs
+        run: |
+          python - <<'PY'
+          from pathlib import Path
+          import subprocess
+          import sys
+
+          root = Path("external-libraries/04-pytest/examples")
+          expected = {
+              "assertions_and_parametrize.py": "exit code: 0\npassed: 4\n",
+              "capture_output_and_logs.py": "exit code: 0\npassed: 2\n",
+              "exceptions_and_warnings.py": "exit code: 0\npassed: 2\n",
+              "fixtures_and_tmp_path.py": "exit code: 0\npassed: 2\n",
+              "monkeypatch_environment.py": "exit code: 0\npassed: 2\n",
+          }
+          for name, wanted in expected.items():
+              result = subprocess.run(
+                  [sys.executable, str(root / name)],
+                  check=True,
+                  capture_output=True,
+                  text=True,
+                  timeout=30,
+              )
+              if result.stdout != wanted:
+                  raise SystemExit(f"{name}: unexpected output\n{result.stdout!r}\n!=\n{wanted!r}")
+              if result.stderr:
+                  raise SystemExit(f"{name}: unexpected stderr\n{result.stderr}")
+              print(name, "OK")
+          PY
+
+      - name: Check internal Markdown links
+        run: python scripts/check_internal_links.py
+
+      - name: Validate repository structure
+        run: python scripts/validate_repository_structure.py
+
+      - name: Check diff whitespace
+        run: git diff --check
+
+      - name: Remove temporary synchronization tooling
+        run: |
+          rm scripts/sync_phase09_pytest.py
+          rm .github/workflows/apply-phase09-pytest.yml
+          git diff --check
+
+      - name: Commit synchronized chapter
+        run: |
+          git config user.name "Ramon Rodriguez"
+          git config user.email "ramoncorreka@hotmail.com"
+          git add -A
+          if git diff --cached --quiet; then
+            echo "No synchronized changes to commit."
+            exit 0
+          fi
+          git commit -m "Synchronize Phase 9 pytest chapter"
+          git push origin HEAD:phase-09-pytest-testing-contracts