texsmith 0.0.2.dev0__py3-none-any.whl

texsmith/templates/snippet/template/manifest.toml

@@ -0,0 +1,66 @@
+[compat]
+texsmith = ">=0.1,<1.0"
+
+[latex.template]
+name = "snippet"
+version = "0.1.4"
+entrypoint = "template/template.tex"
+engine = "lualatex"
+shell_escape = false
+texlive_year = 2023
+tlmgr_packages = [
+    "babel",
+    "fontspec",
+    "hyphenat",
+    "microtype",
+    "tcolorbox",
+    "fontawesome5",
+    "csquotes",
+    "hyperref",
+    "tikz",
+    "glossaries",
+    "biblatex",
+]
+fragments = [
+    "ts-fonts",
+    "ts-extra",
+    "ts-keystrokes",
+    "ts-callouts",
+    "ts-code",
+    "ts-glossary",
+    "ts-bibliography",
+    "ts-todolist",
+]
+
+[latex.template.attributes.language]
+default = "english"
+type = "string"
+allow_empty = false
+sources = ["language"]
+
+[latex.template.attributes.width]
+default = "12cm"
+type = "string"
+allow_empty = false
+sources = ["width"]
+
+[latex.template.attributes.margin]
+default = "6mm"
+type = "string"
+allow_empty = false
+sources = ["margin"]
+
+[latex.template.attributes.dogear]
+default = "5mm"
+type = "string"
+allow_empty = false
+sources = ["dogear"]
+
+[latex.template.attributes.border]
+default = true
+type = "boolean"
+sources = ["border"]
+
+[latex.template.slots.mainmatter]
+default = true
+depth = "section"

texsmith/templates/snippet/template/template.tex

@@ -0,0 +1,47 @@
+\documentclass{standalone}
+\usepackage{fontspec}
+\usepackage{xcolor}
+\definecolor{texsmithLinkColor}{HTML}{0B3D91}
+\VAR{extra_packages}
+
+\usepackage[colorlinks=true, linkcolor=texsmithLinkColor, urlcolor=texsmithLinkColor, citecolor=texsmithLinkColor]{hyperref}
+\usepackage{tikz}
+\usetikzlibrary{calc}
+
+\begin{document}
+\BLOCK{ if border }
+\begin{tikzpicture}
+  \def\textwidthbox{\VAR{width}}
+  \def\margin{\VAR{margin}}
+  \def\e{\VAR{dogear}}
+
+  \node[inner sep=\margin, outer sep=0pt] (content) {%
+    \begin{minipage}{\textwidthbox}
+\BLOCK{ endif }
+\VAR{mainmatter}
+\VAR{fragment_backmatter}
+\BLOCK{ if border }
+    \end{minipage}
+  };
+
+  \coordinate (A) at (content.north west);
+  \coordinate (B) at (content.north east);
+  \coordinate (C) at (content.south east);
+  \coordinate (D) at (content.south west);
+
+  \coordinate (Bdown) at ($(B)-(0,\e)$);
+  \coordinate (Bleft) at ($(B)-(\e,0)$);
+  \coordinate (Corner) at ($(B)-(\e,\e)$);
+
+  \draw (A) -- (Bleft) -- (Bdown) -- (C) -- (D) -- cycle;
+  \BLOCK{ if dogear }
+  \draw (Corner)
+   .. controls ($(Corner)+(0.3*\e,0.1*\e)$) and ($(Bdown)+(-0.3*\e,-0.1*\e)$) ..
+   (Bdown);
+  \draw (Bleft)
+   .. controls ($(Bleft)+(0.1*\e,-0.3*\e)$) and ($(Corner)+(-0.1*\e,0.3*\e)$) ..
+   (Corner);
+  \BLOCK{ endif }
+\BLOCK{ endif }
+\end{tikzpicture}
+\end{document}

texsmith/texlogos.py

@@ -0,0 +1,15 @@
+"""Public entry points for the TeX logo Markdown and LaTeX extension."""
+
+from __future__ import annotations
+
+from .extensions.texlogos import LogoSpec, iter_specs, register_renderer
+from .extensions.texlogos.markdown import TexLogosExtension, makeExtension
+
+
+__all__ = [
+    "LogoSpec",
+    "TexLogosExtension",
+    "iter_specs",
+    "makeExtension",
+    "register_renderer",
+]

