qparse 0.1.0__py3-none-any.whl

qparse/qmd_unpacker.py

@@ -0,0 +1,169 @@
+# -*- coding: utf-8 -*-
+"""将 .qmd 文件解包为可编辑的工作目录。"""
+
+from __future__ import annotations
+
+import json
+import re
+import shutil
+import zipfile
+from pathlib import Path
+from typing import Dict, List, Optional
+from uuid import uuid4
+
+
+class QmdUnpacker:
+    """
+    解压 .qmd 包：
+    1. 展开 documents / resources / themes / templates
+    2. 按 manifest 将资源复制到对应 Markdown 同级的 assets/
+    3. 返回解包目录与入口 render.md 路径
+    """
+
+    IMAGE_PATTERN = re.compile(r"!\[([^\]]*)\]\(([^)]+)\)")
+    HTML_IMG_PATTERN = re.compile(
+        r'<img\b[^>]*\bsrc\s*=\s*["\']([^"\']+)["\'][^>]*>',
+        re.IGNORECASE,
+    )
+
+    def __init__(self, package: str):
+        self.package_path = Path(package).resolve()
+        if not self.package_path.exists():
+            raise FileNotFoundError(f"qmd 包不存在: {self.package_path}")
+        if not zipfile.is_zipfile(self.package_path):
+            raise ValueError(f"不是有效的 qmd 压缩包: {self.package_path}")
+
+        self.manifest: dict = {}
+        self.target_dir: Optional[Path] = None
+
+    def unpack(self, target: Optional[str] = None) -> Path:
+        """
+        解包到目标目录。
+
+        :param target: 目标目录。为空时创建到包旁的 .qmd_runtime/<uuid>
+        :return: 解包后的根目录
+        """
+        if target:
+            self.target_dir = Path(target).resolve()
+        else:
+            self.target_dir = (
+                self.package_path.parent
+                / ".qmd_runtime"
+                / uuid4().hex
+            )
+
+        if self.target_dir.exists():
+            shutil.rmtree(self.target_dir)
+        self.target_dir.mkdir(parents=True, exist_ok=True)
+
+        with zipfile.ZipFile(self.package_path, "r") as zf:
+            zf.extractall(self.target_dir)
+
+        manifest_path = self.target_dir / "manifest.json"
+        if not manifest_path.exists():
+            raise FileNotFoundError(
+                f"缺少 manifest.json: {manifest_path}"
+            )
+        self.manifest = json.loads(
+            manifest_path.read_text(encoding="utf-8")
+        )
+
+        self._materialize_document_assets()
+        return self.target_dir
+
+    @property
+    def entry_path(self) -> Path:
+        if self.target_dir is None:
+            raise RuntimeError("请先调用 unpack()")
+        entry = self.manifest.get("entry", "render.md")
+        path = self.target_dir / entry
+        if not path.exists():
+            raise FileNotFoundError(f"入口文件不存在: {path}")
+        return path
+
+    @property
+    def resources_dir(self) -> Path:
+        if self.target_dir is None:
+            raise RuntimeError("请先调用 unpack()")
+        return self.target_dir / "resources"
+
+    def get_resource_path(self, sha256: str) -> Optional[Path]:
+        resources = self.manifest.get("resources", {})
+        item = resources.get(sha256)
+        if not item:
+            return None
+        path = self.target_dir / item["path"]
+        return path if path.exists() else None
+
+    def _materialize_document_assets(self) -> None:
+        """
+        按需将 resources 中的文件复制到文档同级 assets/，
+        方便编辑器直接预览图片。
+        """
+        document_assets: Dict[str, List[str]] = self.manifest.get(
+            "document_assets",
+            {},
+        )
+        resources: Dict[str, dict] = self.manifest.get("resources", {})
+
+        if document_assets:
+            for doc_rel, sha_list in document_assets.items():
+                doc_path = self.target_dir / doc_rel
+                if not doc_path.exists():
+                    continue
+                assets_dir = doc_path.parent / "assets"
+                assets_dir.mkdir(parents=True, exist_ok=True)
+                for sha in sha_list:
+                    item = resources.get(sha)
+                    if not item:
+                        continue
+                    source = self.target_dir / item["path"]
+                    if not source.exists():
+                        continue
+                    target = assets_dir / Path(item["path"]).name
+                    if not target.exists():
+                        shutil.copy2(source, target)
+            return
+
+        # 兼容没有 document_assets 字段的旧包：扫描 Markdown 中的 ./assets/ 引用
+        for md_path in self.target_dir.rglob("*.md"):
+            text = md_path.read_text(encoding="utf-8")
+            names = set()
+            for match in self.IMAGE_PATTERN.finditer(text):
+                url = match.group(2).strip().split(" ", 1)[0]
+                name = self._asset_name_from_url(url)
+                if name:
+                    names.add(name)
+            for match in self.HTML_IMG_PATTERN.finditer(text):
+                name = self._asset_name_from_url(match.group(1))
+                if name:
+                    names.add(name)
+            if not names:
+                continue
+
+            assets_dir = md_path.parent / "assets"
+            assets_dir.mkdir(parents=True, exist_ok=True)
+            for name in names:
+                source = self.resources_dir / name
+                if not source.exists():
+                    # 也可能在 templates/
+                    alt = self.target_dir / "templates" / name
+                    source = alt if alt.exists() else source
+                if source.exists():
+                    target = assets_dir / name
+                    if not target.exists():
+                        shutil.copy2(source, target)
+
+    @staticmethod
+    def _asset_name_from_url(url: str) -> Optional[str]:
+        value = url.strip().strip('"').strip("'")
+        if not value:
+            return None
+        if value.startswith("http://") or value.startswith("https://"):
+            return None
+        path = Path(value.replace("\\", "/"))
+        if path.parts and path.parts[0] in {".", "..", "assets"}:
+            return path.name
+        if "assets/" in value.replace("\\", "/"):
+            return path.name
+        return None

