pytex-preprocessor 0.1.0rc1__tar.gz → 0.1.2__tar.gz

{pytex_preprocessor-0.1.0rc1 → pytex_preprocessor-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pytex-preprocessor
-Version: 0.1.0rc1
+Version: 0.1.2
 Summary: Type-safe LaTeX document generation with Python
 Author-email: Frederik Beimgraben <frederik@beimgraben.net>
 Requires-Python: >=3.13

{pytex_preprocessor-0.1.0rc1 → pytex_preprocessor-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pytex-preprocessor"
-version = "0.1.0rc1"
+version = "0.1.2"
 authors = [
   { name="Frederik Beimgraben", email="frederik@beimgraben.net" },
 ]
@@ -72,6 +72,9 @@ ignore = ["N802"]
 # glossary holds raw LaTeX template constants (column types, style, labels)
 # that exceed the line length and cannot be reflowed.
 "src/pytex_hsrtreport/glossary.py" = ["E501"]
+# tectonic pins a table of 64-char biber SHA256 checksums; the hash literals
+# are unbreakable.
+"src/pytex_builder/tectonic.py" = ["E501"]
 
 [tool.ruff.lint.isort]
 known-first-party = ["pytex", "pytex_builder", "pytex_koma", "pytex_tikz", "pytex_hsrtreport", "pytex_markdown"]

{pytex_preprocessor-0.1.0rc1 → pytex_preprocessor-0.1.2}/src/pytex_builder/build.py

@@ -8,6 +8,7 @@ acronyms resolve.
 from __future__ import annotations
 
 import argparse
+import re
 import sys
 from dataclasses import dataclass
 from pathlib import Path
@@ -42,16 +43,28 @@ def _default_output(inp: Path, build_dir: Path) -> Path:
     ``build_dir`` so the ``.out.tex`` and its inline assets (fonts, logos,
     images) stay out of the source tree:
 
-    * ``example.tex.py`` -> ``<build_dir>/example.out.tex``
-    * ``report.py``      -> ``<build_dir>/report.out.tex``
-    * ``paper.tex``      -> ``<build_dir>/paper.out.tex``
+    The stem is also slugified (whitespace and shell/TeX-hostile characters
+    become ``_``) because it becomes the TeX ``\\jobname``; spaces there break
+    tectonic's biber/makeindex steps (the ``.bcf`` path cannot be opened):
+
+    * ``example.tex.py``        -> ``<build_dir>/example.out.tex``
+    * ``report.py``             -> ``<build_dir>/report.out.tex``
+    * ``2026-06-15 STUPA.md``   -> ``<build_dir>/2026-06-15_STUPA.md.out.tex``
     """
     base = inp
     if base.suffix.lower() in {".py", ".tex"}:
         base = base.with_suffix("")
     if base.suffix.lower() == ".tex":
         base = base.with_suffix("")
-    return build_dir / f"{base.name}.out.tex"
+    return build_dir / f"{_slug(base.name)}.out.tex"
+
+
+def _slug(name: str) -> str:
+    """Make `name` safe as a TeX jobname: collapse whitespace and drop
+    characters that confuse tectonic/biber/makeindex."""
+    name = re.sub(r"\s+", "_", name.strip())
+    name = re.sub(r"[^\w.\-]", "", name)
+    return name or "document"
 
 
 def _parse_args(argv: list[str]) -> Config:

{pytex_preprocessor-0.1.0rc1 → pytex_preprocessor-0.1.2}/src/pytex_builder/render.py

@@ -58,7 +58,15 @@ def _render_markdown(path: Path) -> TeX:
     # Imported lazily so plain .tex/.py builds need neither marko nor hsrt.
     from pytex.model.document import Document
     from pytex_markdown import IncludeMarkdown
+    from pytex_protocol.frontmatter import split_frontmatter
 
+    text = path.read_text()
+    meta, _ = split_frontmatter(text)
+    # A `gremium:` frontmatter key marks a STUPA/AStA meeting protocol.
+    if "gremium" in meta or meta.get("typ") == "protokoll":
+        from pytex_protocol import render_protocol
+
+        return render_protocol(text)
     return Document(IncludeMarkdown(path))
 
 

{pytex_preprocessor-0.1.0rc1 → pytex_preprocessor-0.1.2}/src/pytex_builder/tectonic.py

@@ -7,6 +7,7 @@ its working directory - we point that at the cache dir.
 
 from __future__ import annotations
 
+import hashlib
 import os
 import platform
 import shutil
@@ -43,6 +44,30 @@ BIBER_RELEASE_URL = (
     "biblatex-biber/{version}/binaries/{sf_dir}/{filename}/download"
 )
 
+# Mirror of the upstream biber binaries, hosted as release assets so builds
+# survive SourceForge outages (it periodically gates downloads behind a
+# Cloudflare challenge that curl cannot pass). Tried before SourceForge.
+BIBER_MIRROR_URL = (
+    "https://github.com/frederikbeimgraben/PyTeX-Preprocessor"
+    "/releases/download/biber-binaries/{asset}"
+)
+
+# SHA256 of each upstream biber tarball, keyed by the versioned mirror asset
+# name. Used to verify downloads from either source and to reject HTML error
+# pages a CDN might serve with a 200 status. Linux x86_64 only for now; other
+# platforms download from SourceForge without a pinned checksum.
+BIBER_SHA256: dict[str, str] = {
+    "biber-2.11-linux_x86_64.tar.gz": "7fcb51491fb24151810a92b2e2d03b7a1291823c0f8d6fb53183af391fca42e7",
+    "biber-2.12-linux_x86_64.tar.gz": "fd0b5145cc908c400a701b583330635d533d750b73a272d1d5ea47e10b2fbf71",
+    "biber-2.13-linux_x86_64.tar.gz": "03101f418d46f4666272b68a4318d9e4b7a840d9dfa05d93ddc490d491157a75",
+    "biber-2.14-linux_x86_64.tar.gz": "dab3177f03322b5529d07d47d21d9e573a90c23d86eaaf11591b2d155316ee1b",
+    "biber-2.15-linux_x86_64.tar.gz": "653c8add18d2e94a233a6b9aae6d8144f965c2ce13fb7b4e66502b55fcd06e06",
+    "biber-2.16-linux_x86_64.tar.gz": "3afb97a42d2cf272d3c0b51663725e55339c4e6f3d594cd52e16c39fa9fcfb13",
+    "biber-2.17-linux_x86_64.tar.gz": "129d2e0332a57e985ffa253e5e9fbd28ef99af5a068d1b141145211969aa8999",
+    "biber-2.18-linux_x86_64.tar.gz": "2a6b4cd15a1139907799da0d23cd4ddcce8341af3960d2b3d1d3e4b4a9f1fb53",
+    "biber-2.19-linux_x86_64.tar.gz": "e2eda3e6ea7ac7e78d60e99a0e2aeb1096829f95791c06b768ed31a12889e58e",
+}
+
 
 class BuildError(RuntimeError):
     """Raised when an external tool is missing or exits non-zero."""
@@ -109,33 +134,67 @@ def _biber_cached(version: str) -> Path:
     return CACHE_DIR / "biber" / version / "biber"
 
 
+def _mirror_asset(version: str, filename: str) -> str:
+    """Versioned mirror asset name, e.g. ``biber-2.17-linux_x86_64.tar.gz``."""
+    return filename.replace("biber-", f"biber-{version}-", 1)
+
+
+def _biber_sources(version: str) -> list[tuple[str, str | None]]:
+    """(url, expected_sha256 or None) pairs to try in order: mirror, then SourceForge."""
+    sf_dir, filename = _biber_sf_path()
+    asset = _mirror_asset(version, filename)
+    sha = BIBER_SHA256.get(asset)
+    return [
+        (BIBER_MIRROR_URL.format(asset=asset), sha),
+        (
+            BIBER_RELEASE_URL.format(version=version, sf_dir=sf_dir, filename=filename),
+            sha,
+        ),
+    ]
+
+
+def _download_to(url: str, dest: Path, sha: str | None, console: Console) -> bool:
+    """Fetch *url* into *dest*; return True only on success and matching checksum."""
+    proc = subprocess.run(
+        ["curl", "-fsSL", "-o", str(dest), url],
+        capture_output=True,
+        text=True,
+    )
+    if proc.returncode != 0 or not dest.exists():
+        return False
+    if sha is not None:
+        actual = hashlib.sha256(dest.read_bytes()).hexdigest()
+        if actual != sha:
+            console.warn(f"checksum mismatch from {url}; discarding")
+            dest.unlink(missing_ok=True)
+            return False
+    return True
+
+
 def _ensure_biber(version: str, console: Console) -> Path:
-    """Return a path to biber *version*, downloading from SourceForge if needed."""
+    """Return a path to biber *version*, downloading from the mirror or SourceForge."""
     cached = _biber_cached(version)
     if cached.exists():
         return cached
 
-    sf_dir, filename = _biber_sf_path()
-    url = BIBER_RELEASE_URL.format(version=version, sf_dir=sf_dir, filename=filename)
-    console.step(f"Downloading biber {version}")
-    console.detail(f"source: {url}")
+    if not shutil.which("curl"):
+        raise BuildError(
+            "biber is not installed and cannot be downloaded without 'curl' on PATH"
+        )
 
+    console.step(f"Downloading biber {version}")
     cached.parent.mkdir(parents=True, exist_ok=True)
-    tmp = cached.parent / filename
+    tmp = cached.parent / "biber.download"
     try:
-        if not shutil.which("curl"):
-            raise BuildError(
-                "biber is not installed and cannot be downloaded without 'curl' on PATH"
-            )
-        proc = subprocess.run(
-            ["curl", "-fsSL", "-o", str(tmp), url],
-            capture_output=True,
-            text=True,
-        )
-        if proc.returncode != 0 or not tmp.exists():
+        downloaded = False
+        for url, sha in _biber_sources(version):
+            console.detail(f"source: {url}")
+            if _download_to(url, tmp, sha, console):
+                downloaded = True
+                break
+        if not downloaded:
             raise BuildError(
-                f"failed to download biber {version}:\n"
-                + (proc.stderr.strip() or "no output from curl")
+                f"failed to download biber {version} from the mirror or SourceForge"
             )
         with tarfile.open(tmp) as tf:
             member = next(
@@ -147,10 +206,14 @@ def _ensure_biber(version: str, console: Console) -> Path:
                 None,
             )
             if member is None:
-                raise BuildError(f"biber binary not found inside {filename}")
+                raise BuildError(
+                    f"biber binary not found inside the biber {version} archive"
+                )
             src = tf.extractfile(member)
             if src is None:
-                raise BuildError(f"could not read biber from {filename}")
+                raise BuildError(
+                    f"could not read biber from the biber {version} archive"
+                )
             cached.write_bytes(src.read())
     except Exception:
         if cached.exists():

{pytex_preprocessor-0.1.0rc1 → pytex_preprocessor-0.1.2}/src/pytex_hsrtreport/citations.py

@@ -9,11 +9,13 @@ __all__ = ["Fcite"]
 
 @Registry.add
 def Fcite(key: str) -> TeX:
-    """Full clickable citation: `\\hyperlink{cite.KEY}{Author, Year}`.
+    """Full clickable citation: `\\hyperlink{cite.0@KEY}{Author, Year}`.
 
     Mirrors HSRTReport's `\\fcite` macro — author + year in one clickable link.
+    biblatex names the citation anchor ``cite.0@KEY`` (the ``0@`` is refsection
+    0); targeting ``cite.KEY`` would dangle.
     """
     return Hyperlink(
-        f"cite.{key}",
+        f"cite.0@{key}",
         Concat(Citeauthor(key), ", ", Citeyear(key)),
     )

{pytex_preprocessor-0.1.0rc1 → pytex_preprocessor-0.1.2}/src/pytex_hsrtreport/document.py

@@ -295,6 +295,11 @@ class HSRTReport(KomaDocument):
     def rendered(self) -> str:
         return Concat(
             DocumentClass(self.document_class, self.document_class_options),
+            # hyperfootnotes is only honoured as a hyperref load option, so it
+            # must be queued before \usepackage{hyperref}. The HSRT footnote
+            # setup never places hyperref's Hfootnote destination, so leaving
+            # footnote-mark links enabled produces dangling links.
+            Raw(r"\PassOptionsToPackage{hyperfootnotes=false}{hyperref}"),
             *self.ordered_packages(),
             self.inline_image_block,
             self.preamble,

{pytex_preprocessor-0.1.0rc1 → pytex_preprocessor-0.1.2}/src/pytex_hsrtreport/hyperref_config.py

@@ -19,7 +19,11 @@ HSRT_HYPER_OPTIONS: Final[dict[str, HyperOption]] = {
     "pdfpagemode": "UseOutlines",
     "bookmarksopen": True,
     "bookmarksopenlevel": 0,
-    "hypertexnames": False,
+    # plainpages=false + hypertexnames=true gives roman frontmatter pages their
+    # own named anchors (page.i, ...) so glossary/index \hyperpage links to
+    # those pages resolve instead of dangling against absolute arabic anchors.
+    "plainpages": False,
+    "hypertexnames": True,
     "colorlinks": True,
     "citecolor": HSRT_CITE_COLOR,
     "linkcolor": HSRT_LINK_COLOR,

{pytex_preprocessor-0.1.0rc1 → pytex_preprocessor-0.1.2}/src/pytex_hsrtreport/tex/pagesetup.tex

@@ -1,3 +1,4 @@
+\usepackage{lastpage}
 \makeatletter
 \def\@title{}
 \def\@author{}
@@ -12,14 +13,13 @@
 \def\chaptermark#1{\def\Chaptername{#1}\Chaptermark{#1}}
 \let\Sectionmark\sectionmark
 \def\sectionmark#1{\def\Sectionname{#1}\Sectionmark{#1}}
-\AtEndDocument{\immediate\write\@auxout{\string\gdef\string\@lastpage{\thepage}}}
 \clearpairofpagestyles
 \setkomafont{pageheadfoot}{\color{gray}\blenderfont}
 \setkomafont{pagenumber}{\color{gray}\blenderfont}
 \setlength{\footskip}{20pt}
 \ohead*{\ifHSRTBackMatter\else\ifnum\value{chapter}>0\relax\Roman{\thechapter}~–~\Chaptername\fi\fi}
 \ifoot{\@author}
-\cfoot{\ifHSRTBackMatter\else Seite~\thepage\if@mainmatter\@ifundefined{@lastpage}{}{~von~\@lastpage}\fi\fi}
+\cfoot{\ifHSRTBackMatter\else Seite~\thepage\if@mainmatter~von~\pageref{LastPage}\fi\fi}
 \ohead{\ifHSRTBackMatter\else\ifnum\value{chapter}>0\relax\thechapter~–~\Chaptername\fi\fi}
 \ihead{\@title}
 \pagestyle{scrheadings}

{pytex_preprocessor-0.1.0rc1 → pytex_preprocessor-0.1.2}/src/pytex_hsrtreport/titlepage.py

@@ -1,3 +1,4 @@
+from collections.abc import Iterator
 from dataclasses import dataclass, field
 from typing import Final, override
 
@@ -20,12 +21,22 @@ from pytex.commands.tables import Tabular
 from pytex.helpers.parenting import attach
 from pytex.interface.tex import TeX
 from pytex.model.concat import Concat
+from pytex.model.empty import Empty
 from pytex.model.environment import Environment
 from pytex.model.raw import Raw
 from pytex.registry import Registry
 
 from .logos import titlepage_logo_overlay
 
+
+def _is_blank(node: TeX | str) -> bool:
+    """True for an empty string or the `Empty` node — used to skip empty
+    title-page sections (a protocol has no abstract or keywords)."""
+    if isinstance(node, str):
+        return not node.strip()
+    return node is Empty
+
+
 __all__ = ["TitlePage", "TitlePageDataLine"]
 
 
@@ -75,62 +86,63 @@ class TitlePage(TeX):
         )
         return tuple(v for v in candidates if isinstance(v, TeX))
 
-    @property
-    @override
-    def rendered(self) -> str:
+    def _title_block(self) -> TeX:
+        return Environment(
+            "flushleft",
+            Concat(
+                Raw(r"\hyphenpenalty=10000\exhyphenpenalty=10000"),
+                Noindent(),
+                SelectColor("black"),
+                Textbf(
+                    Concat(
+                        Blenderfont(),
+                        HugeBig(),
+                        Hspace("-2.5pt", star=True),
+                        self.title,
+                    )
+                ),
+                Raw(r"\par"),
+                Vspace("-0.5em"),
+                Rule(r"\textwidth", "0.5mm"),
+            ),
+        )
+
+    def _content(self) -> Iterator[TeX | str]:
         # Tikz overlay: logos chained left-to-right from the top-left corner,
         # matching tmp/Pages/Titlepage.tex but with the foreach unrolled here.
-        logo_overlay = Raw(
-            titlepage_logo_overlay(self.logo_names),
-            allow_replacements=False,
+        yield Raw(titlepage_logo_overlay(self.logo_names), allow_replacements=False)
+        yield Vspace("4cm")
+        yield self._title_block()
+        yield Vspace("2em")
+        yield Setstretch("1.0")
+        # Abstract and keywords are optional — skip the labels when empty
+        # (e.g. a meeting protocol has neither).
+        if not _is_blank(self.abstract):
+            yield SectionStar("Abstract")
+            yield Vspace("-1em")
+            yield self.abstract
+            yield Vspace("1em", star=True)
+        if not _is_blank(self.keywords):
+            yield Raw(r"\par\noindent ")
+            yield Textbf("Keywords")
+            yield Raw(r"\par\noindent ")
+            yield self.keywords
+        yield Vfill()
+        yield Noindent()
+        yield Setstretch("1.0")
+        yield Tabular(
+            r"@{} p{30mm} p{\dimexpr\textwidth-30mm-2\tabcolsep\relax} @{}",
+            _data_table_body(self.data_lines),
         )
-        # Flag true while the titlepage ships out so footer_logo_hook
-        # suppresses the bottom-right footer logos on this page only.
-        # Reset after \end{titlepage} (which \clearpages, shipping the page
-        # while the flag is still true).
+
+    @property
+    @override
+    def rendered(self) -> str:
+        # `\HSRTTitlePagetrue` while the titlepage ships out so footer_logo_hook
+        # suppresses the bottom-right footer logos on this page only; reset
+        # after \end{titlepage} (which \clearpages while the flag is still set).
         return Concat(
             Raw(r"\HSRTTitlePagetrue", allow_replacements=False),
-            TitlepageEnv(
-                Concat(
-                    logo_overlay,
-                    Vspace("4cm"),
-                    Environment(
-                        "flushleft",
-                        Concat(
-                            Raw(r"\hyphenpenalty=10000\exhyphenpenalty=10000"),
-                            Noindent(),
-                            SelectColor("black"),
-                            Textbf(
-                                Concat(
-                                    Blenderfont(),
-                                    HugeBig(),
-                                    Hspace("-2.5pt", star=True),
-                                    self.title,
-                                )
-                            ),
-                            Raw(r"\par"),
-                            Vspace("-0.5em"),
-                            Rule(r"\textwidth", "0.5mm"),
-                        ),
-                    ),
-                    Vspace("2em"),
-                    Setstretch("1.0"),
-                    SectionStar("Abstract"),
-                    Vspace("-1em"),
-                    self.abstract,
-                    Vspace("1em", star=True),
-                    Raw(r"\par\noindent "),
-                    Textbf("Keywords"),
-                    Raw(r"\par\noindent "),
-                    self.keywords,
-                    Vfill(),
-                    Noindent(),
-                    Setstretch("1.0"),
-                    Tabular(
-                        r"@{} p{30mm} p{\dimexpr\textwidth-30mm-2\tabcolsep\relax} @{}",
-                        _data_table_body(self.data_lines),
-                    ),
-                )
-            ),
+            TitlepageEnv(Concat(*self._content())),
             Raw(r"\HSRTTitlePagefalse", allow_replacements=False),
         ).rendered

{pytex_preprocessor-0.1.0rc1 → pytex_preprocessor-0.1.2}/src/pytex_markdown/convert.py

@@ -10,7 +10,7 @@ this module depends on ``pytex_hsrtreport``.
 from __future__ import annotations
 
 import re
-from typing import TYPE_CHECKING, Any, Final, cast, final
+from typing import TYPE_CHECKING, Any, Final, cast
 
 from pytex.commands.builtin import (
     Bold,
@@ -91,9 +91,12 @@ def _text(node: object) -> str | None:
     return ch if isinstance(ch, str) else None
 
 
-@final
 class MarkdownConverter:
-    """Walk a marko AST, producing a single ``TeX`` tree."""
+    """Walk a marko AST, producing a single ``TeX`` tree.
+
+    Subclass to add domain-specific blocks/inlines (see
+    ``pytex_protocol.convert.ProtocolConverter``).
+    """
 
     base_level: int
     callouts: bool

{pytex_preprocessor-0.1.0rc1 → pytex_preprocessor-0.1.2}/src/pytex_preprocessor.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pytex-preprocessor
-Version: 0.1.0rc1
+Version: 0.1.2
 Summary: Type-safe LaTeX document generation with Python
 Author-email: Frederik Beimgraben <frederik@beimgraben.net>
 Requires-Python: >=3.13

{pytex_preprocessor-0.1.0rc1 → pytex_preprocessor-0.1.2}/src/pytex_preprocessor.egg-info/SOURCES.txt

@@ -110,5 +110,13 @@ src/pytex_preprocessor.egg-info/dependency_links.txt
 src/pytex_preprocessor.egg-info/entry_points.txt
 src/pytex_preprocessor.egg-info/requires.txt
 src/pytex_preprocessor.egg-info/top_level.txt
+src/pytex_protocol/__init__.py
+src/pytex_protocol/convert.py
+src/pytex_protocol/document.py
+src/pytex_protocol/entries.py
+src/pytex_protocol/frontmatter.py
+src/pytex_protocol/header.py
+src/pytex_protocol/shortcodes.py
+src/pytex_protocol/signatures.py
 src/pytex_tikz/__init__.py
 src/pytex_tikz/tikz.py

{pytex_preprocessor-0.1.0rc1 → pytex_preprocessor-0.1.2}/src/pytex_preprocessor.egg-info/top_level.txt

@@ -3,4 +3,5 @@ pytex_builder
 pytex_hsrtreport
 pytex_koma
 pytex_markdown
+pytex_protocol
 pytex_tikz

pytex_preprocessor-0.1.2/src/pytex_protocol/__init__.py

@@ -0,0 +1,37 @@
+"""STUPA/AStA meeting-protocol rendering, built on top of ``pytex_hsrtreport``.
+
+Write the minutes in Obsidian-flavoured Markdown - YAML frontmatter for the
+meeting header, ``> [!beschluss]`` / ``> [!abstimmung]`` / ``> [!aufgabe]``
+callouts and inline ``{{shortcodes}}`` for the protocol-specific bits - and
+render it to a PDF that matches the HSRTReport look.
+
+    from pytex_protocol import IncludeProtocol
+    __pytex__ = IncludeProtocol("sitzung.md")
+"""
+
+from .convert import ProtocolConverter
+from .document import IncludeProtocol, Protocol, render_protocol
+from .entries import ActionItem, Deadline, Decision, Timestamp, Vote
+from .frontmatter import split_frontmatter
+from .header import ProtocolHeader, header_from_meta
+from .shortcodes import expand_inline_shortcodes, expand_shortcode
+from .signatures import SignatureLines, signature_block_from_meta
+
+__all__ = [
+    "ActionItem",
+    "Deadline",
+    "Decision",
+    "IncludeProtocol",
+    "Protocol",
+    "ProtocolConverter",
+    "ProtocolHeader",
+    "SignatureLines",
+    "Timestamp",
+    "Vote",
+    "expand_inline_shortcodes",
+    "expand_shortcode",
+    "header_from_meta",
+    "render_protocol",
+    "signature_block_from_meta",
+    "split_frontmatter",
+]