Function cmd_log

examples/python-ml-experiment-tracker/tracker/cli.py:202–231

Log a new experiment run with hyperparameters and metrics.

(
    experiment: str,
    run_name: str | None,
    params: tuple[str, ...],
    metrics: tuple[str, ...],
    notes: str | None,
    started_at: str | None,
    finished_at: str | None,
)

@click.option("--finished-at", default=None, help="ISO-8601 finish time (default: now)")
@handle_errors
def cmd_log(
    experiment: str,
    run_name: str | None,
    params: tuple[str, ...],
    metrics: tuple[str, ...],
    notes: str | None,
    started_at: str | None,
    finished_at: str | None,
) -> None:
    """Log a new experiment run with hyperparameters and metrics."""
    parsed_params = parse_kv_pairs(params)
    parsed_metrics = parse_kv_pairs(metrics)
    ts = now_iso()
    started_at = started_at or ts
    finished_at = finished_at or ts

    with InsForgeClient() as client:
        exp = client.get_or_create_experiment(experiment)
        run = client.create_run(
            experiment_id=exp.id,
            experiment_name=exp.name,
            run_name=run_name,
            params=parsed_params,
            metrics=parsed_metrics,
            notes=notes,
            started_at=started_at,
            finished_at=finished_at,
        )

    _print_run_panel(run)


# ── tracker runs ──────────────────────────────────────────────────────────