qparse/render_option/__init__.py

@@ -0,0 +1,40 @@
+# -*- coding: utf-8 -*-
+from __future__ import annotations
+import json
+from .default_render_option import get_default_render_option,SafeGetRenderOption,default_referance_path
+from jinja2 import Environment
+from pathlib import Path
+# 全局复用jinja环境，不要每次新建
+_qeditor_jinja_env = Environment(
+    variable_start_string="[%",
+    variable_end_string="%]",
+    block_start_string="{%",
+    block_end_string="%}",
+    comment_start_string="{#",
+    comment_end_string="#}",
+    autoescape=True,
+)
+
+def render_template(template_text: str, context: dict) -> str:
+    """
+    模板渲染，占位符：[% var_name %]
+    :param template_text: 原始模板字符串，包含 [% label %] [% text %]
+    :param context: 字典 {"label":"xxx","text":"yyy"}
+    :return: 渲染完成后的字符串
+    """
+    tpl = _qeditor_jinja_env.from_string(template_text)
+    return tpl.render(**context)
+
+def get_default_theme():
+    fdir = Path(__file__).parent/"theme.json"
+    with open(fdir,'r',encoding='utf-8') as fp:
+        themes = json.load(fp=fp)
+    for theme_key,option in themes.items():
+        
+        option['docx'].update({"referance":default_referance_path.as_posix()})
+    return themes
+        
+
+DEFAULT_RENDER_OPTION = get_default_render_option()
+
+

qparse/render_option/default_render_option.py