texsmith/ui/__init__.py

@@ -0,0 +1,6 @@
+"""User-facing interfaces for TexSmith."""
+
+from __future__ import annotations
+
+
+__all__ = []

texsmith/ui/cli/__init__.py

@@ -0,0 +1,22 @@
+"""Public CLI exports for TexSmith."""
+
+from __future__ import annotations
+
+from texsmith.adapters.markdown import DEFAULT_MARKDOWN_EXTENSIONS
+
+from .app import app, main
+from .commands import render
+from .state import debug_enabled, emit_error, emit_warning, ensure_rich_compat, get_cli_state
+
+
+__all__ = [
+    "DEFAULT_MARKDOWN_EXTENSIONS",
+    "app",
+    "debug_enabled",
+    "emit_error",
+    "emit_warning",
+    "ensure_rich_compat",
+    "get_cli_state",
+    "main",
+    "render",
+]

texsmith/ui/cli/_options.py

@@ -0,0 +1,338 @@
+"""Shared Typer option definitions for CLI commands."""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Annotated
+
+import typer
+
+
+INPUTS_PANEL = "Input Handling"
+STRUCTURE_PANEL = "Structure"
+RENDERING_PANEL = "Rendering"
+OUTPUT_PANEL = "Output"
+TEMPLATE_PANEL = "Template"
+DIAGNOSTICS_PANEL = "Diagnostics"
+
+InputPathArgument = Annotated[
+    list[Path] | None,
+    typer.Argument(
+        metavar="INPUT...",
+        help=(
+            "Conversion inputs such as Markdown (.md) or HTML (.html) source documents. "
+            "Optionally, BibTeX files (.bib) for citation processing."
+        ),
+        exists=True,
+        file_okay=True,
+        dir_okay=False,
+        readable=True,
+        resolve_path=True,
+        rich_help_panel=INPUTS_PANEL,
+    ),
+]
+
+SelectorOption = Annotated[
+    str,
+    typer.Option(
+        "--selector",
+        help="CSS selector to extract the MkDocs article content.",
+        rich_help_panel=INPUTS_PANEL,
+    ),
+]
+
+FullDocumentOption = Annotated[
+    bool,
+    typer.Option(
+        "--full-document",
+        help="Disable article extraction and render the entire HTML file.",
+        rich_help_panel=INPUTS_PANEL,
+    ),
+]
+
+BaseLevelOption = Annotated[
+    str,
+    typer.Option(
+        "--base-level",
+        help="Base heading level relative to the template (e.g. 1 or 'section').",
+        rich_help_panel=STRUCTURE_PANEL,
+    ),
+]
+
+StripHeadingOption = Annotated[
+    bool,
+    typer.Option(
+        "--strip-heading",
+        help="Drop the first document heading from the rendered content.",
+        rich_help_panel=STRUCTURE_PANEL,
+    ),
+]
+
+NoPromoteTitleOption = Annotated[
+    bool,
+    typer.Option(
+        "--no-promote-title",
+        help="Disable promotion of the first heading to document title.",
+        rich_help_panel=TEMPLATE_PANEL,
+    ),
+]
+
+NoTitleOption = Annotated[
+    bool,
+    typer.Option(
+        "--no-title",
+        help="Disable title generation even when metadata provides one.",
+        rich_help_panel=TEMPLATE_PANEL,
+    ),
+]
+
+ParserOption = Annotated[
+    str | None,
+    typer.Option(
+        "--parser",
+        help='BeautifulSoup parser backend to use (defaults to "html.parser").',
+        rich_help_panel=INPUTS_PANEL,
+    ),
+]
+
+DisableFallbackOption = Annotated[
+    bool,
+    typer.Option(
+        "--no-fallback-converters",
+        help="Disable registration of placeholder converters when Docker is unavailable.",
+        rich_help_panel=RENDERING_PANEL,
+    ),
+]
+
+NoCopyAssetsOption = Annotated[
+    bool,
+    typer.Option(
+        "--no-copy-assets",
+        "-C",
+        help="Disable copying of remote assets to the output directory.",
+        rich_help_panel=RENDERING_PANEL,
+    ),
+]
+
+ConvertAssetsOption = Annotated[
+    bool,
+    typer.Option(
+        "--convert-assets",
+        help=(
+            "Convert bitmap assets (PNG/JPEG) to PDF even when LaTeX supports the original format."
+        ),
+        rich_help_panel=RENDERING_PANEL,
+    ),
+]
+
+HashAssetsOption = Annotated[
+    bool,
+    typer.Option(
+        "--hash-assets",
+        help="Hash stored asset filenames instead of preserving their original names.",
+        rich_help_panel=RENDERING_PANEL,
+    ),
+]
+
+TemplateAttributeOption = Annotated[
+    list[str] | None,
+    typer.Option(
+        "--attribute",
+        "-a",
+        help="Override template attributes as key=value pairs (e.g. -a emoji=color).",
+        show_default=False,
+        rich_help_panel=TEMPLATE_PANEL,
+    ),
+]
+
+EnableFragmentOption = Annotated[
+    list[str] | None,
+    typer.Option(
+        "--enable-fragment",
+        "-f",
+        help="Enable an additional fragment by name (can be repeated).",
+        show_default=False,
+        rich_help_panel=TEMPLATE_PANEL,
+    ),
+]
+
+DisableFragmentOption = Annotated[
+    list[str] | None,
+    typer.Option(
+        "--disable-fragment",
+        "-F",
+        help="Disable a fragment by name (can be repeated).",
+        show_default=False,
+        rich_help_panel=TEMPLATE_PANEL,
+    ),
+]
+
+ManifestOption = Annotated[
+    bool,
+    typer.Option(
+        "--manifest",
+        help="Generate a manifest.json file alongside the LaTeX output.",
+        rich_help_panel=RENDERING_PANEL,
+    ),
+]
+
+ManifestOptionWithShort = Annotated[
+    bool,
+    typer.Option(
+        "--manifest",
+        "-m",
+        help="Generate a manifest.json file alongside the LaTeX output.",
+        rich_help_panel=RENDERING_PANEL,
+    ),
+]
+
+MakefileDepsOption = Annotated[
+    bool,
+    typer.Option(
+        "--makefile-deps",
+        "-M",
+        help="Emit a Makefile-compatible .d dependency file when building PDFs.",
+        rich_help_panel=OUTPUT_PANEL,
+    ),
+]
+
+DebugHtmlOption = Annotated[
+    bool | None,
+    typer.Option(
+        "--debug-html",
+        help="Persist intermediate HTML snapshots (inherits from --debug when omitted).",
+        rich_help_panel=DIAGNOSTICS_PANEL,
+    ),
+]
+
+DebugRulesOption = Annotated[
+    bool,
+    typer.Option(
+        "--debug-rules",
+        help="Display the ordered list of registered render rules.",
+        rich_help_panel=DIAGNOSTICS_PANEL,
+    ),
+]
+
+TemplateInfoOption = Annotated[
+    bool,
+    typer.Option(
+        "--template-info",
+        help="Display template metadata and exit.",
+        rich_help_panel=DIAGNOSTICS_PANEL,
+    ),
+]
+
+HtmlOnlyOption = Annotated[
+    bool,
+    typer.Option(
+        "--html",
+        help="Output intermediate HTML instead of LaTeX/PDF.",
+        rich_help_panel=OUTPUT_PANEL,
+    ),
+]
+
+LanguageOption = Annotated[
+    str | None,
+    typer.Option(
+        "-l",
+        "--language",
+        help="Language code passed to babel (defaults to metadata or english).",
+        rich_help_panel=RENDERING_PANEL,
+    ),
+]
+
+SlotsOption = Annotated[
+    list[str] | None,
+    typer.Option(
+        "--slot",
+        "-s",
+        help=(
+            "Inject a document section into a template slot using 'slot:Section'. Repeat to map "
+            "multiple sections."
+        ),
+        show_default=False,
+        rich_help_panel=TEMPLATE_PANEL,
+    ),
+]
+
+MarkdownExtensionsOption = Annotated[
+    list[str] | None,
+    typer.Option(
+        "--enable-extension",
+        "-x",
+        help=(
+            "Additional Markdown extensions to enable (comma or space separated values are accepted)."
+        ),
+        show_default=False,
+        rich_help_panel=RENDERING_PANEL,
+    ),
+]
+
+DisableMarkdownExtensionsOption = Annotated[
+    list[str] | None,
+    typer.Option(
+        "--disable-extension",
+        "-X",
+        help=(
+            "Markdown extensions to disable. Provide a comma separated list or repeat the option "
+            "multiple times. Use --list-extensions to see the extensions enabled by default."
+        ),
+        show_default=False,
+        rich_help_panel=RENDERING_PANEL,
+    ),
+]
+
+OutputPathOption = Annotated[
+    Path | None,
+    typer.Option(
+        "--output",
+        "-o",
+        "--output-dir",
+        help="Output file or directory. Defaults to stdout unless a template is used.",
+        show_default=False,
+        rich_help_panel=OUTPUT_PANEL,
+    ),
+]
+
+OutputDirOption = Annotated[
+    Path,
+    typer.Option(
+        "--output-dir",
+        "-o",
+        help="Directory used to collect generated assets (if any).",
+        resolve_path=True,
+        rich_help_panel=OUTPUT_PANEL,
+    ),
+]
+
+TemplateOption = Annotated[
+    str | None,
+    typer.Option(
+        "--template",
+        "-t",
+        help=(
+            "Select a LaTeX template to use during conversion. Accepts a local path, entry point, "
+            "or built-in slug such as 'article' or 'letter'."
+        ),
+        rich_help_panel=TEMPLATE_PANEL,
+    ),
+]
+
+FontsInfoOption = Annotated[
+    bool,
+    typer.Option(
+        "--fonts-info",
+        help="Display a summary of fallback fonts detected during rendering.",
+        rich_help_panel=DIAGNOSTICS_PANEL,
+    ),
+]
+
+OpenLogOption = Annotated[
+    bool,
+    typer.Option(
+        "--open-log",
+        help="Open the latexmk log with the system viewer when compilation fails.",
+        rich_help_panel=DIAGNOSTICS_PANEL,
+    ),
+]

