test_index_html_offline.py

Go to the documentation of this file.

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
# tests/tests_assets/test_index_html_offline.py
 
"""
Purpose
-------
OI-532 regression — ``assets/index.html`` must render without reaching
out to ``fonts.googleapis.com`` or ``fonts.gstatic.com``. Web fonts are
self-hosted under ``assets/fonts/`` and referenced via inline
``@font-face`` declarations.
 
Responsibilities
----------------
- No ``fonts.googleapis.com`` / ``fonts.gstatic.com`` hosts appear.
- Every ``@font-face`` ``src: url(...)`` points at a relative path
  rooted in ``fonts/``, and the target ``.woff2`` file exists on disk.
 
Diagnostics
-----------
Domain: ASSETS-TESTS
Levels:
    L2 — test lifecycle
    L3 — assertion details
    L4 — deep tracing
 
Contracts
---------
- Tests read ``assets/index.html`` from the repository root; no temp
  files are created.
- All assertions are read-only checks against existing project assets.
"""
 
from __future__ import annotations
 
import re
from pathlib import Path
 
 
REPO_ROOT = Path(__file__).resolve().parents[3]
INDEX_HTML = REPO_ROOT / "assets" / "index.html"
FONTS_DIR = REPO_ROOT / "assets" / "fonts"
 
 
def _index_text() -> str:
    return INDEX_HTML.read_text(encoding="utf-8")
 
 
def test_no_external_font_hosts_in_index_html():
    text = _index_text()
    assert "fonts.googleapis.com" not in text, (
        "assets/index.html must not reference fonts.googleapis.com "
        "(OI-532: fonts are self-hosted under assets/fonts/)"
    )
    assert "fonts.gstatic.com" not in text, (
        "assets/index.html must not reference fonts.gstatic.com "
        "(OI-532: fonts are self-hosted under assets/fonts/)"
    )
 
 
def test_every_font_face_src_points_at_local_woff2():
    text = _index_text()
    srcs = re.findall(r"src:\s*url\‍(['\"]?([^'\")]+)['\"]?\‍)", text)
    assert srcs, "expected at least one @font-face src: url(...) declaration"
    for src in srcs:
        assert src.startswith("fonts/"), (
            f"@font-face src {src!r} must be rooted in fonts/ (relative)"
        )
        assert src.endswith(".woff2"), (
            f"@font-face src {src!r} must be a .woff2 file"
        )
        target = FONTS_DIR / Path(src).name
        assert target.is_file(), f"missing vendored font file: {target}"