pytex-preprocessor 0.4.6__tar.gz → 1.0.0__tar.gz

{pytex_preprocessor-0.4.6 → pytex_preprocessor-1.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pytex-preprocessor
-Version: 0.4.6
+Version: 1.0.0
 Summary: Type-safe LaTeX document generation with Python
 Author-email: Frederik Beimgraben <frederik@beimgraben.net>
 License:                     GNU GENERAL PUBLIC LICENSE
@@ -821,13 +821,40 @@ Plain Python works too: $3^2 = \iffalse{pytex(3 ** 2)}\fi$.
 | `--no-shell-escape` | shell-escape on | disable shell-escape |
 | `-t`, `--tree` | off | also print the input's `TeX`-node tree (`tree`-style) before rendering/building |
 | `-f`, `--force` | off | skip the optimize + analysis pass and build even if problems are found |
-| `--variant STYLE` | auto-detect | Markdown output style (`plain`, `report`, `protocol-asta`, `protocol-stupa`) |
+| `--variant STYLE` | auto-detect | Markdown output style (`plain`, `report`, `report-makers`, `protocol-asta`, `protocol-stupa`) |
 | `--config JSON` | none | JSON object of document-class params, merged over the frontmatter |
+| `--untrusted` | off (trusted) | render foreign input through the trust policy (see [Security](#security-and-trust)) |
+| `--trust-level LEVEL` | `trusted` | `trusted`, `sandboxed`, or `untrusted` (see [Security](#security-and-trust)) |
 
 Shell-escape is on by default because inline images decode their base64
 payloads at compile time. The build runs tectonic, then `makeindex` (for
 `glossaries`/acronyms), then reruns tectonic when an index changed.
 
+### Security and trust
+
+By default the CLI runs in a **trusted** context: it imports and executes `.py`
+inputs, evaluates `.tex` `pytex(...)` replacements and Markdown `eval`
+comments, and enables shell-escape. That is code execution by design — it is
+how PyTeX documents work — and is safe **only for documents you wrote
+yourself**. Do not run the default CLI on a file from a source you do not
+trust.
+
+To render input from a foreign or untrusted source, pass `--untrusted` (or
+`--trust-level {sandboxed,untrusted}`). These route the build through the
+`pytex_api` trust policy, which:
+
+- refuses `.py` / `.tex.py` inputs (no Python execution),
+- leaves `.tex` `pytex(...)` markers and Markdown `eval` comments inert,
+- forces shell-escape **off** and rejects code-/file-surface packages
+  (`minted`, `shellesc`, `pythontex`, …) and anything off the package
+  allowlist,
+- applies CPU/memory/output resource limits, and
+- for `sandboxed`, additionally requires the Podman OS sandbox for PDF builds.
+
+`--untrusted` is shorthand for `--trust-level untrusted`. The two flags are
+mutually exclusive; `trusted` is the default, so existing invocations are
+unchanged.
+
 Output is minimal and color-tagged (`==>`, `note:`, `warning:`, `error:`),
 following tectonic's style; on failure it points at the likely cause and the
 log file. Set `NO_COLOR` to disable color.
@@ -877,10 +904,11 @@ Document (article)
 | `pytex` | core node model, `Document`, math, tables, graphics, and factories for the common LaTeX packages (biblatex, cleveref, glossaries, hyperref, listings, ...). |
 | `pytex_koma` | KOMA-Script classes and commands (`Addchap`, `Minisec`, `KOMAoptions`, ...). |
 | `pytex_tikz` | TikZ pictures and primitives (`TikzPicture`, `Draw`, `Node`, `Circle`, ...). |
-| `pytex_markdown` | Markdown -> native `TeX` conversion (see below). |
+| `pytex_components` | reusable, template-agnostic widgets: colored callout boxes (`ColoredBox` + presets), a voting tally, draft watermark, word-count and smart-pagebreak macros, a clickable author-year citation, German cleveref labels. |
+| `pytex_markdown` | Markdown -> native `TeX` conversion (see below), including `pytex_markdown.protocol` (STUPA/AStA meeting minutes) and `pytex_markdown.frontmatter` (YAML frontmatter parsing). |
 | `pytex_analyze` | static checks over the node tree (dangling refs, duplicate labels, missing images), plus `Optimize` to simplify a tree render-equivalently. |
-| `pytex_hsrtreport` | HSRT report document class, colored callout boxes, title pages, glossary/citation helpers. |
-| `pytex_protocol` | STUPA/AStA meeting minutes from Markdown, built on `pytex_hsrtreport`. |
+| `pytex_hsrtreport` | HSRT report document class, title pages, logos, and HSRT colors/fonts/glossary helpers. Builds on `pytex_components` (and re-exports it for compatibility). |
+| `pytex_protocol` | deprecated alias for `pytex_markdown.protocol` (kept as a re-export shim). |
 
 ## Markdown
 
@@ -893,15 +921,23 @@ body = Markdown("# Title\n\nText with **bold**, `code`, [a link](https://x).")
 body = IncludeMarkdown("notes.md", base_level=-1)   # base_level=-1: # -> \chapter
 ```
 
-Headings, emphasis, inline/fenced code, lists, links, images, block quotes and
-thematic breaks map to the standard pytex library; text is LaTeX-escaped.
-GitHub-style callouts become HSRT colored boxes (so the module depends on
-`pytex_hsrtreport`):
-
-```md
-> [!NOTE]      -> InfoBox        > [!IMPORTANT] -> ImportantBox
-> [!TIP]       -> SuccessBox     > [!WARNING]   -> WarningBox
-```
+Headings, emphasis, inline/fenced code, lists, links, images, GFM tables, block
+quotes and thematic breaks map to the standard pytex library; text is
+LaTeX-escaped. Some extras on top of plain Markdown:
+
+- **GitHub-style callouts** become colored boxes (from `pytex_components`):
+  ```md
+  > [!NOTE]      -> InfoBox        > [!IMPORTANT] -> ImportantBox
+  > [!TIP]       -> SuccessBox     > [!WARNING]   -> WarningBox
+  ```
+- **Citations** in Pandoc syntax: `[@key]` / `[@key, p. 5]` -> `\autocite`,
+  `[@a; @b]` -> a combined cite, and a narrative `@key` -> `\textcite`.
+- **Bibliography** from frontmatter — `bibliography:` is either inline BibTeX (a
+  `|` block scalar) or a path to a `.bib` file; reports print a numbered
+  `\printbibliography`.
+- ASCII **math arrows** (`->`, `=>`, `<->`, ...) become inline math arrows, the
+  **euro sign** `€` becomes a font-independent `\euro{}`, and tables get a bit of
+  vertical breathing room.
 
 Both factories are registered, so they work in `\iffalse{pytex(...)}\fi`
 replacements in `.tex` sources too.
@@ -915,6 +951,7 @@ document chosen by `--variant`:
 | --- | --- |
 | `plain` | a bare `Document` (default class `article`); `#` -> `\section`. |
 | `report` | an HSRT report with title page and table of contents; `#` -> `\chapter`. |
+| `report-makers` | a `report` branded with the MAKERS logo (title page + footer). |
 | `protocol-asta` | an AStA meeting protocol (HSRT report, AStA logos). |
 | `protocol-stupa` | a StuPa meeting protocol (HSRT report, StuPa logos). |
 
@@ -933,6 +970,13 @@ object. For styles with a title page (`report`), the title is taken from
 `title:`/`--config` if given, otherwise from the first `#` heading (which is then
 not also rendered as a chapter).
 
+The report styles read further frontmatter keys: `author`, `abstract`,
+`keywords`, title-page `datalines` (a list of `"Label: value"` entries),
+`bibliography` (see [Markdown](#markdown)), `logos` (title-page logos — vendored
+names like `INF`/`MAKERS` and/or paths to custom image files), and the labels
+`abstract_heading` / `keywords_heading` to rename the default "Abstract" /
+"Keywords" sections.
+
 ## Converting LaTeX to PyTeX
 
 `pytex-tex2py` turns an existing `.tex` file into an equivalent `.tex.py`
@@ -961,6 +1005,27 @@ pytex examples/replacements.py.tex --build
 pytex examples/notes.md --build
 ```
 
+## Stability
+
+From 1.0 the project follows [Semantic Versioning](https://semver.org). The
+public API is what each package exports through its top-level `__all__`:
+everything reachable as `from pytex import X` (and the same for `pytex_koma`,
+`pytex_tikz`, `pytex_components`, `pytex_markdown`, `pytex_analyze`,
+`pytex_hsrtreport`). Breaking those names needs a major version bump.
+
+Also part of the contract: the registry keys exposed to `\iffalse{pytex(...)}\fi`
+markers — they are the factory names, so renaming a registered factory is a
+breaking change (which is why the `\fill` length is `Fill_len`, leaving the bare
+`Fill` key to the TikZ path command).
+
+Internal and not covered by the guarantee: any name with a leading underscore,
+modules whose name starts with an underscore (e.g. `pytex_api._policy`,
+`pytex_api._compile`), and anything not listed in a package's `__all__`. Import
+those at your own risk.
+
+Deprecated shims (`pytex_protocol`, the `pytex.commands.lengths.Fill` alias) keep
+working with a `DeprecationWarning` and may be removed in the next major release.
+
 ## License
 
 GNU General Public License v3.0 or later (GPL-3.0-or-later). See

{pytex_preprocessor-0.4.6 → pytex_preprocessor-1.0.0}/README.md

@@ -129,13 +129,40 @@ Plain Python works too: $3^2 = \iffalse{pytex(3 ** 2)}\fi$.
 | `--no-shell-escape` | shell-escape on | disable shell-escape |
 | `-t`, `--tree` | off | also print the input's `TeX`-node tree (`tree`-style) before rendering/building |
 | `-f`, `--force` | off | skip the optimize + analysis pass and build even if problems are found |
-| `--variant STYLE` | auto-detect | Markdown output style (`plain`, `report`, `protocol-asta`, `protocol-stupa`) |
+| `--variant STYLE` | auto-detect | Markdown output style (`plain`, `report`, `report-makers`, `protocol-asta`, `protocol-stupa`) |
 | `--config JSON` | none | JSON object of document-class params, merged over the frontmatter |
+| `--untrusted` | off (trusted) | render foreign input through the trust policy (see [Security](#security-and-trust)) |
+| `--trust-level LEVEL` | `trusted` | `trusted`, `sandboxed`, or `untrusted` (see [Security](#security-and-trust)) |
 
 Shell-escape is on by default because inline images decode their base64
 payloads at compile time. The build runs tectonic, then `makeindex` (for
 `glossaries`/acronyms), then reruns tectonic when an index changed.
 
+### Security and trust
+
+By default the CLI runs in a **trusted** context: it imports and executes `.py`
+inputs, evaluates `.tex` `pytex(...)` replacements and Markdown `eval`
+comments, and enables shell-escape. That is code execution by design — it is
+how PyTeX documents work — and is safe **only for documents you wrote
+yourself**. Do not run the default CLI on a file from a source you do not
+trust.
+
+To render input from a foreign or untrusted source, pass `--untrusted` (or
+`--trust-level {sandboxed,untrusted}`). These route the build through the
+`pytex_api` trust policy, which:
+
+- refuses `.py` / `.tex.py` inputs (no Python execution),
+- leaves `.tex` `pytex(...)` markers and Markdown `eval` comments inert,
+- forces shell-escape **off** and rejects code-/file-surface packages
+  (`minted`, `shellesc`, `pythontex`, …) and anything off the package
+  allowlist,
+- applies CPU/memory/output resource limits, and
+- for `sandboxed`, additionally requires the Podman OS sandbox for PDF builds.
+
+`--untrusted` is shorthand for `--trust-level untrusted`. The two flags are
+mutually exclusive; `trusted` is the default, so existing invocations are
+unchanged.
+
 Output is minimal and color-tagged (`==>`, `note:`, `warning:`, `error:`),
 following tectonic's style; on failure it points at the likely cause and the
 log file. Set `NO_COLOR` to disable color.
@@ -185,10 +212,11 @@ Document (article)
 | `pytex` | core node model, `Document`, math, tables, graphics, and factories for the common LaTeX packages (biblatex, cleveref, glossaries, hyperref, listings, ...). |
 | `pytex_koma` | KOMA-Script classes and commands (`Addchap`, `Minisec`, `KOMAoptions`, ...). |
 | `pytex_tikz` | TikZ pictures and primitives (`TikzPicture`, `Draw`, `Node`, `Circle`, ...). |
-| `pytex_markdown` | Markdown -> native `TeX` conversion (see below). |
+| `pytex_components` | reusable, template-agnostic widgets: colored callout boxes (`ColoredBox` + presets), a voting tally, draft watermark, word-count and smart-pagebreak macros, a clickable author-year citation, German cleveref labels. |
+| `pytex_markdown` | Markdown -> native `TeX` conversion (see below), including `pytex_markdown.protocol` (STUPA/AStA meeting minutes) and `pytex_markdown.frontmatter` (YAML frontmatter parsing). |
 | `pytex_analyze` | static checks over the node tree (dangling refs, duplicate labels, missing images), plus `Optimize` to simplify a tree render-equivalently. |
-| `pytex_hsrtreport` | HSRT report document class, colored callout boxes, title pages, glossary/citation helpers. |
-| `pytex_protocol` | STUPA/AStA meeting minutes from Markdown, built on `pytex_hsrtreport`. |
+| `pytex_hsrtreport` | HSRT report document class, title pages, logos, and HSRT colors/fonts/glossary helpers. Builds on `pytex_components` (and re-exports it for compatibility). |
+| `pytex_protocol` | deprecated alias for `pytex_markdown.protocol` (kept as a re-export shim). |
 
 ## Markdown
 
@@ -201,15 +229,23 @@ body = Markdown("# Title\n\nText with **bold**, `code`, [a link](https://x).")
 body = IncludeMarkdown("notes.md", base_level=-1)   # base_level=-1: # -> \chapter
 ```
 
-Headings, emphasis, inline/fenced code, lists, links, images, block quotes and
-thematic breaks map to the standard pytex library; text is LaTeX-escaped.
-GitHub-style callouts become HSRT colored boxes (so the module depends on
-`pytex_hsrtreport`):
-
-```md
-> [!NOTE]      -> InfoBox        > [!IMPORTANT] -> ImportantBox
-> [!TIP]       -> SuccessBox     > [!WARNING]   -> WarningBox
-```
+Headings, emphasis, inline/fenced code, lists, links, images, GFM tables, block
+quotes and thematic breaks map to the standard pytex library; text is
+LaTeX-escaped. Some extras on top of plain Markdown:
+
+- **GitHub-style callouts** become colored boxes (from `pytex_components`):
+  ```md
+  > [!NOTE]      -> InfoBox        > [!IMPORTANT] -> ImportantBox
+  > [!TIP]       -> SuccessBox     > [!WARNING]   -> WarningBox
+  ```
+- **Citations** in Pandoc syntax: `[@key]` / `[@key, p. 5]` -> `\autocite`,
+  `[@a; @b]` -> a combined cite, and a narrative `@key` -> `\textcite`.
+- **Bibliography** from frontmatter — `bibliography:` is either inline BibTeX (a
+  `|` block scalar) or a path to a `.bib` file; reports print a numbered
+  `\printbibliography`.
+- ASCII **math arrows** (`->`, `=>`, `<->`, ...) become inline math arrows, the
+  **euro sign** `€` becomes a font-independent `\euro{}`, and tables get a bit of
+  vertical breathing room.
 
 Both factories are registered, so they work in `\iffalse{pytex(...)}\fi`
 replacements in `.tex` sources too.
@@ -223,6 +259,7 @@ document chosen by `--variant`:
 | --- | --- |
 | `plain` | a bare `Document` (default class `article`); `#` -> `\section`. |
 | `report` | an HSRT report with title page and table of contents; `#` -> `\chapter`. |
+| `report-makers` | a `report` branded with the MAKERS logo (title page + footer). |
 | `protocol-asta` | an AStA meeting protocol (HSRT report, AStA logos). |
 | `protocol-stupa` | a StuPa meeting protocol (HSRT report, StuPa logos). |
 
@@ -241,6 +278,13 @@ object. For styles with a title page (`report`), the title is taken from
 `title:`/`--config` if given, otherwise from the first `#` heading (which is then
 not also rendered as a chapter).
 
+The report styles read further frontmatter keys: `author`, `abstract`,
+`keywords`, title-page `datalines` (a list of `"Label: value"` entries),
+`bibliography` (see [Markdown](#markdown)), `logos` (title-page logos — vendored
+names like `INF`/`MAKERS` and/or paths to custom image files), and the labels
+`abstract_heading` / `keywords_heading` to rename the default "Abstract" /
+"Keywords" sections.
+
 ## Converting LaTeX to PyTeX
 
 `pytex-tex2py` turns an existing `.tex` file into an equivalent `.tex.py`
@@ -269,6 +313,27 @@ pytex examples/replacements.py.tex --build
 pytex examples/notes.md --build
 ```
 
+## Stability
+
+From 1.0 the project follows [Semantic Versioning](https://semver.org). The
+public API is what each package exports through its top-level `__all__`:
+everything reachable as `from pytex import X` (and the same for `pytex_koma`,
+`pytex_tikz`, `pytex_components`, `pytex_markdown`, `pytex_analyze`,
+`pytex_hsrtreport`). Breaking those names needs a major version bump.
+
+Also part of the contract: the registry keys exposed to `\iffalse{pytex(...)}\fi`
+markers — they are the factory names, so renaming a registered factory is a
+breaking change (which is why the `\fill` length is `Fill_len`, leaving the bare
+`Fill` key to the TikZ path command).
+
+Internal and not covered by the guarantee: any name with a leading underscore,
+modules whose name starts with an underscore (e.g. `pytex_api._policy`,
+`pytex_api._compile`), and anything not listed in a package's `__all__`. Import
+those at your own risk.
+
+Deprecated shims (`pytex_protocol`, the `pytex.commands.lengths.Fill` alias) keep
+working with a `DeprecationWarning` and may be removed in the next major release.
+
 ## License
 
 GNU General Public License v3.0 or later (GPL-3.0-or-later). See

{pytex_preprocessor-0.4.6 → pytex_preprocessor-1.0.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pytex-preprocessor"
-version = "0.4.6"
+version = "1.0.0"
 authors = [
   { name="Frederik Beimgraben", email="frederik@beimgraben.net" },
 ]
@@ -23,6 +23,7 @@ dev = ["pytest", "ruff", "basedpyright"]
 [project.scripts]
 pytex = "pytex_builder.build:main"
 pytex-tex2py = "pytex_builder.tex2py:main"
+pytex-sandbox-init = "pytex_api.sandbox_init:main"
 
 [tool.setuptools.packages.find]
 where = ["src"]
@@ -43,7 +44,10 @@ target-version = "py313"
 src = ["src", "tests"]
 # Uses Python 3.14 t-string syntax; the py313 target cannot parse it. Excluded
 # from lint/format (it is exercised by pytest on 3.14).
-extend-exclude = ["tests/pytex/test_template.py"]
+# `examples/` is illustrative-only and not part of the CI lint scope (`ruff
+# {check,format} src tests`); excluding it keeps a bare `ruff check` matching CI
+# instead of choking on example-only files (some also use 3.14 t-strings).
+extend-exclude = ["tests/pytex/test_template.py", "examples"]
 
 [tool.ruff.lint]
 select = [
@@ -85,4 +89,4 @@ ignore = ["N802"]
 "src/pytex_builder/tectonic.py" = ["E501"]
 
 [tool.ruff.lint.isort]
-known-first-party = ["pytex", "pytex_builder", "pytex_koma", "pytex_tikz", "pytex_hsrtreport", "pytex_markdown"]
+known-first-party = ["pytex_components", "pytex", "pytex_builder", "pytex_koma", "pytex_tikz", "pytex_hsrtreport", "pytex_markdown"]

{pytex_preprocessor-0.4.6 → pytex_preprocessor-1.0.0}/src/pytex/commands/builtin.py

@@ -543,7 +543,7 @@ def Verb(body: str, delim: str = "|") -> TeX:
 
 
 # Size switches moved to pytex/commands/font.py (zero-arg ControlSequence wrappers).
-# Compose with `Concat(Large(), " body")` for inline use.
+# Compose with `Concat(large(), " body")` for inline use.
 
 
 @Registry.add

{pytex_preprocessor-0.4.6 → pytex_preprocessor-1.0.0}/src/pytex/commands/font.py

@@ -3,28 +3,28 @@ from ..model.control_sequence import ControlSequence, Parameter
 from ..registry import Registry
 
 __all__ = [
+    "LARGE",
     "Bfseries",
     "Fontsize",
-    "Footnotesize",
     "Huge",
-    "HugeBig",
     "Itshape",
     "Large",
-    "LargeBig",
-    "LargeMid",
     "Mdseries",
     "Normalfont",
-    "Normalsize",
     "Rmfamily",
-    "Scriptsize",
     "Scshape",
     "Selectfont",
     "Sffamily",
     "Slshape",
-    "Small",
-    "Tiny",
     "Ttfamily",
     "Upshape",
+    "footnotesize",
+    "huge",
+    "large",
+    "normalsize",
+    "scriptsize",
+    "small",
+    "tiny",
 ]
 
 
@@ -88,51 +88,55 @@ def Normalfont() -> TeX:
     return ControlSequence("normalfont", ())
 
 
+# Size switches use the LaTeX command spelling verbatim as the factory name:
+# `\large`/`\Large`/`\LARGE` and `\huge`/`\Huge` differ only by case, which
+# PascalCase cannot encode without a collision. Python identifiers are
+# case-sensitive, so `large`/`Large`/`LARGE` map one-to-one and predictably.
 @Registry.add
-def Tiny() -> TeX:
+def tiny() -> TeX:
     return ControlSequence("tiny", ())
 
 
 @Registry.add
-def Scriptsize() -> TeX:
+def scriptsize() -> TeX:
     return ControlSequence("scriptsize", ())
 
 
 @Registry.add
-def Footnotesize() -> TeX:
+def footnotesize() -> TeX:
     return ControlSequence("footnotesize", ())
 
 
 @Registry.add
-def Small() -> TeX:
+def small() -> TeX:
     return ControlSequence("small", ())
 
 
 @Registry.add
-def Normalsize() -> TeX:
+def normalsize() -> TeX:
     return ControlSequence("normalsize", ())
 
 
 @Registry.add
-def Large() -> TeX:
+def large() -> TeX:
     return ControlSequence("large", ())
 
 
 @Registry.add
-def LargeMid() -> TeX:
+def Large() -> TeX:
     return ControlSequence("Large", ())
 
 
 @Registry.add
-def LargeBig() -> TeX:
+def LARGE() -> TeX:
     return ControlSequence("LARGE", ())
 
 
 @Registry.add
-def Huge() -> TeX:
+def huge() -> TeX:
     return ControlSequence("huge", ())
 
 
 @Registry.add
-def HugeBig() -> TeX:
+def Huge() -> TeX:
     return ControlSequence("Huge", ())

{pytex_preprocessor-0.4.6 → pytex_preprocessor-1.0.0}/src/pytex/commands/lengths.py

@@ -1,3 +1,5 @@
+import warnings
+
 from ..interface.tex import TeX
 from ..model.control_sequence import ControlSequence, Parameter
 from ..model.length import Length
@@ -11,7 +13,7 @@ __all__ = [
     "Baselinestretch",
     "Columnsep",
     "Columnwidth",
-    "Fill",
+    "Fill_len",
     "Footskip",
     "Headheight",
     "Headsep",
@@ -196,5 +198,21 @@ def Arraystretch_len() -> Length:
 
 
 @Registry.add
-def Fill() -> Length:
+def Fill_len() -> Length:
     return _const("fill")
+
+
+def __getattr__(name: str) -> object:
+    # `Fill` (the ``\fill`` rubber length) was renamed to `Fill_len` so its
+    # registry key no longer collides with `pytex_tikz.Fill` (the ``\fill`` path
+    # command). The suffix mirrors `Arraystretch_len`, which already dodges the
+    # `Arraystretch` table command the same way. Kept as a deprecated alias.
+    if name == "Fill":
+        warnings.warn(
+            "pytex.commands.lengths.Fill was renamed to Fill_len to free the "
+            + "'Fill' registry key for pytex_tikz.Fill; import Fill_len instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return Fill_len
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")

{pytex_preprocessor-0.4.6 → pytex_preprocessor-1.0.0}/src/pytex/model/control_sequence.py

@@ -36,8 +36,6 @@ class Parameter[T: ParameterType = ParameterType](TeX):
     @property
     @override
     def rendered(self) -> str:
-        """Render this Node to a valid LaTeX-String"""
-
         content: str | TeX = ""
 
         if isinstance(self.value, (TeX, str)):

{pytex_preprocessor-0.4.6 → pytex_preprocessor-1.0.0}/src/pytex/model/image.py

@@ -59,7 +59,10 @@ class IncludeImage(TeX):
         if src.suffix.lower() in PDF_COMPAT:
             return src
         if src.suffix.lower() == ".svg":
-            digest = hashlib.sha1(src.resolve().as_posix().encode()).hexdigest()[:10]
+            # Content-address the cache: hash the SVG bytes, not its path, so an
+            # edited source reconverts instead of reusing a stale PDF that
+            # happens to live at the same path-derived name.
+            digest = hashlib.sha1(src.read_bytes()).hexdigest()[:10]
             return Path("build") / f"{src.stem}-{digest}.pdf"
         raise ValueError(f"unsupported image extension: {src.suffix}")
 

{pytex_preprocessor-0.4.6 → pytex_preprocessor-1.0.0}/src/pytex/model/package.py

@@ -87,8 +87,6 @@ class Package(PackageProtocol, TeX):
     @property
     @override
     def rendered(self) -> str:
-        """Render this object to a valid LaTeX-String"""
-
         return f"\\usepackage{self._options_string}{{{self.name}}}"
 
     @property

{pytex_preprocessor-0.4.6 → pytex_preprocessor-1.0.0}/src/pytex/template.py

@@ -65,13 +65,14 @@ _CONVERSIONS = {"r": repr, "s": str, "a": ascii}
 
 def tex(template: _Template) -> TeX:
     """Render a t-string into a `TeX` tree (see the module docstring)."""
-    parts: list[TeX] = []
-    for item in template:
-        if isinstance(item, str):
-            parts.append(Raw(item))  # literal LaTeX
-        else:
-            parts.append(_coerce(item.value, item.conversion, item.format_spec))
-    return Concat(*parts)
+    return Concat(
+        *(
+            Raw(item)  # literal LaTeX
+            if isinstance(item, str)
+            else _coerce(item.value, item.conversion, item.format_spec)
+            for item in template
+        )
+    )
 
 
 def _coerce(value: object, conversion: str | None = None, spec: object = "") -> TeX: