Enhance reader styles exports and settings
This commit is contained in:
+183
-2
@@ -2,13 +2,16 @@ from pathlib import Path
|
||||
from tempfile import TemporaryDirectory
|
||||
|
||||
from mdhelper.app import parse_arguments
|
||||
from mdhelper import search as search_module
|
||||
from mdhelper.doc_check import check_documents
|
||||
from mdhelper.document_tree import discover_documents
|
||||
from mdhelper.code_structure import extract_code_headings
|
||||
from mdhelper.document_tree import DocumentEntry, MAX_DISCOVERABLE_CODE_BYTES, 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
|
||||
from mdhelper.style_dialog import build_document_style_css
|
||||
|
||||
|
||||
def test_sample_media_and_code_rendering() -> None:
|
||||
@@ -34,6 +37,14 @@ def test_sample_media_and_code_rendering() -> None:
|
||||
assert "copy-code-button" in html
|
||||
assert "code-line" in html
|
||||
assert "toggle-code-button" in html
|
||||
assert 'toggle.textContent = "收起";' in html
|
||||
assert 'block.classList.add("is-collapsible");' in html
|
||||
assert 'block.classList.add("is-collapsible", "is-collapsed")' not in html
|
||||
assert '${line || " "}' in html
|
||||
assert '.join("");' in html
|
||||
assert "#569cd6" in html
|
||||
assert "#ce9178" in html
|
||||
assert "#1e1e1e" in html
|
||||
assert "image-lightbox" in html
|
||||
assert "image-lightbox__toolbar" in html
|
||||
assert 'data-action="fit"' in html
|
||||
@@ -52,6 +63,8 @@ def test_sample_media_and_code_rendering() -> None:
|
||||
assert "flowchart LR" in html
|
||||
assert "math-block" in html
|
||||
assert "data-math-engine=\"katex\"" in html
|
||||
assert "data-wheel-scroll-speed=\"1.0\"" in html
|
||||
assert "configuredWheelSpeed" in html
|
||||
assert "--reader-font-family:" in html
|
||||
assert "--reader-font-size:" in html
|
||||
assert "katex.min.css" in html
|
||||
@@ -68,10 +81,18 @@ def test_sample_media_and_code_rendering() -> None:
|
||||
project_root / "sample.md",
|
||||
document_font_family="Microsoft YaHei UI",
|
||||
document_font_size=18,
|
||||
wheel_scroll_speed=2.4,
|
||||
)
|
||||
assert "data-wheel-scroll-speed=\"2.4\"" in custom_font_html
|
||||
assert '"Microsoft YaHei UI"' in custom_font_html
|
||||
assert "--reader-font-size: 18px;" in custom_font_html
|
||||
|
||||
custom_style_html = renderer.render_file(
|
||||
project_root / "sample.md",
|
||||
document_style_css=".reader { max-width: 720px; }",
|
||||
)
|
||||
assert ".reader { max-width: 720px; }" in custom_style_html
|
||||
|
||||
|
||||
def test_heading_extraction_matches_rendered_anchor() -> None:
|
||||
project_root = Path(__file__).resolve().parent.parent
|
||||
@@ -82,6 +103,50 @@ def test_heading_extraction_matches_rendered_anchor() -> None:
|
||||
assert any(heading.title == "10. Mermaid 图表示例" for heading in headings)
|
||||
|
||||
|
||||
def test_document_style_builder_supports_word_like_paragraph_options() -> None:
|
||||
css = build_document_style_css(
|
||||
{
|
||||
"paragraph": {
|
||||
"chinese_font_family": "Microsoft YaHei UI",
|
||||
"english_font_family": "Times New Roman",
|
||||
"font_size": 18,
|
||||
"line_height_value": 1.7,
|
||||
"line_height_unit": "multiple",
|
||||
"first_line_indent_chars": 2,
|
||||
"space_before_value": 6,
|
||||
"space_before_unit": "pt",
|
||||
"space_after_value": 0.6,
|
||||
"space_after_unit": "multiple",
|
||||
},
|
||||
"h2": {
|
||||
"bold": True,
|
||||
"hanging_indent_chars": 1.5,
|
||||
},
|
||||
"blockquote": {
|
||||
"chinese_font_family": "KaiTi",
|
||||
"english_font_family": "Georgia",
|
||||
},
|
||||
},
|
||||
".reader strong { color: #0057b8; }",
|
||||
)
|
||||
|
||||
assert ".reader p" in css
|
||||
assert 'font-family: "Times New Roman", "Microsoft YaHei UI"' in css
|
||||
assert "font-size: 18px;" in css
|
||||
assert "line-height: 1.7;" in css
|
||||
assert "text-indent: 2em;" in css
|
||||
assert "margin-top: 6pt;" in css
|
||||
assert "margin-bottom: 0.6em;" in css
|
||||
assert ".reader h2" in css
|
||||
assert "font-weight: 700;" in css
|
||||
assert "padding-left: 1.5em;" in css
|
||||
assert "text-indent: -1.5em;" in css
|
||||
assert ".reader blockquote p" in css
|
||||
assert ".reader .admonition p" in css
|
||||
assert 'font-family: "Georgia", "KaiTi"' in css
|
||||
assert ".reader strong { color: #0057b8; }" in css
|
||||
|
||||
|
||||
def test_full_text_search_finds_document_body() -> None:
|
||||
project_root = Path(__file__).resolve().parent.parent
|
||||
entries = discover_documents(project_root)
|
||||
@@ -142,7 +207,7 @@ def test_document_checker_reports_missing_local_target() -> None:
|
||||
|
||||
def test_app_arguments_support_initial_file_and_check_mode() -> None:
|
||||
args = parse_arguments(["sample.md"])
|
||||
assert args.file == "sample.md"
|
||||
assert args.path == "sample.md"
|
||||
assert not args.check
|
||||
|
||||
check_args = parse_arguments(["--check", "--project-root", "."])
|
||||
@@ -162,3 +227,119 @@ def test_navigation_history_preserves_scroll_position() -> None:
|
||||
assert history.current is not None
|
||||
assert history.current.scroll_y == 120
|
||||
assert history.back() == first
|
||||
|
||||
|
||||
def test_document_discovery_filters_optional_code_groups(tmp_path: Path) -> None:
|
||||
(tmp_path / "guide.md").write_text("# Guide\n", encoding="utf-8")
|
||||
(tmp_path / "tool.py").write_text("def run():\n return 1\n", encoding="utf-8")
|
||||
(tmp_path / "engine.cpp").write_text("int solve() { return 1; }\n", encoding="utf-8")
|
||||
|
||||
default_entries = discover_documents(tmp_path)
|
||||
all_entries = discover_documents(tmp_path, ("markdown", "python", "cpp"))
|
||||
|
||||
assert [entry.path.name for entry in default_entries] == ["guide.md"]
|
||||
assert {entry.path.name for entry in all_entries} == {"guide.md", "tool.py", "engine.cpp"}
|
||||
|
||||
|
||||
def test_document_discovery_prunes_excluded_directories(tmp_path: Path) -> None:
|
||||
(tmp_path / "guide.md").write_text("# Guide\n", encoding="utf-8")
|
||||
hidden_git = tmp_path / ".git"
|
||||
hidden_git.mkdir()
|
||||
(hidden_git / "hidden.md").write_text("# Hidden\n", encoding="utf-8")
|
||||
build_dir = tmp_path / "build"
|
||||
build_dir.mkdir()
|
||||
(build_dir / "generated.py").write_text("def generated():\n return 1\n", encoding="utf-8")
|
||||
|
||||
entries = discover_documents(tmp_path, ("markdown", "python"))
|
||||
|
||||
assert {entry.relative_path for entry in entries} == {"guide.md"}
|
||||
|
||||
|
||||
def test_search_index_reads_body_lazily(tmp_path: Path, monkeypatch) -> None:
|
||||
path = tmp_path / "guide.md"
|
||||
path.write_text("placeholder", encoding="utf-8")
|
||||
entry = DocumentEntry(path=path, title="Guide", relative_path="guide.md")
|
||||
calls: list[Path] = []
|
||||
|
||||
def fake_read_text(read_entry: DocumentEntry) -> str:
|
||||
calls.append(read_entry.path)
|
||||
return "body needle"
|
||||
|
||||
monkeypatch.setattr(search_module, "_read_text", fake_read_text)
|
||||
|
||||
index = search_module.SearchIndex([entry])
|
||||
|
||||
assert calls == []
|
||||
assert index.search("Guide")[0].match_kind == "标题"
|
||||
assert calls == []
|
||||
assert index.search("needle")[0].match_kind == "正文"
|
||||
assert calls == [entry.path]
|
||||
|
||||
def test_code_file_rendering_uses_highlighting_and_line_anchors(tmp_path: Path) -> None:
|
||||
code_path = tmp_path / "tool.py"
|
||||
source = "class Runner:\n def run(self):\n return 1\n"
|
||||
renderer = MarkdownRenderer(tmp_path)
|
||||
|
||||
html = renderer.render_code_source(source, code_path, language="python")
|
||||
|
||||
assert "code-file-view" in html
|
||||
assert "language-python" in html
|
||||
assert "line-1" in html
|
||||
assert "Runner" in html
|
||||
|
||||
|
||||
def test_code_headings_extract_python_and_cpp_symbols(tmp_path: Path) -> None:
|
||||
python_path = tmp_path / "tool.py"
|
||||
cpp_path = tmp_path / "engine.cpp"
|
||||
python_source = "class Runner:\n def run(self):\n return 1\n\nasync def main():\n return None\n"
|
||||
cpp_source = "struct Node { int value; };\n\nint solve(int value) { return value; }\n"
|
||||
|
||||
python_headings = extract_code_headings(python_path, python_source)
|
||||
cpp_headings = extract_code_headings(cpp_path, cpp_source)
|
||||
|
||||
assert [heading.title for heading in python_headings] == ["class Runner", "def run", "async def main"]
|
||||
assert [heading.slug for heading in python_headings] == ["line-1", "line-2", "line-5"]
|
||||
assert any(heading.title == "struct Node" for heading in cpp_headings)
|
||||
assert any(heading.title == "function solve" for heading in cpp_headings)
|
||||
|
||||
|
||||
def test_search_index_reads_optional_code_documents(tmp_path: Path) -> None:
|
||||
(tmp_path / "tool.py").write_text("def calculate_magic_value():\n return 42\n", encoding="utf-8")
|
||||
entries = discover_documents(tmp_path, ("python",))
|
||||
|
||||
matches = SearchIndex(entries).search("magic_value")
|
||||
|
||||
assert matches
|
||||
assert matches[0].entry.path.name == "tool.py"
|
||||
assert matches[0].match_kind == "正文"
|
||||
|
||||
|
||||
def test_large_code_files_are_not_auto_discovered(tmp_path: Path) -> None:
|
||||
(tmp_path / "guide.md").write_text("# Guide\n", encoding="utf-8")
|
||||
large_code = tmp_path / "large_module.py"
|
||||
large_code.write_text("# large\n" + ("x = 1\n" * ((MAX_DISCOVERABLE_CODE_BYTES // 6) + 2)), encoding="utf-8")
|
||||
|
||||
entries = discover_documents(tmp_path, ("markdown", "python"))
|
||||
|
||||
assert {entry.path.name for entry in entries} == {"guide.md"}
|
||||
|
||||
|
||||
def test_code_search_reads_gbk_source(tmp_path: Path) -> None:
|
||||
source_path = tmp_path / "legacy.py"
|
||||
source_path.write_text("# 中文注释\ndef legacy_name():\n return '命中'\n", encoding="gbk")
|
||||
entries = discover_documents(tmp_path, ("python",))
|
||||
|
||||
matches = SearchIndex(entries).search("命中")
|
||||
|
||||
assert matches
|
||||
assert matches[0].entry.path.name == "legacy.py"
|
||||
|
||||
|
||||
def test_code_headings_read_gbk_source_when_source_not_supplied(tmp_path: Path) -> None:
|
||||
source_path = tmp_path / "legacy.py"
|
||||
source_path.write_text("class 中文类:\n def run(self):\n return 1\n", encoding="gbk")
|
||||
|
||||
headings = extract_code_headings(source_path)
|
||||
|
||||
assert headings[0].title == "class 中文类"
|
||||
assert headings[1].title == "def run"
|
||||
|
||||
Reference in New Issue
Block a user