Files
MDHelper/tests/test_renderer.py
T
2026-05-27 17:29:46 +08:00

165 lines
6.2 KiB
Python

from pathlib import Path
from tempfile import TemporaryDirectory
from mdhelper.app import parse_arguments
from mdhelper.doc_check import check_documents
from mdhelper.document_tree import discover_documents
from mdhelper.history import HistoryItem, NavigationHistory
from mdhelper.main_window import re_find_markdown_links
from mdhelper.markdown_utils import extract_headings
from mdhelper.markdown_renderer import MarkdownRenderer
from mdhelper.search import SearchIndex, search_entries
def test_sample_media_and_code_rendering() -> None:
project_root = Path(__file__).resolve().parent.parent
renderer = MarkdownRenderer(project_root)
html = renderer.render_file(project_root / "sample.md")
assert "<table>" in html
assert "<audio controls" in html
assert "media-player-link" in html
assert "用内置播放器打开" in html
assert "用外部播放器打开" in html
assert "mdhelper-open=player-new-tab" in html
assert "mdhelper-open=external" in html
assert "file:///" in html
assert 'href="file:///' in html
assert "docs/user_manual.md" in html
assert "media/animation.gif" in html
assert "language-pseudocode" in html
assert 'id="2-表格示例"' in html
assert 'href="#2-%E8%A1%A8%E6%A0%BC%E7%A4%BA%E4%BE%8B"' in html
assert f'{project_root.as_uri()}#2-%E8%A1%A8%E6%A0%BC%E7%A4%BA%E4%BE%8B' not in html
assert "copy-code-button" in html
assert "code-line" in html
assert "toggle-code-button" in html
assert "image-lightbox" in html
assert "image-lightbox__toolbar" in html
assert 'data-action="fit"' in html
assert 'data-action="actual-size"' in html
assert 'data-action="save"' in html
assert 'data-action="reveal"' in html
assert "copy-table-button" in html
assert "table-wrapper" in html
assert "task-list-item-checkbox" in html
assert "admonition admonition-tip" in html
assert "admonition admonition-note" in html
assert "admonition admonition-important" in html
assert "admonition admonition-warning" in html
assert "admonition admonition-caution" in html
assert '<pre class="mermaid">' in html
assert "flowchart LR" in html
assert "math-block" in html
assert "data-math-engine=\"katex\"" in html
assert "--reader-font-family:" in html
assert "--reader-font-size:" in html
assert "katex.min.css" in html
assert "auto-render.min.js" in html
assert "window.mermaid" in html
assert "mermaid.min.js" in html
assert "qrc:///qtwebchannel/qwebchannel.js" in html
mathjax_html = renderer.render_file(project_root / "sample.md", math_engine="mathjax")
assert "data-math-engine=\"mathjax\"" in mathjax_html
assert "window.MathJax" in mathjax_html
custom_font_html = renderer.render_file(
project_root / "sample.md",
document_font_family="Microsoft YaHei UI",
document_font_size=18,
)
assert '"Microsoft YaHei UI"' in custom_font_html
assert "--reader-font-size: 18px;" in custom_font_html
def test_heading_extraction_matches_rendered_anchor() -> None:
project_root = Path(__file__).resolve().parent.parent
headings = extract_headings(project_root / "sample.md")
assert any(heading.slug == "2-表格示例" for heading in headings)
assert any(heading.title == "7. 视频/动画示例" for heading in headings)
assert any(heading.title == "10. Mermaid 图表示例" for heading in headings)
def test_full_text_search_finds_document_body() -> None:
project_root = Path(__file__).resolve().parent.parent
entries = discover_documents(project_root)
matches = search_entries(entries, "斐波那契")
assert matches
assert matches[0].entry.path.name == "sample.md"
assert matches[0].match_count >= 1
assert matches[0].match_kind in {"标题", "路径", "正文"}
index = SearchIndex(entries)
indexed_matches = index.search("斐波那契")
assert indexed_matches
assert indexed_matches[0].entry.path.name == "sample.md"
assert indexed_matches[0].match_count >= 1
def test_markdown_link_extraction_for_watchers() -> None:
links = re_find_markdown_links(
'![截图](media/screenshot.png)\n'
'[用户手册](docs/user_manual.md)\n'
'<video src="media/demo.mp4"></video>'
)
assert "media/screenshot.png" in links
assert "docs/user_manual.md" in links
assert "media/demo.mp4" in links
def test_local_links_are_absolute_file_urls() -> None:
project_root = Path(__file__).resolve().parent.parent
renderer = MarkdownRenderer(project_root)
html = renderer.render_file(project_root / "sample.md")
assert (project_root / "docs" / "user_manual.md").resolve().as_uri() in html
assert (project_root / "media" / "screenshot.png").resolve().as_uri() in html
assert (project_root / "media" / "demo.mp4").resolve().as_uri() in html
def test_document_checker_reports_missing_local_target() -> None:
with TemporaryDirectory() as temp_dir:
root = Path(temp_dir)
docs = root / "docs"
docs.mkdir()
(docs / "ok.md").write_text("# OK\n", encoding="utf-8")
(root / "sample.md").write_text(
"[存在](docs/ok.md)\n"
"![缺失](media/missing.png)\n"
"[网页](https://example.com)\n",
encoding="utf-8",
)
issues = check_documents(root)
assert len(issues) == 1
assert issues[0].target == "media/missing.png"
def test_app_arguments_support_initial_file_and_check_mode() -> None:
args = parse_arguments(["sample.md"])
assert args.file == "sample.md"
assert not args.check
check_args = parse_arguments(["--check", "--project-root", "."])
assert check_args.check
assert check_args.project_root == "."
def test_navigation_history_preserves_scroll_position() -> None:
history = NavigationHistory()
first = HistoryItem(path=Path("sample.md"), scroll_y=320)
second = HistoryItem(path=Path("docs/user_manual.md"), fragment="intro", scroll_y=0)
history.push(first)
history.push(second)
history.replace_current(HistoryItem(path=second.path, fragment=second.fragment, scroll_y=120))
assert history.current is not None
assert history.current.scroll_y == 120
assert history.back() == first