fix: resolve UsageError from the installed typer's Click

changes/272.bugfix

@@ -0,0 +1 @@
+Fix `uv tool install bambox` / `pip install bambox` producing a CLI that crashed with `ModuleNotFoundError: No module named 'click'` on typer 0.25+, which vendors its own copy of Click.

src/bambox/cli.py

@@ -7,10 +7,14 @@
 from pathlib import Path
 from typing import Annotated, Optional
 
-import click
 import typer
 from rich.markup import escape
 
+try:  # typer >= 0.25 vendors its own copy of Click
+    from typer._click.exceptions import UsageError
+except ImportError:  # typer < 0.25 depends on the click package
+    from click.exceptions import UsageError  # type: ignore[assignment]
+
 from bambox import ui
 from bambox.cura import (
     PRINTER_MODEL_IDS,
@@ -453,6 +457,6 @@ def validate(
 def main(argv: list[str] | None = None) -> None:
     try:
         app(argv, standalone_mode=False)
-    except click.UsageError as exc:
+    except UsageError as exc:
         ui.error(str(exc))
         sys.exit(2)

tests/test_cli.py

@@ -421,3 +421,23 @@ def test_no_command_shows_help(self, capsys: pytest.CaptureFixture[str]) -> None
     def test_no_command_with_flag_only(self) -> None:
         with pytest.raises(SystemExit, match="2"):
             main(["--nonexistent-flag"])
+
+
+# ---------------------------------------------------------------------------
+# Entry point exception handling
+# ---------------------------------------------------------------------------
+
+
+class TestUsageErrorHandling:
+    def test_usage_error_matches_installed_typer(self) -> None:
+        """main() must catch the UsageError class the installed typer raises.
+
+        typer >= 0.25 vendors its own copy of Click, so importing
+        ``click.UsageError`` from the standalone package would silently stop
+        matching (and the click package is no longer installed at all).
+        """
+        import typer
+
+        from bambox.cli import UsageError
+
+        assert issubclass(typer.BadParameter, UsageError)