Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.
Python ai4sciencedocument-analysisdocxextract-datalayout-analysisocrparserpdfpdf-converterpdf-extractor-llmpdf-extractor-pretrainpdf-extractor-ragpdf-parserpptxpythonxlsx
feat: configure global log level before rendering and parsing operations
myhlolie37919c8ebbc
diff --git a/mineru/parser/api_server.py b/mineru/parser/api_server.pyindex 6960193b..8f387064 100644--- a/mineru/parser/api_server.py+++ b/mineru/parser/api_server.py@@ -1480,6 +1480,7 @@ async def _run_job(source_uri=extracted.source_uri,local_resource_root=extracted.local_resource_root,transport_encoding=extracted.transport_encoding,+ fetch_remote_images=True,)result = await parse_async(str(tmp_path),diff --git a/mineru/parser/mineru_parser.py b/mineru/parser/mineru_parser.pyindex ba8cd683..bceaec71 100644--- a/mineru/parser/mineru_parser.py+++ b/mineru/parser/mineru_parser.py@@ -18,6 +18,7 @@ from ..errors import InvalidRequestErrorfrom ..filetypes import IMAGE_EXTENSIONS, PAGE_RANGE_PARSE_EXTENSIONSfrom ..integrations.docvortex import read_source_propertiesfrom ..utils.async_utils import run_sync+from ..utils.logger import configure_global_log_levelfrom ..types import FILE_SUFFIXES, FileSuffix, MiddleJson, ModelJson, PageInfo, Tierfrom .base import DocumentParser, ParseResultfrom .tier import effort_for_tier@@ -71,6 +72,7 @@ class MinerUParser(DocumentParser):source_context: HtmlSourceContext | None = None,) -> ParseResult:"""解析本地路径,并允许内部调用方覆盖 HTML 原始来源上下文。"""+ configure_global_log_level()path = Path(path)if not path.exists():raise FileNotFoundError(path)@@ -93,6 +95,7 @@ class MinerUParser(DocumentParser):source_context: HtmlSourceContext | None = None,) -> ParseResult:"""异步解析本地路径,并保留 HTML 下载来源或本地资源根。"""+ configure_global_log_level()path = Path(path)if not path.exists():raise FileNotFoundError(path)@@ -190,6 +193,7 @@ class MinerUParser(DocumentParser):resolved_source_context = HtmlSourceContext(source_uri=resolved_path.as_uri(),local_resource_root=resolved_path.parent,+ fetch_remote_images=True,)source_properties = (DocumentProperties()diff --git a/mineru/render/api.py b/mineru/render/api.pyindex acfcd6ad..70f80abb 100644--- a/mineru/render/api.py+++ b/mineru/render/api.py@@ -6,6 +6,7 @@ from __future__ import annotationsfrom typing import Any, Literal, overloadfrom ..types import MiddleJson+from ..utils.logger import configure_global_log_levelfrom .contracts import (ContentListRenderOptions,@@ -138,6 +139,7 @@ def render(options: RenderOptions | None = None,) -> RenderOutput:"""按严格目标格式和对应选项把 MiddleJson 渲染为原生结果。"""+ configure_global_log_level()if not isinstance(middle_json, MiddleJson):raise TypeError("render expects a MiddleJson instance")if not isinstance(output_format, RenderFormat):diff --git a/tests/unittest/test_global_log_level.py b/tests/unittest/test_global_log_level.pyindex a1296978..aece0323 100644--- a/tests/unittest/test_global_log_level.py+++ b/tests/unittest/test_global_log_level.py@@ -125,3 +125,51 @@ def test_helper_module_has_no_runtime_side_effect() -> None:)assert json.loads(completed.stdout) == [0]+++def test_parser_entry_configures_before_docvortex(monkeypatch: pytest.MonkeyPatch, tmp_path) -> None:+ """验证直接实例化 MinerUParser 时,日志配置先于 prepare 阶段的 docvortex 调用。"""+ import mineru.parser.mineru_parser as mineru_parser_module++ calls: list[str] = []+ monkeypatch.setattr(+ mineru_parser_module,+ "configure_global_log_level",+ lambda: calls.append("configure"),+ )++ def fake_read_source_properties(*args: object, **kwargs: object) -> None:+ calls.append("docvortex")++ monkeypatch.setattr(mineru_parser_module, "read_source_properties", fake_read_source_properties)++ def stop_after_prepare(*args: object, **kwargs: object) -> None:+ raise RuntimeError("stop-after-prepare")++ monkeypatch.setattr(mineru_parser_module, "doc_analyze", stop_after_prepare)++ source = tmp_path / "sample.csv"+ source.write_text("a,b\n1,2\n", encoding="utf-8")+ parser = mineru_parser_module.MinerUParser()++ with pytest.raises(RuntimeError, match="stop-after-prepare"):+ parser.parse(source)++ assert calls == ["configure", "docvortex"]+++def test_render_entry_configures_global_log_level(monkeypatch: pytest.MonkeyPatch) -> None:+ """验证 render 统一入口在任何渲染分发前完成日志配置。"""+ import mineru.render.api as render_api_module++ calls: list[str] = []+ monkeypatch.setattr(+ render_api_module,+ "configure_global_log_level",+ lambda: calls.append("configure"),+ )++ with pytest.raises(TypeError):+ render_api_module.render(object(), render_api_module.RenderFormat.MARKDOWN)++ assert calls == ["configure"]diff --git a/tools/validate_docvortex_boundary.py b/tools/validate_docvortex_boundary.pyindex df305d1c..a4650c4e 100644--- a/tools/validate_docvortex_boundary.py+++ b/tools/validate_docvortex_boundary.py@@ -23,7 +23,9 @@ def capture(args: argparse.Namespace) -> None:from mineru.backend.analyze import doc_analyzefrom mineru.config import configfrom mineru.render import RenderFormat, render+ from mineru.utils.logger import configure_global_log_level+ configure_global_log_level()config.llm_aided.features.title_leveling = Falseconfig.llm_aided.features.cross_page_table_cell_merge = Falseargs.output.mkdir(parents=True, exist_ok=True)