@@ -0,0 +1,86 @@
+# -*- coding: utf-8 -*-
+import copy
+from typing import List
+from pathlib import Path
+default_referance_path = Path(__file__).parent / "referance.docx"
+
+def SafeGetRenderOption(option:dict,path:List[str],default=None):
+    node_option = option
+    for p in path:
+        if node_option:= node_option.get(p,None):
+            pass
+        else:
+            return default
+    return node_option
+
+def get_default_render_option():
+    default_render_option = {
+        "docx":{
+            'referance':default_referance_path.as_posix(),
+            "markdwon-table": {
+                "width_percent": 100,
+                "style": "Table Grid",
+                "header_bold": True,
+                "header_shading": "D9EAF7",
+                "border_color": "B7C9D6",
+                "cell_alignment": "center",
+            }
+        },
+        "markdown": {
+            "head": {
+                "downgrade_heading_level": True,
+            }
+        },
+        "question": {
+            "show_answer": False,
+            "stem": {
+                "show": True,
+                "keep_together":True,
+                "::first-text-visible": {
+                    "template": "[%question_id%]、[%text%]",
+                    '[answer_types="multiple-choice"]':{
+                        "template": "[%question_id%]（多选）、[%text%]"
+                    }
+                },
+                '[answer_types="multiple-choice"]':{
+                    "template": "[%text%]"
+                },
+                '[answer_types="choice"]':{
+                    "template": "[%text%]"
+                },
+                '[answer_types="blank"]':{
+                    "template": "[%text%]\n\n\n\n"
+                },
+                '[answer_types="answer"]':{
+                    "template": "[%text%]\n\n\n\n"
+                },
+            },
+            "analysis": {
+                "show": False,
+                "::first-text-visible": {
+                    "template": "[% text %]"
+                },
+            },
+            ".answer": {
+                ":show_answer": {"template": "[%text%]"},
+                ":not_show_answer": {"template": ""},
+            },
+            ".blank": {
+                ":show_answer": {"template": "[%text%]"},
+                ":not_show_answer": {"template": "  $\\underline{\\hspace{1.8cm}}$ "},
+            },
+            ".choise": {
+                ":show_answer": {"template": "( [% text %] )"},
+                ":not_show_answer": {"template": "(  )"},
+            },
+            
+            ".multiple-choice": {
+                ":show_answer": {"template": "([%text%])"},
+                ":not_show_answer": {"template": "(    )"},
+            },
+            
+        },
+    }
+    return copy.deepcopy(default_render_option)
+
+

qparse/render_option/default_render_template.md

@@ -0,0 +1,21 @@
+<params>
+    <var name="markdwon_src"  value="[%markdwon_src%]" type="str">
+        <!--markdwon 主文件入口-->
+    </var>
+    <var name="docx_referance" value="[%docx_referance%]" type="str">
+        <!--markdwon docx模板样式-->
+    </var>
+    <var name="render_options" value="[%render_options%]" type="str">
+        <!--渲染主题，一般用json 格式存储-->
+    </var>
+    
+</params>
+<system-params>
+    <!--markdwon 系统变量方便取用-->
+    <var name="docDir" desc="markdwon_src所在目录">
+    <var name="docStem" desc="markdwon_src所在目录的文件名">
+</system-params>
+
+<render to="[%docDir%]\[%docStem%]">
+
+

qparse/render_option/theme.json

