inkmd 0.1.0__py3-none-any.whl

inkmd/__init__.py

@@ -0,0 +1,59 @@
+"""inkmd — pure-Python markdown to PDF compiler.
+
+Public API:
+
+    inkmd.compile(md_text: str, page_size: str = "letter", family: str = "helvetica") -> bytes
+        Parse markdown into PDF bytes.
+
+    inkmd.render_file(in_path, out_path, page_size: str = "letter", family: str = "helvetica") -> None
+        Read a markdown file, write a PDF file.
+
+Font family choices: 'helvetica' (default, sans-serif) or 'times' (serif).
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from inkmd.parser import parse
+from inkmd.pdf import styled_pdf
+from inkmd.render import FAMILIES, render_document
+
+
+__version__ = "0.1.0"
+
+
+def compile(
+    md_text: str,
+    page_size: str = "letter",
+    family: str = "helvetica",
+    *,
+    autolinks: bool = True,
+) -> bytes:
+    """Compile markdown text into PDF bytes.
+
+    ``autolinks`` controls GFM-style detection of bare URLs and email
+    addresses (default True). Set False for strict CommonMark — bare
+    URLs render as plain text and only `<url>` / `[text](url)` produce
+    links.
+    """
+    if family not in FAMILIES:
+        raise ValueError(f"unknown family {family!r}; available: {tuple(FAMILIES)}")
+    doc = parse(md_text, autolinks=autolinks)
+    paragraphs = render_document(doc, family=FAMILIES[family])
+    return styled_pdf(paragraphs, page_size=page_size)
+
+
+def render_file(
+    in_path: str | Path,
+    out_path: str | Path,
+    page_size: str = "letter",
+    family: str = "helvetica",
+    *,
+    autolinks: bool = True,
+) -> None:
+    """Read markdown from ``in_path``; write PDF to ``out_path``."""
+    md = Path(in_path).read_text(encoding="utf-8")
+    Path(out_path).write_bytes(
+        compile(md, page_size=page_size, family=family, autolinks=autolinks)
+    )

inkmd/__main__.py

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