copier-tui 0.6.8__tar.gz

copier_tui-0.6.8/PKG-INFO

@@ -0,0 +1,38 @@
+Metadata-Version: 2.4
+Name: copier-tui
+Version: 0.6.8
+Summary: A terminal UI for copier: the same CLI, a survey you can move back and forth through before instantiating the template
+Author-email: Stellars Henson <konrad.jelen+github@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/stellarshenson/copier-tui
+Project-URL: Repository, https://github.com/stellarshenson/copier-tui
+Project-URL: Issues, https://github.com/stellarshenson/copier-tui/issues
+Keywords: copier,template,scaffolding,tui,textual,terminal
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: copier-ui==0.6.8
+Requires-Dist: copier>=9.6
+Requires-Dist: textual>=1.0
+Requires-Dist: rich>=13.0
+
+# copier-tui
+
+A terminal UI for [copier](https://copier.readthedocs.io). Same CLI, better survey.
+
+`copier-tui` takes copier's exact command line and replaces the prompt sequence with a
+[Textual](https://textual.textualize.io) interface you can move back and forth through, review,
+and only then instantiate. Templates need no changes.
+
+```bash
+pip install copier-tui
+copier-tui copy gh:stellarshenson/copier-data-science ./my-project
+```
+
+Built on [copier-ui](https://pypi.org/project/copier-ui/), which owns the survey semantics.
+
+Full documentation at [github.com/stellarshenson/copier-tui](https://github.com/stellarshenson/copier-tui).

copier_tui-0.6.8/README.md

@@ -0,0 +1,16 @@
+# copier-tui
+
+A terminal UI for [copier](https://copier.readthedocs.io). Same CLI, better survey.
+
+`copier-tui` takes copier's exact command line and replaces the prompt sequence with a
+[Textual](https://textual.textualize.io) interface you can move back and forth through, review,
+and only then instantiate. Templates need no changes.
+
+```bash
+pip install copier-tui
+copier-tui copy gh:stellarshenson/copier-data-science ./my-project
+```
+
+Built on [copier-ui](https://pypi.org/project/copier-ui/), which owns the survey semantics.
+
+Full documentation at [github.com/stellarshenson/copier-tui](https://github.com/stellarshenson/copier-tui).

copier_tui-0.6.8/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "copier-tui"
+version = "0.6.8"
+description = "A terminal UI for copier: the same CLI, a survey you can move back and forth through before instantiating the template"
+authors = [
+    { name = "Stellars Henson", email = "konrad.jelen+github@gmail.com" },
+]
+license = "MIT"
+readme = "README.md"
+requires-python = ">=3.11"
+keywords = ["copier", "template", "scaffolding", "tui", "textual", "terminal"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Topic :: Software Development :: Code Generators",
+]
+
+dependencies = [
+    "copier-ui==0.6.8",
+    "copier>=9.6",
+    "textual>=1.0",
+    "rich>=13.0",
+]
+
+[project.scripts]
+copier-tui = "copier_tui.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/stellarshenson/copier-tui"
+Repository = "https://github.com/stellarshenson/copier-tui"
+Issues = "https://github.com/stellarshenson/copier-tui/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["copier_tui*"]

copier_tui-0.6.8/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

copier_tui-0.6.8/src/copier_tui/__init__.py

@@ -0,0 +1,11 @@
+"""Terminal renderer for a copier template survey."""
+
+from importlib.metadata import version
+import os
+
+# WSL leaves COLORTERM unset, and the dark slates downsample to xterm teal without it.
+os.environ.setdefault("COLORTERM", "truecolor")
+
+__version__ = version("copier-tui")
+
+__all__ = ["__version__"]

copier_tui-0.6.8/src/copier_tui/app.py

@@ -0,0 +1,129 @@
+"""The Textual application and the survey entry point."""
+
+from __future__ import annotations
+
+from collections.abc import Iterable
+from pathlib import Path
+from typing import Any, ClassVar
+
+from rich.text import Text
+from textual import events
+from textual.app import App, SystemCommand
+from textual.binding import Binding
+from textual.geometry import Size
+from textual.screen import Screen
+from textual.widgets import Static
+
+from copier_tui.errors import EXIT_CANCELLED, EXIT_FAILURE, EXIT_OK
+from copier_tui.screens import ExecutionScreen, ReviewScreen, SurveyScreen
+from copier_tui.screens.survey import askable_ids
+from copier_tui.theme import BASE_CSS, HEADER_CSS, MIN_HEIGHT, MIN_WIDTH, THEME
+from copier_ui import TemplateUI
+
+
+class SurveyApp(App[int]):
+    """Drives survey, review and execution, and returns a process exit code.
+
+    Review is pushed on top of the survey rather than replacing it, so coming back finds
+    the form exactly as it was left - same scroll offset, same focused field - while every
+    row re-reads the state on resume and shows whatever the new answers recomputed.
+    """
+
+    CSS = HEADER_CSS + BASE_CSS
+    TITLE = "copier-tui"
+
+    BINDINGS: ClassVar[list[Binding]] = [
+        Binding("ctrl+c", "cancel", "Cancel", priority=True, show=False),
+    ]
+
+    def __init__(self, ui: TemplateUI, dst: Path, copier_kwargs: dict[str, Any]) -> None:
+        """Hold the loaded template UI, the destination and copier's own flags."""
+        super().__init__()
+        self.ui = ui
+        self.dst = dst
+        self.copier_kwargs = copier_kwargs
+
+    def get_system_commands(self, screen: Screen) -> Iterable[SystemCommand]:
+        """copier-tui's palette is the brand; drop Textual's theme switcher."""
+        for command in super().get_system_commands(screen):
+            if command.title != "Change theme":
+                yield command
+
+    def on_mount(self) -> None:
+        """Register the palette, then open the survey - or review when nothing is asked."""
+        self.register_theme(THEME)
+        self.theme = THEME.name
+        if self._has_questions():
+            self._push(SurveyScreen(self.ui))
+        else:
+            self._open_review()
+
+    def on_resize(self, event: events.Resize) -> None:
+        """Show the resize prompt below MIN_WIDTH or MIN_HEIGHT, hide it above.
+
+        The event carries the new size; App.size still reports the old one here.
+        """
+        self._check_size(event.size)
+
+    def on_survey_screen_confirmed(self, message: SurveyScreen.Confirmed) -> None:
+        """The survey is ready: stack review on top of it, leaving the form untouched."""
+        message.stop()
+        self._open_review()
+
+    def on_survey_screen_cancelled(self, message: SurveyScreen.Cancelled) -> None:
+        """The survey was abandoned: leave without writing anything."""
+        message.stop()
+        self.exit(EXIT_CANCELLED)
+
+    def action_cancel(self) -> None:
+        """Leave without writing anything."""
+        self.exit(EXIT_CANCELLED)
+
+    def _has_questions(self) -> bool:
+        """True when at least one field is visible and not already answered by --data."""
+        return bool(askable_ids(self.ui.state()))
+
+    def _push(self, screen: Screen[Any], callback: Any = None) -> None:
+        """Push a screen and re-check the terminal size once it has laid out."""
+        self.push_screen(screen, callback)
+        self.call_after_refresh(self._check_size)
+
+    def _open_review(self) -> None:
+        """Stack the review screen over whatever is showing."""
+        self._push(ReviewScreen(self.ui, self.dst), self._after_review)
+
+    def _after_review(self, confirmed: bool | None) -> None:
+        """Review confirmed starts the render; back just uncovers the survey again."""
+        if confirmed:
+            self._push(
+                ExecutionScreen(self.ui, self.dst, self.copier_kwargs), self._after_execution
+            )
+        elif not self._has_questions():
+            self.exit(EXIT_CANCELLED)
+        else:
+            self.call_after_refresh(self._check_size)
+
+    def _after_execution(self, ok: bool | None) -> None:
+        """The render's verdict is the process exit code."""
+        self.exit(EXIT_OK if ok else EXIT_FAILURE)
+
+    def _check_size(self, size: Size | None = None) -> None:
+        """Mount or drop the resize prompt on the screen currently on top."""
+        size = self.size if size is None else size
+        prompt = self.screen.query("#resize-prompt")
+        if size.width < MIN_WIDTH or size.height < MIN_HEIGHT:
+            if not prompt:
+                self.screen.mount(
+                    Static(
+                        Text(f"terminal too small\nresize to {MIN_WIDTH} x {MIN_HEIGHT}"),
+                        id="resize-prompt",
+                    )
+                )
+        else:
+            prompt.remove()
+
+
+def run_survey(ui: TemplateUI, dst: Path, copier_kwargs: dict[str, Any]) -> int:
+    """Run the app to completion and return its exit code."""
+    exit_code = SurveyApp(ui, dst, copier_kwargs).run()
+    return EXIT_CANCELLED if exit_code is None else exit_code

copier_tui-0.6.8/src/copier_tui/cli.py

@@ -0,0 +1,161 @@
+"""copier's own command line, subclassed.
+
+plumbum collects subcommands and switches across the MRO and lets a child class override a
+parent's subcommand of the same name, so every flag, short form, help string and error message
+below is copier's, inherited rather than restated. Only `main` is overridden, and only to open
+the survey instead of copier's prompt sequence. `check-update` is inherited untouched.
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+import sys
+from typing import Any
+
+from copier import VcsRef
+from copier._cli import (
+    CopierApp,
+    CopierCopySubApp,
+    CopierRecopySubApp,
+    CopierUpdateSubApp,
+)
+from copier._tools import try_enum
+from copier.errors import UnsafeTemplateError
+from plumbum import colors
+
+from copier_tui import __version__
+from copier_tui.app import run_survey
+from copier_tui.errors import EXIT_CANCELLED, EXIT_FAILURE, EXIT_UNSAFE, NotATerminalError
+from copier_ui import CopierUIError, Operation, TemplateUI
+
+
+class CopierTuiApp(CopierApp):
+    """The copier-tui CLI application."""
+
+    PROGNAME = "copier-tui"
+    VERSION = __version__
+
+
+class _TuiSubcommand:
+    """Shared launch path for the subcommands that open a survey."""
+
+    def _headless(self) -> bool:
+        """True when copier's own flags say the survey is not the one asking.
+
+        `--defaults` answers everything, and `--force` implies it. `--quiet` is not one of
+        them: it suppresses status output and still asks. `--ask` is - it asks its questions
+        again at render time whatever answers were supplied, so the survey would collect an
+        answer only for copier to prompt for it on the render thread with the terminal held.
+        A user who asked for copier's own prompting gets copier's own prompting.
+        """
+        return bool(self.defaults or self.ask or getattr(self, "force", False))
+
+    def _copier_kwargs(self) -> dict[str, Any]:
+        """The subcommand's flags, as keyword arguments for copier's run_* function."""
+        return {
+            "answers_file": self.answers_file,
+            "vcs_ref": try_enum(VcsRef, self.vcs_ref),
+            "exclude": self.exclude,
+            "use_prereleases": self.prereleases,
+            "skip_if_exists": self.skip,
+            "pretend": self.pretend,
+            "quiet": self.quiet,
+            "unsafe": self.unsafe,
+            "skip_tasks": self.skip_tasks,
+            "ask": self.ask,
+        }
+
+    def _launch(self, src: str | None, destination_path: str, operation: Operation) -> int:
+        """Check for a tty, load the template, run the survey; report load failures and exit."""
+        if not (sys.stdin.isatty() and sys.stdout.isatty()):
+            message = "copier-tui needs a terminal; use --defaults or --force to run headless"
+            print(colors.red | str(NotATerminalError(message)), file=sys.stderr)
+            return EXIT_FAILURE
+        dst = Path(destination_path)
+        try:
+            ui = TemplateUI.from_template(
+                src,
+                vcs_ref=self.vcs_ref,
+                answers_file=self.answers_file,
+                dst=dst,
+                data=self.data,
+                operation=operation,
+                unsafe=self.unsafe,
+            )
+        except CopierUIError as error:
+            print(colors.red | str(error), file=sys.stderr)
+            if isinstance(error.__cause__, UnsafeTemplateError):
+                return EXIT_UNSAFE
+            return EXIT_FAILURE
+        with ui:
+            code = run_survey(ui, dst, self._copier_kwargs())
+        if code == EXIT_CANCELLED:
+            print(colors.yellow | f"cancelled - nothing written to {dst}", file=sys.stderr)
+        return code
+
+
+@CopierTuiApp.subcommand("copy")
+class TuiCopySubApp(CopierCopySubApp, _TuiSubcommand):
+    """The `copier-tui copy` subcommand."""
+
+    def _copier_kwargs(self) -> dict[str, Any]:
+        """copier's own `copy` arguments, as `copier copy` assembles them."""
+        return {
+            **super()._copier_kwargs(),
+            "cleanup_on_error": self.cleanup_on_error,
+            "defaults": self.force or self.defaults,
+            "overwrite": self.force or self.overwrite,
+        }
+
+    def main(self, template_src: str, destination_path: str) -> int:
+        """Survey the template, then copy it; headless flags fall through to copier."""
+        if self._headless():
+            return super().main(template_src, destination_path)
+        return self._launch(template_src, destination_path, "copy")
+
+
+@CopierTuiApp.subcommand("recopy")
+class TuiRecopySubApp(CopierRecopySubApp, _TuiSubcommand):
+    """The `copier-tui recopy` subcommand."""
+
+    def _copier_kwargs(self) -> dict[str, Any]:
+        """copier's own `recopy` arguments, as `copier recopy` assembles them."""
+        return {
+            **super()._copier_kwargs(),
+            "defaults": self.force or self.defaults,
+            "overwrite": self.force or self.overwrite,
+            "skip_answered": self.skip_answered,
+        }
+
+    def main(self, destination_path: str = ".") -> int:
+        """Survey seeded from the destination's answers file, then recopy."""
+        if self._headless():
+            return super().main(destination_path)
+        return self._launch(None, destination_path, "recopy")
+
+
+@CopierTuiApp.subcommand("update")
+class TuiUpdateSubApp(CopierUpdateSubApp, _TuiSubcommand):
+    """The `copier-tui update` subcommand."""
+
+    def _copier_kwargs(self) -> dict[str, Any]:
+        """copier's own `update` arguments, as `copier update` assembles them."""
+        return {
+            **super()._copier_kwargs(),
+            "defaults": self.defaults,
+            "overwrite": True,
+            "conflict": self.conflict,
+            "context_lines": self.context_lines,
+            "skip_answered": self.skip_answered,
+        }
+
+    def main(self, destination_path: str = ".") -> int:
+        """Survey seeded from the destination's answers file, then update."""
+        if self._headless():
+            return super().main(destination_path)
+        return self._launch(None, destination_path, "update")
+
+
+def main() -> None:
+    """Console script entry point."""
+    CopierTuiApp.run()

copier_tui-0.6.8/src/copier_tui/errors.py

@@ -0,0 +1,17 @@
+"""Errors and exit codes for the terminal frontend."""
+
+from __future__ import annotations
+
+EXIT_OK = 0
+EXIT_FAILURE = 1
+EXIT_CANCELLED = 2
+EXIT_UNSAFE = 0b100
+"""copier's own code for a template refused for an unsafe feature."""
+
+
+class TuiError(Exception):
+    """Base class for every copier_tui error."""
+
+
+class NotATerminalError(TuiError):
+    """Launched without a terminal on stdin or stdout."""

copier_tui-0.6.8/src/copier_tui/screens/__init__.py

@@ -0,0 +1,7 @@
+"""Screens of the copier-tui survey."""
+
+from copier_tui.screens.execution import ExecutionScreen
+from copier_tui.screens.review import ReviewScreen
+from copier_tui.screens.survey import SurveyScreen
+
+__all__ = ["ExecutionScreen", "ReviewScreen", "SurveyScreen"]

copier_tui-0.6.8/src/copier_tui/screens/execution.py

@@ -0,0 +1,146 @@
+"""The execution screen: the copier run, its progress and its verdict."""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Any, ClassVar
+
+from rich.text import Text
+from textual import events
+from textual.app import ComposeResult
+from textual.binding import Binding
+from textual.containers import Vertical
+from textual.screen import Screen
+from textual.widgets import Footer, ProgressBar, Static
+
+from copier_tui.theme import MINT, ORANGE, ROSE, SURFACE_BG, TEXT_MUTED, TEXT_SUBTLE
+from copier_tui.widgets import HeaderBar
+from copier_ui import TemplateUI
+
+
+class ExecutionScreen(Screen[bool]):
+    """Runs copier in a worker thread and reports success or failure."""
+
+    DEFAULT_CSS = f"""
+    #exec-body {{
+        width: 100%;
+        height: 1fr;
+        padding: 1;
+    }}
+    #exec-status {{
+        height: 1;
+        color: {TEXT_MUTED};
+    }}
+    #exec-verdict {{
+        height: 1;
+        color: {TEXT_SUBTLE};
+    }}
+    #exec-progress {{
+        width: 100%;
+    }}
+    #exec-progress Bar {{
+        width: 1fr;
+    }}
+    #exec-progress Bar > .bar--bar {{
+        color: {ORANGE};
+        background: {SURFACE_BG};
+    }}
+    #exec-progress Bar > .bar--indeterminate {{
+        color: {ORANGE};
+        background: {SURFACE_BG};
+    }}
+    #exec-progress Bar > .bar--complete {{
+        color: {MINT};
+        background: {SURFACE_BG};
+    }}
+    """
+
+    BINDINGS: ClassVar[list[Binding]] = [
+        Binding("enter", "close", "Close", priority=True),
+        Binding("escape", "close", "Close", priority=True, show=False),
+    ]
+
+    def __init__(self, ui: TemplateUI, dst: Path, copier_kwargs: dict[str, Any]) -> None:
+        """Hold the template UI, the destination and copier's own flags."""
+        super().__init__(id="execution-screen")
+        self.ui = ui
+        self.dst = dst
+        self.copier_kwargs = copier_kwargs
+        self.pretend = bool(copier_kwargs.get("pretend"))
+        self._done = False
+        self._closed = False
+        self._ok = False
+
+    def compose(self) -> ComposeResult:
+        """Header, the status line and the progress bar, the verdict line, footer.
+
+        The destination is named once, by the status line that narrates the run: the header
+        says which run it is, and repeating the path three times said nothing extra.
+        """
+        verb = "checking" if self.pretend else "rendering"
+        yield HeaderBar("dry run" if self.pretend else "render")
+        yield Vertical(
+            Static(Text(f"{verb} the template"), id="exec-status"),
+            ProgressBar(total=None, show_percentage=False, show_eta=False, id="exec-progress"),
+            Static(id="exec-verdict"),
+            id="exec-body",
+        )
+        yield Footer()
+
+    def on_mount(self) -> None:
+        """Start the render worker and the indeterminate progress bar."""
+        self.run_worker(self._run_copier, thread=True, name="render")
+
+    def on_key(self, event: events.Key) -> None:
+        """Any key closes the finished run, not just the bound ones."""
+        if self._done:
+            event.stop()
+            self.action_close()
+
+    def action_close(self) -> None:
+        """End the run once the verdict is in; idempotent, any key reaches it too."""
+        if not self._done or self._closed:
+            return
+        self._closed = True
+        self.dismiss(self._ok)
+
+    def _run_copier(self) -> None:
+        """Call TemplateUI.render off the UI thread; report back with call_from_thread.
+
+        Not named `_render`: Widget._render is Textual's own, and shadowing it runs this
+        on the UI thread during layout.
+        """
+        error: BaseException | None = None
+        try:
+            self.ui.render(self.dst, **self.copier_kwargs)
+        except Exception as exc:  # noqa: BLE001 - any failure becomes the screen's verdict
+            error = exc
+        self.app.call_from_thread(self._finish, error)
+
+    def _finish(self, error: BaseException | None) -> None:
+        """Put the verdict on the status line: mint on success, rose with copier's message.
+
+        A dry run says so - it reports what copier would write, and writes nothing. There is
+        no popup: the verdict belongs on the line that has been narrating the run, and the
+        destination is named once, by the status line, never also by the header.
+        """
+        self._done = True
+        self._ok = error is None
+        self.query_one("#exec-progress", ProgressBar).update(total=1, progress=1)
+        status = self.query_one("#exec-status", Static)
+        if error is None:
+            done = (
+                "nothing written - this was a dry run"
+                if self.pretend
+                else f"written to {self.dst}"
+            )
+            status.update(Text(done, style=MINT))
+        else:
+            status.update(Text(f"failed - {_message(error)}", style=ROSE))
+        self.query_one("#exec-verdict", Static).update(Text("press any key to close"))
+        self.set_focus(None)
+
+
+def _message(error: BaseException) -> str:
+    """copier's own message where there is one, the exception class otherwise."""
+    return str(error) or type(error).__name__

copier_tui-0.6.8/src/copier_tui/screens/review.py

@@ -0,0 +1,104 @@
+"""The review screen: every answer, confirmed before anything is written."""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import ClassVar
+
+from rich.text import Text
+from textual.app import ComposeResult
+from textual.binding import Binding
+from textual.containers import VerticalScroll
+from textual.screen import Screen
+from textual.widgets import Footer, Static
+
+from copier_tui.theme import AMBER, CYAN_BRIGHT, LABEL_WIDTH, TEXT, TEXT_SUBTLE
+from copier_tui.widgets import HeaderBar, display_value
+from copier_ui import TemplateUI
+
+UNSET = "not set"
+"""Stands in for an answer with no value, so a blank line is never mistaken for one."""
+
+
+class ReviewScreen(Screen[bool]):
+    """Lists every answer and warns when the destination is not empty."""
+
+    DEFAULT_CSS = f"""
+    #review-list {{
+        width: 100%;
+        height: 1fr;
+        padding: 1 2 0 1;
+        scrollbar-size-vertical: 1;
+    }}
+    #review-warning {{
+        height: 1;
+        width: 100%;
+        padding: 0 1;
+        color: {AMBER};
+    }}
+    .review-answer {{
+        height: 1;
+        width: 100%;
+    }}
+    #review-empty {{
+        color: {TEXT_SUBTLE};
+    }}
+    """
+
+    BINDINGS: ClassVar[list[Binding]] = [
+        Binding("enter", "confirm", "Create", priority=True),
+        Binding("escape", "back", "Back", priority=True),
+    ]
+
+    def __init__(self, ui: TemplateUI, dst: Path) -> None:
+        """Hold the template UI and the destination being reviewed."""
+        super().__init__(id="review-screen")
+        self.ui = ui
+        self.dst = dst
+
+    def compose(self) -> ComposeResult:
+        """Header, one line per answer, the destination warning, footer."""
+        yield HeaderBar(f"review · {self.dst}")
+        yield VerticalScroll(*self._answer_lines(), id="review-list")
+        yield Static(self._destination_note(), id="review-warning")
+        yield Footer()
+
+    def action_confirm(self) -> None:
+        """Dismiss with True to start the render."""
+        self.dismiss(True)
+
+    def action_back(self) -> None:
+        """Dismiss with False to return to the survey."""
+        self.dismiss(False)
+
+    def _destination_note(self) -> Text:
+        """Warn when the destination already holds files the render could overwrite."""
+        if _is_not_empty(self.dst):
+            return Text(f"{self.dst} is not empty - existing files may be overwritten")
+        return Text("")
+
+    def _answer_lines(self) -> list[Static]:
+        """One static per visible answer, id gutter aligned, secrets masked."""
+        state = self.ui.state()
+        lines = []
+        for field_id in state.visible_ids:
+            field = state.fields[field_id]
+            value = display_value(field)
+            lines.append(
+                Static(
+                    Text.assemble(
+                        (field_id[: LABEL_WIDTH - 1].ljust(LABEL_WIDTH), f"bold {CYAN_BRIGHT}"),
+                        (value, TEXT) if value else (UNSET, TEXT_SUBTLE),
+                    ),
+                    classes="review-answer",
+                    id=f"review-{field_id}",
+                )
+            )
+        if not lines:
+            lines.append(Static(Text("this template asks nothing"), id="review-empty"))
+        return lines
+
+
+def _is_not_empty(dst: Path) -> bool:
+    """True when the destination directory already holds something."""
+    return dst.is_dir() and any(dst.iterdir())