Fine-tune LLMs from one YAML. Layer streaming trains an 8B model on a 4 GB laptop GPU.
Python cliconsumer-gpudpofine-tuningggufhuggingfacellmllmopslocal-ailocal-llmloralow-vrammachine-learningollamapeftpythonpytorchqlorasfttransformers
"""Keep visible CLI commands and parameters discoverable in ``--help``."""
import inspect
from collections.abc import Iterator
import click
import typer
from soup_cli.cli import app
from soup_cli.utils.typer_compat import is_argument, is_group
def _visible_commands(
command: click.Command, path: tuple[str, ...] = ()
) -> Iterator[tuple[tuple[str, ...], click.Command]]:
"""Yield visible commands in the complete Typer command tree."""
if getattr(command, "hidden", False):
return
yield path, command
if is_group(command):
for name, child in command.commands.items():
yield from _visible_commands(child, path + (name,))
def _parameter_help(command: click.Command, parameter: click.Parameter) -> str | None:
"""Return help from Click or the Typer declaration behind an argument."""
if parameter.help:
return parameter.help
if not is_argument(parameter) or command.callback is None:
return parameter.help
callback_parameter = inspect.signature(command.callback).parameters.get(
parameter.name
)
if callback_parameter is None:
return parameter.help
argument_info = callback_parameter.default
if isinstance(argument_info, typer.models.ArgumentInfo):
return argument_info.help
return parameter.help
def test_visible_commands_and_parameters_have_help() -> None:
"""Every visible CLI entry should explain itself in generated help."""
root = typer.main.get_command(app)
missing: list[str] = []
for path, command in _visible_commands(root):
label = " ".join(path) or "soup"
if path and not command.help:
missing.append(f"command {label!r}")
for parameter in command.params:
if getattr(parameter, "hidden", False):
continue
if not _parameter_help(command, parameter):
missing.append(f"parameter {label!r}: {parameter.name!r}")
assert not missing, "Missing CLI help:\n" + "\n".join(missing)