First version
This commit is contained in:
@@ -0,0 +1,198 @@
|
||||
"""Command line interface (Typer + Rich)."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from dataclasses import dataclass
|
||||
from pathlib import Path
|
||||
from typing import Annotated, NoReturn
|
||||
|
||||
import typer
|
||||
from rich.console import Console
|
||||
from rich.table import Table
|
||||
|
||||
from genshin_tcg import __version__
|
||||
from genshin_tcg.config import CardSettings, Settings
|
||||
from genshin_tcg.data.catalog import load_catalog
|
||||
from genshin_tcg.data.paimon import SourceError
|
||||
from genshin_tcg.logging_setup import configure_logging
|
||||
from genshin_tcg.pipeline import build as build_pipeline
|
||||
from genshin_tcg.pipeline import fetch as fetch_pipeline
|
||||
from genshin_tcg.pipeline import impose as impose_pipeline
|
||||
from genshin_tcg.pipeline import render as render_pipeline
|
||||
from genshin_tcg.rendering.converters import RenderError
|
||||
|
||||
app = typer.Typer(
|
||||
add_completion=False,
|
||||
no_args_is_help=True,
|
||||
help="Generate printable Genshin Impact TCG cards (HTML -> PNG -> A4 PDF).",
|
||||
)
|
||||
console = Console()
|
||||
|
||||
__all__ = ["app"]
|
||||
|
||||
|
||||
@dataclass(slots=True)
|
||||
class CliState:
|
||||
settings: Settings
|
||||
|
||||
|
||||
def _version_callback(value: bool) -> None:
|
||||
if value:
|
||||
console.print(f"genshin-tcg {__version__}")
|
||||
raise typer.Exit
|
||||
|
||||
|
||||
@app.callback()
|
||||
def main(
|
||||
ctx: typer.Context,
|
||||
version: Annotated[
|
||||
bool,
|
||||
typer.Option(
|
||||
"--version", callback=_version_callback, is_eager=True, help="Show version and exit."
|
||||
),
|
||||
] = False,
|
||||
verbose: Annotated[
|
||||
int, typer.Option("-v", "--verbose", count=True, help="Increase log verbosity (-v, -vv).")
|
||||
] = 0,
|
||||
language: Annotated[str, typer.Option(help="Dataset language, e.g. 'fr' or 'en'.")] = "fr",
|
||||
assets_dir: Annotated[
|
||||
Path, typer.Option(help="Directory for downloaded assets.")
|
||||
] = Path("assets"),
|
||||
build_dir: Annotated[
|
||||
Path, typer.Option(help="Directory for generated output.")
|
||||
] = Path("build"),
|
||||
dpi: Annotated[int | None, typer.Option(help="Output resolution (>= 300).")] = None,
|
||||
) -> None:
|
||||
"""Configure logging and shared settings for all sub-commands."""
|
||||
configure_logging(verbose)
|
||||
card = CardSettings() if dpi is None else CardSettings(dpi=dpi)
|
||||
settings = Settings(
|
||||
language=language,
|
||||
assets_dir=assets_dir,
|
||||
build_dir=build_dir,
|
||||
card=card,
|
||||
)
|
||||
ctx.obj = CliState(settings=settings)
|
||||
|
||||
|
||||
@app.command()
|
||||
def fetch(
|
||||
ctx: typer.Context,
|
||||
force: Annotated[bool, typer.Option(help="Re-download files even if cached.")] = False,
|
||||
assets: Annotated[
|
||||
bool, typer.Option("--assets/--no-assets", help="Download card images.")
|
||||
] = True,
|
||||
only: Annotated[
|
||||
list[str] | None, typer.Option("--only", help="Restrict to card id(s).")
|
||||
] = None,
|
||||
) -> None:
|
||||
"""Stage 1: download the dataset (+ assets) and build the local catalogue."""
|
||||
state = _state(ctx)
|
||||
try:
|
||||
result = fetch_pipeline(state.settings, only=only, force=force, with_assets=assets)
|
||||
except (SourceError, FileNotFoundError) as exc:
|
||||
_fail(exc)
|
||||
console.print(
|
||||
f"[green]Catalogue:[/green] {len(result.catalog)} cards "
|
||||
f"({len(result.catalog.characters)} characters, {len(result.catalog.actions)} actions)"
|
||||
)
|
||||
console.print(f"[green]Written:[/green] {state.settings.catalog_path}")
|
||||
|
||||
|
||||
@app.command()
|
||||
def render(
|
||||
ctx: typer.Context,
|
||||
screenshot: Annotated[
|
||||
bool, typer.Option("--screenshot/--no-screenshot", help="Rasterise HTML to PNG.")
|
||||
] = True,
|
||||
only: Annotated[
|
||||
list[str] | None, typer.Option("--only", help="Restrict to card id(s).")
|
||||
] = None,
|
||||
) -> None:
|
||||
"""Stage 2: emit standalone HTML (and PNG) for each card."""
|
||||
state = _state(ctx)
|
||||
try:
|
||||
rendered = render_pipeline(state.settings, only=only, screenshot=screenshot)
|
||||
except (FileNotFoundError, RenderError) as exc:
|
||||
_fail(exc)
|
||||
console.print(f"[green]Rendered:[/green] {len(rendered)} card(s) -> {state.settings.html_dir}")
|
||||
if screenshot:
|
||||
console.print(f"[green]PNG:[/green] {state.settings.png_dir}")
|
||||
|
||||
|
||||
@app.command()
|
||||
def impose(
|
||||
ctx: typer.Context,
|
||||
output: Annotated[Path | None, typer.Option(help="PDF output path.")] = None,
|
||||
only: Annotated[
|
||||
list[str] | None, typer.Option("--only", help="Restrict to card id(s).")
|
||||
] = None,
|
||||
) -> None:
|
||||
"""Stage 3: lay the generated PNGs out on A4 sheets and write a PDF."""
|
||||
state = _state(ctx)
|
||||
try:
|
||||
result = impose_pipeline(state.settings, only=only, output=output)
|
||||
except FileNotFoundError as exc:
|
||||
_fail(exc)
|
||||
console.print(
|
||||
f"[green]PDF:[/green] {result.output} ({result.cards} cards, {result.pages} page(s))"
|
||||
)
|
||||
|
||||
|
||||
@app.command()
|
||||
def build(
|
||||
ctx: typer.Context,
|
||||
force: Annotated[bool, typer.Option(help="Re-download files even if cached.")] = False,
|
||||
assets: Annotated[
|
||||
bool, typer.Option("--assets/--no-assets", help="Download card images.")
|
||||
] = True,
|
||||
screenshot: Annotated[
|
||||
bool, typer.Option("--screenshot/--no-screenshot", help="Rasterise HTML to PNG.")
|
||||
] = True,
|
||||
only: Annotated[
|
||||
list[str] | None, typer.Option("--only", help="Restrict to card id(s).")
|
||||
] = None,
|
||||
) -> None:
|
||||
"""Run all three stages: fetch -> render -> impose."""
|
||||
state = _state(ctx)
|
||||
try:
|
||||
result = build_pipeline(
|
||||
state.settings, only=only, force=force, with_assets=assets, screenshot=screenshot
|
||||
)
|
||||
except (SourceError, FileNotFoundError, RenderError) as exc:
|
||||
_fail(exc)
|
||||
console.print(
|
||||
f"[bold green]Done:[/bold green] {len(result.rendered)} cards -> {result.imposition.output}"
|
||||
)
|
||||
|
||||
|
||||
@app.command(name="list")
|
||||
def list_cards(ctx: typer.Context) -> None:
|
||||
"""Print the locally built catalogue."""
|
||||
state = _state(ctx)
|
||||
catalog_path = state.settings.catalog_path
|
||||
if not catalog_path.is_file():
|
||||
_fail(FileNotFoundError(f"No catalogue at {catalog_path}. Run 'fetch' first."))
|
||||
catalog = load_catalog(catalog_path)
|
||||
table = Table(title=f"{len(catalog)} card(s)", header_style="bold")
|
||||
table.add_column("id")
|
||||
table.add_column("name")
|
||||
table.add_column("type")
|
||||
for card in catalog:
|
||||
table.add_row(card.id, card.name, card.type.value)
|
||||
console.print(table)
|
||||
|
||||
|
||||
def _state(ctx: typer.Context) -> CliState:
|
||||
if not isinstance(ctx.obj, CliState): # pragma: no cover - defensive
|
||||
raise RuntimeError("CLI state was not initialised.")
|
||||
return ctx.obj
|
||||
|
||||
|
||||
def _fail(exc: BaseException) -> NoReturn:
|
||||
console.print(f"[bold red]Error:[/bold red] {exc}")
|
||||
raise typer.Exit(code=1)
|
||||
|
||||
|
||||
if __name__ == "__main__": # pragma: no cover
|
||||
app()
|
||||
Reference in New Issue
Block a user