) still parts two words. +_DROPPED = Text("") +_DROPPED_BREAK = Text("") +_BREAK_TAG_RE = re.compile(r"
`` between two words leaves one space.""" + merged: list[Inline] = [] + dropped = parted = False + for inline in inlines: + if inline is _DROPPED or inline is _DROPPED_BREAK: + dropped = True + parted = parted or inline is _DROPPED_BREAK + continue + before = merged[-1] if merged else None + if dropped and isinstance(inline, Text) and isinstance(before, Text) and before.text.endswith(" "): + inline = Text(inline.text.lstrip(" ")) + elif parted and before is not None and not isinstance(inline, SoftBreak | HardBreak): + if isinstance(before, Text): + if not before.text.endswith(" ") and not (isinstance(inline, Text) and inline.text.startswith(" ")): + merged[-1] = before = Text(before.text + " ") + elif isinstance(inline, Text): + if not inline.text.startswith(" "): + inline = Text(" " + inline.text) + else: + merged.append(Text(" ")) + dropped = parted = False + if isinstance(inline, Text) and isinstance(before, Text): + merged[-1] = Text(before.text + inline.text) + else: + merged.append(inline) + return tuple(merged) + + +def build_tree(document: Document, result: ValidationResult) -> tuple[RenderTree, int]: + """The render tree for *document*, and the number of texts — a + paragraph, a title, a table cell — in which raw HTML was dropped (§8.7).""" + builder = _Builder(document, result) + tree = builder.tree() + return tree, builder.raw_html + + +def plain_inlines(text: str) -> tuple[Inline, ...]: + """Inline nodes for a frontmatter string: plain text in which only + directives are recognised (placeholders, §3.10) — never Markdown.""" + out: list[Inline] = [] + cursor = 0 + for directive in lex(text).directives: + if directive.start > cursor: + out.append(Text(text[cursor:directive.start])) + out.append(DirectiveSource(directive)) + cursor = directive.end + if cursor < len(text): + out.append(Text(text[cursor:])) + return tuple(out) diff --git a/src/legaldown_render/cli.py b/src/legaldown_render/cli.py new file mode 100644 index 0000000..a572acc --- /dev/null +++ b/src/legaldown_render/cli.py @@ -0,0 +1,123 @@ +"""The ``legaldown-render`` command. + +Exit codes: 0 — rendered (document errors, if any, are shown as markers and +listed on stderr); 1 — not rendered: refused under ``--strict``, or the +document cannot be read; 2 — a usage or style problem; 70 — an internal +error (a bug to report). +""" +from __future__ import annotations + +import argparse +import sys +from pathlib import Path +from typing import Any + +from . import __version__ +from .api import RenderOptions, render +from .errors import DocumentError, InternalError, RenderRefused +from .style import StyleError, builtin_styles, dump_style, load_style, parse_override +from .writers import FORMATS, format_for_path + + +def _setting(text: str) -> tuple[str, Any]: + key, separator, value = text.partition("=") + if not separator or not key.strip(): + raise argparse.ArgumentTypeError(f"expected KEY=VALUE, got '{text}'") + # Typed by the setting: text stays as written, anything else is YAML. + return key.strip(), parse_override(key.strip(), value) + + +def _parser() -> argparse.ArgumentParser: + parser = argparse.ArgumentParser( + prog="legaldown-render", + description="Render a LegalDown document to HTML or plain text.", + epilog="Style settings: --style picks a template (built-in: " + + ", ".join(builtin_styles()) + + ", or a .yaml file); --set overrides one setting, e.g. --set numbering.scheme=mixed. " + "See every setting with --print-style.", + ) + parser.add_argument("input", nargs="?", help="the .lgd file to render, or - for standard input") + parser.add_argument("-o", "--output", help="output file (default: standard output); its extension sets the format") + parser.add_argument("-f", "--format", choices=sorted(FORMATS), help="output format (default: from --output, else html)") + parser.add_argument("-s", "--style", help="style template: a built-in name or a path to a .yaml file") + parser.add_argument("--set", dest="overrides", action="append", default=[], type=_setting, metavar="KEY=VALUE", + help="override one style setting; repeatable. Text settings take the value as " + "written; one pair of matching outer quotes is removed (wrap the value in the " + "other kind of quote to keep quotation marks). Others read it as YAML, e.g. true or 2") + parser.add_argument("--locale", help="formatting locale, e.g. en-US or cs-CZ (default: the style's, else the document language)") + parser.add_argument("--fragment", action="store_true", help="HTML: write only the