qparse 0.1.0__py3-none-any.whl

qmd_cli.py

@@ -0,0 +1,262 @@
+# -*- coding: utf-8 -*-
+"""QParse 命令行工具：打包 / 解包 / 渲染。"""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Optional
+
+import typer
+
+app = typer.Typer(
+    name="qmd",
+    help="QParse .qmd 打包、解包与渲染工具",
+    add_completion=False,
+    no_args_is_help=True,
+)
+
+
+def _print_path(label: str, path: Path) -> None:
+    typer.echo(f"{label}: {path}")
+
+
+DEFAULT_RENDER_TEMPLATE = """\
+<render src="{src}">
+    <file type="docx" dist="{dist}">
+        <doc theme="{theme}">
+            <after>
+<pagebreak></pagebreak>
+# 参考答案
+
+<reference-answer></reference-answer>
+
+            </after>
+        </doc>
+    </file>
+</render>
+"""
+
+
+def generate_render_md(
+    main_md: Path,
+    output: Optional[Path] = None,
+    dist: str = "习题版.docx",
+    theme: str = "Worksheet",
+    force: bool = False,
+) -> Path:
+    """根据 main.md 生成默认 render.md。"""
+    main_md = main_md.resolve()
+    if not main_md.exists():
+        raise FileNotFoundError(f"main.md 不存在: {main_md}")
+
+    # 默认写到 main.md 同级目录
+    output_path = (output or (main_md.parent / "render.md")).resolve()
+    if output_path.exists() and not force:
+        raise FileExistsError(
+            f"已存在: {output_path}，如需覆盖请加 --force"
+        )
+
+    content = DEFAULT_RENDER_TEMPLATE.format(
+        src=str(main_md),
+        dist=dist,
+        theme=theme,
+    )
+    output_path.parent.mkdir(parents=True, exist_ok=True)
+    output_path.write_text(content, encoding="utf-8")
+    return output_path
+
+
+@app.command("init")
+def init_cmd(
+    main_md: Path = typer.Argument(
+        ...,
+        exists=True,
+        dir_okay=False,
+        readable=True,
+        help="入口 main.md 路径",
+    ),
+    output: Optional[Path] = typer.Option(
+        None,
+        "--output",
+        "-o",
+        help="render.md 输出路径，默认写到 main.md 同级目录",
+    ),
+    dist: str = typer.Option(
+        "习题版.docx",
+        "--dist",
+        "-d",
+        help="默认 DOCX 输出文件名",
+    ),
+    theme: str = typer.Option(
+        "Worksheet",
+        "--theme",
+        help="默认主题名",
+    ),
+    force: bool = typer.Option(
+        False,
+        "--force",
+        "-f",
+        help="若目标已存在则覆盖",
+    ),
+) -> None:
+    """输入 main.md，自动生成默认 render.md。"""
+    try:
+        path = generate_render_md(
+            main_md=main_md,
+            output=output,
+            dist=dist,
+            theme=theme,
+            force=force,
+        )
+    except FileExistsError as exc:
+        typer.echo(str(exc), err=True)
+        raise typer.Exit(code=1) from exc
+
+    _print_path("render", path)
+
+
+@app.command("pack")
+def pack_cmd(
+    entry: Path = typer.Argument(
+        ...,
+        exists=True,
+        dir_okay=False,
+        readable=True,
+        help="入口 render.md 路径",
+    ),
+    output: Optional[Path] = typer.Option(
+        None,
+        "--output",
+        "-o",
+        help="输出 .qmd 路径，默认与 entry 同名",
+    ),
+    workspace: Optional[Path] = typer.Option(
+        None,
+        "--workspace",
+        "-w",
+        exists=True,
+        dir_okay=False,
+        help="code-workspace 路径，默认使用项目根目录 QParse.code-workspace",
+    ),
+) -> None:
+    """将 render.md 及其依赖打包为 .qmd。"""
+    from qparse import QmdPacker
+
+    packer = QmdPacker(workspace=str(workspace) if workspace else None)
+    packed = packer.pack(
+        entry=str(entry),
+        output=str(output) if output else None,
+    )
+    _print_path("qmd", packed)
+    typer.echo(f"documents: {len(packer._documents)}")
+    typer.echo(f"resources: {len(packer._resources)}")
+
+
+@app.command("unpack")
+def unpack_cmd(
+    package: Path = typer.Argument(
+        ...,
+        exists=True,
+        dir_okay=False,
+        readable=True,
+        help=".qmd 包路径",
+    ),
+    target: Optional[Path] = typer.Option(
+        None,
+        "--target",
+        "-t",
+        help="解包目录，默认创建到包旁 .qmd_runtime/<uuid>",
+    ),
+) -> None:
+    """解包 .qmd 到工作目录（保留，不自动删除）。"""
+    from qparse import QmdUnpacker
+
+    unpacker = QmdUnpacker(str(package))
+    out_dir = unpacker.unpack(target=str(target) if target else None)
+    _print_path("dir", out_dir)
+    _print_path("entry", unpacker.entry_path)
+
+
+@app.command("render")
+def render_cmd(
+    entry: Path = typer.Argument(
+        ...,
+        exists=True,
+        dir_okay=False,
+        readable=True,
+        help="render.md 或解包后的入口文件",
+    ),
+) -> None:
+    """根据 render.md 渲染 DOCX，并打印输出路径。"""
+    from qparse import MarkdwonRender
+
+    render = MarkdwonRender(src=str(entry))
+    outputs = render.render()
+    if not outputs:
+        typer.echo("未生成任何文件", err=True)
+        raise typer.Exit(code=1)
+    for path in outputs:
+        _print_path("docx", Path(path))
+
+
+@app.command("build")
+def build_cmd(
+    entry: Path = typer.Argument(
+        ...,
+        exists=True,
+        dir_okay=False,
+        readable=True,
+        help="入口 render.md 路径",
+    ),
+    output: Optional[Path] = typer.Option(
+        None,
+        "--output",
+        "-o",
+        help="输出 .qmd 路径，默认与 entry 同名",
+    ),
+    unpack_dir: Optional[Path] = typer.Option(
+        None,
+        "--unpack-dir",
+        "-u",
+        help="解包目录，默认 <output_stem>_unpacked",
+    ),
+    workspace: Optional[Path] = typer.Option(
+        None,
+        "--workspace",
+        "-w",
+        exists=True,
+        dir_okay=False,
+        help="code-workspace 路径",
+    ),
+) -> None:
+    """一键：打包 → 解包 → 渲染。中间产物均保留。"""
+    from qparse import MarkdwonRender, QmdPacker, QmdUnpacker
+
+    packer = QmdPacker(workspace=str(workspace) if workspace else None)
+    packed = packer.pack(
+        entry=str(entry),
+        output=str(output) if output else None,
+    )
+    _print_path("qmd", packed)
+
+    target = unpack_dir or packed.with_name(f"{packed.stem}_unpacked")
+    unpacker = QmdUnpacker(str(packed))
+    out_dir = unpacker.unpack(target=str(target))
+    _print_path("dir", out_dir)
+    _print_path("entry", unpacker.entry_path)
+
+    render = MarkdwonRender(src=str(unpacker.entry_path))
+    outputs = render.render()
+    if not outputs:
+        typer.echo("未生成任何文件", err=True)
+        raise typer.Exit(code=1)
+    for path in outputs:
+        _print_path("docx", Path(path))
+
+
+def main() -> None:
+    app()
+
+
+if __name__ == "__main__":
+    main()

