"""The console entry point declared in pyproject as `llmutils = "llmutils.cli:main"`."""

from __future__ import annotations

import sys
from collections.abc import Sequence

from llmutils import __version__


def main(argv: Sequence[str] | None = None) -> int:
    """Handle ``llmutils --version``.

    ``--version`` (or ``-V``) prints ``llmutils <version>`` on stdout and returns 0, where
    ``<version>`` is ``llmutils.__version__`` — i.e. what ``importlib.metadata`` read from
    the installed distribution. Anything else prints a usage line on stderr and returns 2.

    ``argv`` defaults to ``sys.argv[1:]``, so the installed launcher can call ``main()``
    with no arguments and a test can call it with a list.
    """
    ...