mdpersia 0.3.0__py3-none-any.whl

fa_md_pdf/__init__.py

@@ -0,0 +1,3 @@
+"""Convert Persian/RTL Markdown files with Mermaid diagrams to PDF."""
+
+__version__ = "0.3.0"

fa_md_pdf/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

fa_md_pdf/assets/default.css

@@ -0,0 +1,319 @@
+:root {
+  color-scheme: light;
+}
+
+html[dir="rtl"] {
+  direction: rtl;
+}
+
+html[dir="ltr"] {
+  direction: ltr;
+}
+
+body {
+  text-align: start;
+  font-family: "Vazirmatn", "Noto Naskh Arabic", "Segoe UI", Tahoma, Arial, sans-serif;
+  font-size: 12pt;
+  line-height: 1.8;
+  color: #1f2937;
+  background: #ffffff;
+  margin: 0;
+}
+
+.markdown-body {
+  max-width: 100%;
+}
+
+p,
+li,
+blockquote,
+td,
+th,
+figcaption {
+  unicode-bidi: isolate;
+}
+
+html[dir="rtl"] body {
+  direction: rtl;
+  text-align: right;
+}
+
+html[dir="ltr"] body {
+  direction: ltr;
+  text-align: left;
+}
+
+/* Direction-aware prose blocks:
+   Avoid unicode-bidi: plaintext on block elements, as plaintext classifies
+   any Persian sentence that opens with a Latin term/keyword as LTR!
+*/
+html[dir="rtl"] :is(p, li, dd, dt, blockquote, h1, h2, h3, h4, h5, h6, th, td, figcaption) {
+  direction: rtl;
+  text-align: right;
+  unicode-bidi: isolate;
+}
+
+html[dir="ltr"] :is(p, li, dd, dt, blockquote, h1, h2, h3, h4, h5, h6, th, td, figcaption) {
+  direction: ltr;
+  text-align: left;
+  unicode-bidi: isolate;
+}
+
+/* Explicit direction overrides for bilingual mixed documents */
+:is([dir="ltr"]:not(html, body), [dir="ltr"]:not(html, body) :is(p, li, dd, dt, blockquote, h1, h2, h3, h4, h5, h6, th, td)) {
+  direction: ltr !important;
+  text-align: left !important;
+  unicode-bidi: isolate;
+}
+
+:is([dir="rtl"]:not(html, body), [dir="rtl"]:not(html, body) :is(p, li, dd, dt, blockquote, h1, h2, h3, h4, h5, h6, th, td)) {
+  direction: rtl !important;
+  text-align: right !important;
+  unicode-bidi: isolate;
+}
+
+/* Bi-directional phrasing elements */
+:is(a, span, strong, em, b, i, u, s, mark, code) {
+  unicode-bidi: isolate;
+}
+
+:is(h1, h2, h3, h4, h5, h6) {
+  color: #111827;
+  line-height: 1.45;
+  margin-top: 1.6em;
+  margin-bottom: 0.65em;
+  break-after: avoid;
+  unicode-bidi: isolate;
+}
+
+h1 {
+  font-size: 24pt;
+  border-bottom: 1px solid #e5e7eb;
+  padding-bottom: 0.25em;
+}
+
+h2 {
+  font-size: 18pt;
+}
+
+h3 {
+  font-size: 15pt;
+}
+
+p {
+  margin: 0.65em 0;
+}
+
+a {
+  color: #075985;
+  text-decoration: none;
+}
+
+blockquote {
+  border-inline-start: 4px solid #d1d5db;
+  border-inline-end: none;
+  margin: 1em 0;
+  padding-inline-start: 1em;
+  padding-inline-end: 0.5em;
+  padding-block: 0.3em;
+  color: #4b5563;
+  background: #f9fafb;
+}
+
+ul,
+ol {
+  padding-inline-start: 1.6em;
+  padding-inline-end: 0;
+}
+
+ul[dir="rtl"],
+ol[dir="rtl"] {
+  padding-inline-start: 1.6em !important;
+  padding-inline-end: 0 !important;
+  direction: rtl !important;
+}
+
+ul[dir="ltr"],
+ol[dir="ltr"] {
+  padding-inline-start: 1.6em !important;
+  padding-inline-end: 0 !important;
+  direction: ltr !important;
+}
+
+table {
+  width: 100%;
+  border-collapse: collapse;
+  margin: 1em 0;
+  break-inside: auto;
+}
+
+thead {
+  display: table-header-group;
+}
+
+tr {
+  break-inside: avoid;
+}
+
+th,
+td {
+  border: 1px solid #d1d5db;
+  padding: 0.45em 0.6em;
+  vertical-align: top;
+}
+
+th {
+  background: #f3f4f6;
+  font-weight: 700;
+}
+
+img,
+svg {
+  max-width: 100%;
+  height: auto;
+}
+
+pre {
+  direction: ltr !important;
+  text-align: left !important;
+  unicode-bidi: isolate !important;
+  font-family: Consolas, "Cascadia Mono", "Courier New", monospace;
+}
+
+code,
+kbd,
+samp {
+  unicode-bidi: isolate !important;
+  font-family: Consolas, "Cascadia Mono", "Courier New", monospace;
+}
+
+code {
+  background: #f3f4f6;
+  border-radius: 4px;
+  padding: 0.08em 0.25em;
+  font-size: 0.9em;
+}
+
+pre {
+  background: #f3f4f6;
+  border: 1px solid #e5e7eb;
+  border-radius: 8px;
+  padding: 0.9em;
+  overflow-wrap: break-word;
+  white-space: pre-wrap;
+  margin: 1em 0;
+}
+
+pre code {
+  background: transparent;
+  padding: 0;
+}
+
+.mermaid {
+  direction: ltr;
+  text-align: center;
+  margin: 1.2em auto;
+  page-break-inside: avoid;
+  break-inside: avoid;
+}
+
+.mermaid svg {
+  max-width: 100%;
+  height: auto;
+}
+
+hr {
+  border: none;
+  border-top: 1px solid #e5e7eb;
+  margin: 2em 0;
+}
+
+@media print {
+  body {
+    -webkit-print-color-adjust: exact;
+    print-color-adjust: exact;
+  }
+
+  a {
+    color: inherit;
+  }
+}
+
+/* Page Break */
+.page-break, hr.page-break {
+  page-break-after: always;
+  break-after: page;
+}
+
+/* Callout / Admonitions */
+blockquote.callout {
+  border-right-width: 4px;
+  border-radius: 6px;
+  padding: 0.8em 1.2em;
+  margin: 1.2em 0;
+  color: #1f2937;
+}
+.callout-title {
+  font-weight: 700;
+  margin-bottom: 0.4em;
+  display: flex;
+  align-items: center;
+  gap: 0.5em;
+}
+blockquote.callout-note {
+  border-right-color: #2563eb;
+  background: #eff6ff;
+}
+blockquote.callout-tip {
+  border-right-color: #16a34a;
+  background: #f0fdf4;
+}
+blockquote.callout-important {
+  border-right-color: #7c3aed;
+  background: #f5f3ff;
+}
+blockquote.callout-warning {
+  border-right-color: #d97706;
+  background: #fffbeb;
+}
+blockquote.callout-caution {
+  border-right-color: #dc2626;
+  background: #fef2f2;
+}
+
+/* Pygments Syntax Highlighting */
+.math { direction: ltr; unicode-bidi: isolate; color: inherit; }
+.math.block { overflow-x: auto; padding: 1rem .5rem; margin: 1rem 0;
+  text-align: center; break-inside: avoid; }
+.math math { font-family: "Cambria Math", "STIX Two Math", math;
+  font-size: 1.15em; color: inherit; direction: ltr; }
+.math math[display="block"] { margin: 0 auto; width: max-content; }
+.math menclose[notation="box"] { border: 1px solid currentColor; padding: .15em .3em; }
+.math-error { white-space: pre-wrap; overflow-wrap: anywhere; }
+
+pre code .k, pre code .kd, pre code .kn, pre code .kr { color: #007020; font-weight: bold; } /* Keywords */
+pre code .kt { color: #902000; font-weight: bold; } /* Type */
+pre code .s, pre code .s1, pre code .s2, pre code .sb, pre code .sc, pre code .sd { color: #ba2121; } /* Strings */
+pre code .c, pre code .c1, pre code .cm, pre code .cs, pre code .ch { color: #60a0b0; font-style: italic; } /* Comments */
+pre code .m, pre code .mi, pre code .mf, pre code .mh, pre code .mo { color: #208050; } /* Numbers */
+pre code .nf, pre code .fm { color: #06287e; font-weight: bold; } /* Functions */
+pre code .nc, pre code .nn { color: #0e84b5; font-weight: bold; } /* Classes / Namespaces */
+pre code .o, pre code .ow { color: #555555; } /* Operators */
+pre code .nb, pre code .bp { color: #007020; } /* Builtins */
+pre code .na, pre code .nv, pre code .vi, pre code .vg { color: #19177c; } /* Attributes / Variables */
+
+@media screen {
+  .md-table-scroll { max-width: 100%; overflow-x: auto; }
+}
+.task-list-item { list-style-type: none; }
+.task-list-item-checkbox { margin-inline: 0 .4em; }
+.footnotes { margin-block-start: 2em; font-size: .92em; }
+
+@media print {
+  .math.block { overflow: visible; }
+  .md-table-scroll { overflow: visible; }
+  .md-table-scroll table { width: 100%; table-layout: fixed; }
+  .md-table-scroll :is(th, td) { overflow-wrap: anywhere; }
+  .md-table-scroll pre { white-space: pre-wrap; overflow-wrap: anywhere; }
+  thead { display: table-header-group; }
+}

fa_md_pdf/assets/mdpersia.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256" fill="none">
+  <path d="M48 16h112l48 48v168a8 8 0 0 1-8 8H48a8 8 0 0 1-8-8V24a8 8 0 0 1 8-8Z" fill="#fff" stroke="#111" stroke-width="12" stroke-linejoin="round"/>
+  <path d="M156 18v52h50" stroke="#111" stroke-width="10" stroke-linejoin="round"/>
+  <path d="M66 150v-48l24 30 24-30v48M136 102h15c32 0 32 48 0 48h-15v-48Z" stroke="#111" stroke-width="12" stroke-linecap="square" stroke-linejoin="round"/>
+  <rect x="60" y="174" width="128" height="44" rx="8" fill="#111"/>
+  <path d="M161 196H88m15-11-15 11 15 11" stroke="#fff" stroke-width="8" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>

fa_md_pdf/associations.py

@@ -0,0 +1,249 @@
+"""Per-user Windows file association for the Markdown viewer.
+
+HKCU only (no elevation), and unregister removes exactly the keys this module
+creates, leaving the user's own default-program choice for `.md` untouched.
+"""
+
+from __future__ import annotations
+
+import sys
+from collections.abc import Callable
+from dataclasses import dataclass
+from pathlib import Path
+
+PROG_ID = "MdPersia.Markdown"
+PROGID_KEY = rf"Software\Classes\{PROG_ID}"
+APP_NAME = "MdPersia Markdown Viewer"
+VERB_LABEL = "باز کردن با MdPersia"
+EXTENSIONS = (".md", ".markdown")
+REGISTERED_APPS_KEY = r"Software\RegisteredApplications"
+VIEWER_FLAG = "--gui"
+
+
+@dataclass(frozen=True)
+class RegEntry:
+    """A single registry value: key path, value name, value data."""
+
+    key: str
+    name: str
+    value: str
+
+    @property
+    def location(self) -> str:
+        return f"HKCU\\{self.key}\\{self.name}" if self.name else f"HKCU\\{self.key}"
+
+
+def open_command(exe: str, extra_args: str | None = None) -> str:
+    """Command line Explorer runs for a double-clicked file.
+
+    Double-clicking must open the viewer, never start a conversion: `mdpersia file.md`
+    without --gui is the CLI converter. The native Tauri exe also takes --gui because
+    `startup_arguments` keeps only arguments that name an existing file, so the flag is
+    inert there and cannot be mistaken for a document.
+    """
+    if extra_args is None:
+        name = Path(exe).name.lower()
+        launcher = "-m mdpersia " if name.startswith("python") else ""
+        extra_args = f"{launcher}{VIEWER_FLAG}"
+    quoted = f'"{exe}"'
+    tail = f" {extra_args}" if extra_args else ""
+    return f'{quoted}{tail} "%1"'
+
+
+def build_entries(exe_path: str | Path, icon_path: str | Path | None = None) -> list[RegEntry]:
+    exe = str(Path(exe_path))
+    # Use the application's Markdown mark even when Python launches the GUI.
+    bundled_icon = Path(__file__).parent / "assets" / "mdpersia.ico"
+    icon = str(Path(icon_path)) if icon_path else str(bundled_icon)
+    icon_value = f'"{icon}",0'
+    command = open_command(exe)
+
+    entries = [
+        RegEntry(PROGID_KEY, "", APP_NAME),
+        RegEntry(PROGID_KEY, "FriendlyTypeName", APP_NAME),
+        RegEntry(rf"{PROGID_KEY}\DefaultIcon", "", icon_value),
+        RegEntry(rf"{PROGID_KEY}\shell\open\command", "", command),
+        RegEntry(rf"{PROGID_KEY}\Application", "AppUserModelID", "MdPersia.Viewer"),
+    ]
+
+    # Listed in "Open with" and in Settings > Default apps, without claiming .md.
+    for ext in EXTENSIONS:
+        entries.append(RegEntry(rf"{PROGID_KEY}\SupportedTypes", ext, ""))
+
+    entries.append(RegEntry(rf"{PROGID_KEY}\OpenWithList", "a", Path(exe).name))
+    entries.append(RegEntry(REGISTERED_APPS_KEY, "MdPersia", rf"{PROGID_KEY}\Capabilities"))
+    entries.append(RegEntry(rf"{PROGID_KEY}\Capabilities", "ApplicationName", APP_NAME))
+    for ext in EXTENSIONS:
+        entries.append(RegEntry(rf"{PROGID_KEY}\Capabilities\FileAssociations", ext, PROG_ID))
+
+    # Right-click verb on every .md file; does not change any default handler.
+    for ext in EXTENSIONS:
+        verb = rf"Software\Classes\SystemFileAssociations\{ext}\shell\MdPersia.view"
+        entries.append(RegEntry(verb, "", VERB_LABEL))
+        entries.append(RegEntry(verb, "Icon", icon_value))
+        entries.append(RegEntry(rf"{verb}\command", "", command))
+
+    return entries
+
+
+def build_uninstall_keys() -> list[str]:
+    """Key trees to delete on unregister, deepest first."""
+    trees = [PROGID_KEY]
+    trees += [rf"Software\Classes\SystemFileAssociations\{ext}\shell\MdPersia.view" for ext in EXTENSIONS]
+    return trees
+
+
+def _reg():
+    import winreg
+
+    return winreg
+
+
+def register(exe_path: str | Path, icon_path: str | Path | None = None) -> list[str]:
+    """Write the per-user association. Returns the locations that were written."""
+    if sys.platform != "win32":
+        raise OSError("File associations are only available on Windows.")
+    winreg = _reg()
+    written: list[str] = []
+    for entry in build_entries(exe_path, icon_path):
+        with winreg.CreateKey(winreg.HKEY_CURRENT_USER, entry.key) as key:
+            winreg.SetValueEx(key, entry.name, 0, winreg.REG_SZ, entry.value)
+        written.append(entry.location)
+    notify_shell()
+    return written
+
+
+def unregister() -> list[str]:
+    """Remove only the keys this module creates. Missing keys are skipped."""
+    if sys.platform != "win32":
+        raise OSError("File associations are only available on Windows.")
+    winreg = _reg()
+    removed: list[str] = []
+    for tree in build_uninstall_keys():
+        try:
+            parent, _, leaf = tree.rpartition("\\")
+            with winreg.OpenKey(winreg.HKEY_CURRENT_USER, parent, 0, winreg.KEY_ALL_ACCESS) as pk:
+                winreg.DeleteKey(pk, leaf)
+            removed.append(f"HKCU\\{tree}")
+        except FileNotFoundError:
+            continue
+    # RegisteredApplications marker sits under a different parent.
+    try:
+        with winreg.OpenKey(winreg.HKEY_CURRENT_USER, REGISTERED_APPS_KEY, 0, winreg.KEY_ALL_ACCESS) as pk:
+            winreg.DeleteValue(pk, "MdPersia")
+        removed.append(f"HKCU\\{REGISTERED_APPS_KEY}\\MdPersia")
+    except FileNotFoundError:
+        pass
+    notify_shell()
+    return removed
+
+
+def read_open_command() -> str | None:
+    """The command Explorer currently runs, or None when nothing is registered."""
+    if sys.platform != "win32":
+        return None
+    winreg = _reg()
+    try:
+        with winreg.OpenKey(winreg.HKEY_CURRENT_USER, rf"{PROGID_KEY}\shell\open\command") as key:
+            return winreg.QueryValue(key, None) or None
+    except OSError:
+        return None
+
+
+def split_command(command: str) -> tuple[str, list[str]]:
+    """Split a registry command line into (executable, args), dropping the quotes."""
+    import shlex
+
+    try:
+        parts = [p.strip('"') for p in shlex.split(command, posix=False)]
+    except ValueError:
+        return "", []
+    return (parts[0], parts[1:]) if parts else ("", [])
+
+
+def _module_resolvable(exe: str, module: str) -> bool | None:
+    """Ask the registered interpreter whether the module still exists. None = could not ask."""
+    import subprocess
+
+    probe = "import importlib.util, sys; sys.exit(0 if importlib.util.find_spec(sys.argv[1]) else 1)"
+    try:
+        done = subprocess.run(
+            [exe, "-c", probe, module], timeout=20, capture_output=True, check=False
+        )
+    except (OSError, subprocess.SubprocessError):
+        return None
+    return done.returncode == 0
+
+
+def validate_open_command(
+    command: str | None,
+    *,
+    module_resolver=_module_resolvable,
+    exe_exists: Callable[[str], bool] = lambda p: Path(p).is_file(),
+) -> tuple[bool, str]:
+    """A stale entry outlives its target, so key presence alone is not 'working'."""
+    if not command:
+        return False, "not registered"
+    exe, args = split_command(command)
+    if not exe:
+        return False, "command is unreadable"
+    if not exe_exists(exe):
+        return False, f"executable is missing: {exe}"
+    if len(args) >= 2 and args[0] == "-m":
+        if module_resolver(exe, args[1]) is False:
+            return False, f"module '{args[1]}' is not importable by {exe}"
+        if VIEWER_FLAG not in args:
+            return False, f"command lacks {VIEWER_FLAG}, so a double-click runs the converter"
+    return True, exe
+
+
+def association_state() -> tuple[bool, str, str]:
+    """(working, command, explanation) for the current per-user registration."""
+    command = read_open_command()
+    ok, reason = validate_open_command(command)
+    return ok, command or "", reason
+
+
+def is_registered() -> bool:
+    if sys.platform != "win32":
+        return False
+    winreg = _reg()
+    try:
+        with winreg.OpenKey(winreg.HKEY_CURRENT_USER, rf"{PROGID_KEY}\shell\open\command"):
+            return True
+    except OSError:
+        return False
+
+
+def notify_shell() -> None:
+    """Tell Explorer the association database changed (best effort)."""
+    if sys.platform != "win32":
+        return
+    try:
+        import ctypes
+
+        SHCNE_ASSOCCHANGED = 0x08000000
+        SHCNF_IDLIST = 0x0000
+        ctypes.windll.shell32.SHChangeNotify(SHCNE_ASSOCCHANGED, SHCNF_IDLIST, None, None)
+    except Exception:
+        pass
+
+
+def resolve_viewer_exe(project_root: Path, override: str | Path | None = None) -> Path:
+    """Prefer an explicit path, then the built Tauri exe, then the module launcher."""
+    if override:
+        return Path(override)
+    release = (
+        project_root / "desktop-tauri" / "src-tauri" / "target" / "release" / "MdPersia.exe"
+    )
+    if release.is_file():
+        return release
+    return _windowless_launcher(Path(sys.executable))
+
+
+def _windowless_launcher(exe: Path) -> Path:
+    """A double-click must not leave a console window open behind the viewer."""
+    if sys.platform != "win32" or exe.stem.lower() != "python":
+        return exe
+    windowless = exe.with_name("pythonw.exe")
+    return windowless if windowless.is_file() else exe