qparse/__init__.py

@@ -0,0 +1,16 @@
+# -*- coding: utf-8 -*-
+from .markdwon_loader import MarkdownLoader
+from .markdwon_render import MarkdwonRender
+from .qmd_packer import QmdPacker
+from .qmd_unpacker import QmdUnpacker
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "MarkdownLoader",
+    "MarkdwonRender",
+    "QmdPacker",
+    "QmdUnpacker",
+    "__version__",
+]
+

qparse/docx_render/__init__.py

@@ -0,0 +1,3 @@
+# -*- coding: utf-8 -*-
+
+from .docx_render import DocxRender

qparse/docx_render/docx_render.py

@@ -0,0 +1,68 @@
+# -*- coding: utf-8 -*-
+
+from pathlib import Path
+from shutil import copy2, rmtree
+from uuid import uuid4
+from qparse.markdwon_document import *
+from typing import List
+from .write_buffer import *
+
+class DocxRender():
+    
+
+    def __init__(self,MdDoc:MarkdwonDocument):
+        self._mdoc = MdDoc
+        
+        self._temp_file_list = []
+        self._run_time_dir = None
+
+    def __enter__(self):
+        self._run_time_dir = self.src.parent.joinpath(
+            ".qmd_runtime",
+            uuid4().hex
+        )
+        self._run_time_dir.mkdir(parents=True, exist_ok=True)
+        self.render_buffer = DocumentBuffer(self)
+        
+        return self
+
+    def __exit__(self, exc_type, exc_value, traceback):
+        if self._run_time_dir is not None and self._run_time_dir.exists():
+            rmtree(self._run_time_dir)
+        return False
+    @property
+    def src(self)->Path:
+        return Path( self._mdoc.attrs['src'] )
+    @property
+    def run_time_dir(self)->Path:
+        if self._run_time_dir is None:
+            self._run_time_dir = self.src.parent.joinpath(
+                ".qmd_runtime",
+                uuid4().hex
+            )
+        return self._run_time_dir
+    @property
+    def dist(self):
+        return self.src.parent.joinpath("{}.docx".format(self.src.stem))
+    @property
+    def referance_path(self)->Path:
+        return Path(self._mdoc.render_option['docx']['referance']) 
+    
+    def create_temp_file_path(self,fext:str=".md"):
+        file_name = "{:02d}{}".format( len(self._temp_file_list)+1,fext)
+        fpath = self.run_time_dir.joinpath(file_name)
+        self._temp_file_list.append(fpath)
+        return fpath
+    def render(self,dist:str=None):
+        buffer = self.render_buffer.create(
+            type='document',keep_together=False,children=self._mdoc.dump_docx_buffer()
+        )
+        temp_file_dist = buffer.write_to_docx_file()
+        output_path = Path(dist) if dist is not None else self.dist
+        output_path.parent.mkdir(parents=True, exist_ok=True)
+        copy2(temp_file_dist, output_path)
+        
+        return output_path
+    
+    
+