texsmith/ui/cli/app.py

@@ -0,0 +1,65 @@
+"""Typer application wiring for the TeXSmith CLI."""
+
+from __future__ import annotations
+
+import click
+import typer
+from typer.core import TyperCommand
+
+from texsmith.ui.cli.commands.render import render
+
+from .state import debug_enabled, emit_error
+
+
+class HelpOnEmptyCommand(TyperCommand):
+    """Typer command that disables positional argument enforcement."""
+
+    def __init__(self, *args: object, **kwargs: object) -> None:  # type: ignore[override]
+        super().__init__(*args, **kwargs)
+        for param in self.params:
+            if isinstance(param, click.Argument):
+                param.required = False
+
+
+app = typer.Typer(
+    help="Convert MkDocs HTML fragments into LaTeX.",
+    context_settings={"help_option_names": ["--help"]},
+)
+
+
+app.command(cls=HelpOnEmptyCommand)(render)
+
+
+def main() -> None:
+    """Entry point compatible with console scripts."""
+    try:
+        app()
+    except typer.Exit:
+        raise
+    except KeyboardInterrupt as exc:
+        if debug_enabled():
+            raise
+        emit_error("Operation cancelled by user.", exception=exc)
+        raise typer.Exit(code=1) from exc
+    except SystemExit:
+        raise
+    except Exception as exc:  # pragma: no cover - defensive catch-all
+        from .state import get_cli_state
+
+        state = get_cli_state()
+        if state.show_tracebacks:
+            from rich.traceback import Traceback
+
+            tb = Traceback.from_exception(
+                type(exc),
+                exc,
+                exc.__traceback__,
+                show_locals=state.verbosity >= 2,
+            )
+            state.err_console.print(tb)
+        else:
+            emit_error(str(exc), exception=exc)
+        raise typer.Exit(code=1) from exc
+
+
+__all__ = ["app", "main"]