@@ -0,0 +1,245 @@
+{
+    "Worksheet": {
+        "docx": {
+            "referance": "./referance.docx",
+            "markdwon-table": {
+                "width_percent": 100,
+                "style": "Table Grid",
+                "header_bold": true,
+                "header_shading": "D9EAF7",
+                "border_color": "B7C9D6",
+                "cell_alignment": "center"
+            }
+        },
+        "markdown": {
+            "head": {
+                "downgrade_heading_level": true
+            }
+        },
+        "question": {
+            "show_answer": false,
+            "stem": {
+                "show": true,
+                "keep_together": true,
+                "::first-text-visible": {
+                    "template": "[%question_id%]、[%text%]",
+                    "[answer_types=\"multiple-choice\"]": {
+                        "template": "[%question_id%]（多选）、[%text%]"
+                    }
+                },
+                "[answer_types=\"multiple-choice\"]": {
+                    "template": "[%text%]"
+                },
+                "[answer_types=\"choice\"]": {
+                    "template": "[%text%]"
+                },
+                "[answer_types=\"blank\"]": {
+                    "template": "[%text%]\n\n\n\n"
+                },
+                "[answer_types=\"answer\"]": {
+                    "template": "[%text%]\n\n\n\n"
+                }
+            },
+            "analysis": {
+                "show": false,
+                "::first-text-visible": {
+                    "template": "[% text %]"
+                }
+            },
+            ".answer": {
+                ":show_answer": {
+                    "template": "[%text%]"
+                },
+                ":not_show_answer": {
+                    "template": ""
+                }
+            },
+            ".blank": {
+                ":show_answer": {
+                    "template": "[%text%]"
+                },
+                ":not_show_answer": {
+                    "template": "  $\\underline{\\hspace{1.8cm}}$ "
+                }
+            },
+            ".choise": {
+                ":show_answer": {
+                    "template": "( [% text %] )"
+                },
+                ":not_show_answer": {
+                    "template": "(  )"
+                }
+            },
+            ".multiple-choice": {
+                ":show_answer": {
+                    "template": "([%text%])"
+                },
+                ":not_show_answer": {
+                    "template": "(    )"
+                }
+            }
+        }
+    },
+    "SolutionSheet": {
+        "docx": {
+            "referance": "./referance.docx",
+            "markdwon-table": {
+                "width_percent": 100,
+                "style": "Table Grid",
+                "header_bold": true,
+                "header_shading": "D9EAF7",
+                "border_color": "B7C9D6",
+                "cell_alignment": "center"
+            }
+        },
+        "markdown": {
+            "head": {
+                "downgrade_heading_level": true
+            }
+        },
+        "question": {
+            "show_answer": false,
+            "stem": {
+                "show": false,
+                "keep_together": true,
+                "::first-text-visible": {
+                    "template": "[%question_id%]、[%text%]",
+                    "[answer_types=\"multiple-choice\"]": {
+                        "template": "[%question_id%]（多选）、[%text%]"
+                    }
+                },
+                "[answer_types=\"multiple-choice\"]": {
+                    "template": "[%text%]"
+                },
+                "[answer_types=\"choice\"]": {
+                    "template": "[%text%]"
+                },
+                "[answer_types=\"blank\"]": {
+                    "template": "[%text%]\n\n\n\n"
+                },
+                "[answer_types=\"answer\"]": {
+                    "template": "[%text%]\n\n\n\n"
+                }
+            },
+            "analysis": {
+                "show": true,
+                "::first-text-visible": {
+                    "template": "[% text %]"
+                }
+            },
+            ".answer": {
+                ":show_answer": {
+                    "template": "[%text%]"
+                },
+                ":not_show_answer": {
+                    "template": ""
+                }
+            },
+            ".blank": {
+                ":show_answer": {
+                    "template": "[%text%]"
+                },
+                ":not_show_answer": {
+                    "template": "  $\\underline{\\hspace{1.8cm}}$ "
+                }
+            },
+            ".choise": {
+                ":show_answer": {
+                    "template": "( [% text %] )"
+                },
+                ":not_show_answer": {
+                    "template": "(  )"
+                }
+            },
+            ".multiple-choice": {
+                ":show_answer": {
+                    "template": "([%text%])"
+                },
+                ":not_show_answer": {
+                    "template": "(    )"
+                }
+            }
+        }
+    },
+    "AnnotatedWorksheet": {
+        "docx": {
+            "referance": "./referance.docx",
+            "markdwon-table": {
+                "width_percent": 100,
+                "style": "Table Grid",
+                "header_bold": true,
+                "header_shading": "D9EAF7",
+                "border_color": "B7C9D6",
+                "cell_alignment": "center"
+            }
+        },
+        "markdown": {
+            "head": {
+                "downgrade_heading_level": true
+            }
+        },
+        "question": {
+            "show_answer": true,
+            "stem": {
+                "show": true,
+                "keep_together": true,
+                "::first-text-visible": {
+                    "template": "[%question_id%]、[%text%]",
+                    "[answer_types=\"multiple-choice\"]": {
+                        "template": "[%question_id%]（多选）、[%text%]"
+                    }
+                },
+                "[answer_types=\"multiple-choice\"]": {
+                    "template": "[%text%]"
+                },
+                "[answer_types=\"choice\"]": {
+                    "template": "[%text%]"
+                },
+                "[answer_types=\"blank\"]": {
+                    "template": "[%text%]\n\n\n\n"
+                },
+                "[answer_types=\"answer\"]": {
+                    "template": "[%text%]\n\n\n\n"
+                }
+            },
+            "analysis": {
+                "show": true,
+                "::first-text-visible": {
+                    "template": "[% text %]"
+                }
+            },
+            ".answer": {
+                ":show_answer": {
+                    "template": "[%text%]"
+                },
+                ":not_show_answer": {
+                    "template": ""
+                }
+            },
+            ".blank": {
+                ":show_answer": {
+                    "template": "[%text%]"
+                },
+                ":not_show_answer": {
+                    "template": "  $\\underline{\\hspace{1.8cm}}$ "
+                }
+            },
+            ".choise": {
+                ":show_answer": {
+                    "template": "( [% text %] )"
+                },
+                ":not_show_answer": {
+                    "template": "(  )"
+                }
+            },
+            ".multiple-choice": {
+                ":show_answer": {
+                    "template": "([%text%])"
+                },
+                ":not_show_answer": {
+                    "template": "(    )"
+                }
+            }
+        }
+    }
+}

qparse/utils/__init__.py

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