typantic 0.2.0__tar.gz → 0.2.1__tar.gz

{typantic-0.2.0 → typantic-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: typantic
-Version: 0.2.0
+Version: 0.2.1
 Summary: Auto-generate Typer CLI interfaces from Pydantic models.
 Keywords: typer,pydantic,cli,validation
 Author: Kilian Schnelle
@@ -99,7 +99,7 @@ $ python example.py --help
 ╭─ Options ────────────────────────────────────────────────────╮
 │ *  --output     PATH     Output directory.  [required]       │
 │    --threshold  FLOAT    Detection threshold.  [default: 0.5]│
-│    --seed       INTEGER  Random seed.                        │
+│    --seed       INTEGER  Random seed.  [default: (None)]     │
 │    --help                Show this message and exit.         │
 ╰──────────────────────────────────────────────────────────────╯
 ```
@@ -126,6 +126,7 @@ Your function receives the **validated model instance** — validators, `default
 | `Field(default=...)`              | Default value shown in `--help`         |
 | `Field(default_factory=...)`      | Factory called once at decoration time  |
 | `int \| None`                     | Optional CLI option                     |
+| `default=None`                    | Rendered as `[default: (None)]`         |
 | `list[Path]`                      | Variadic positional argument            |
 | `AfterValidator`, `BeforeValidator` | Run at call time via Pydantic         |
 

{typantic-0.2.0 → typantic-0.2.1}/README.md

@@ -75,7 +75,7 @@ $ python example.py --help
 ╭─ Options ────────────────────────────────────────────────────╮
 │ *  --output     PATH     Output directory.  [required]       │
 │    --threshold  FLOAT    Detection threshold.  [default: 0.5]│
-│    --seed       INTEGER  Random seed.                        │
+│    --seed       INTEGER  Random seed.  [default: (None)]     │
 │    --help                Show this message and exit.         │
 ╰──────────────────────────────────────────────────────────────╯
 ```
@@ -102,6 +102,7 @@ Your function receives the **validated model instance** — validators, `default
 | `Field(default=...)`              | Default value shown in `--help`         |
 | `Field(default_factory=...)`      | Factory called once at decoration time  |
 | `int \| None`                     | Optional CLI option                     |
+| `default=None`                    | Rendered as `[default: (None)]`         |
 | `list[Path]`                      | Variadic positional argument            |
 | `AfterValidator`, `BeforeValidator` | Run at call time via Pydantic         |
 

{typantic-0.2.0 → typantic-0.2.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "typantic"
-version = "0.2.0"
+version = "0.2.1"
 description = "Auto-generate Typer CLI interfaces from Pydantic models."
 readme = "README.md"
 license = "MIT"

{typantic-0.2.0 → typantic-0.2.1}/src/typantic/_decorator.py

@@ -93,6 +93,8 @@ def pydantic_to_typer(
         - ``Field(default=...)``  ->  Typer default value
         - ``Field(default_factory=...)``  ->  factory is called once at
           decoration time to supply the Typer default
+        - a ``None`` default  ->  rendered as ``[default: (None)]`` in
+          ``--help`` (Click would otherwise omit it entirely)
 
     The decorated function receives the **validated** Pydantic model
     instance, so all ``AfterValidator`` / ``BeforeValidator`` logic runs
@@ -134,6 +136,14 @@ def pydantic_to_typer(
             base_type = _extract_base_type(resolved_hints[name])
             help_text = field_info.description or ""
 
+            default: object
+            if field_info.is_required():
+                default = inspect.Parameter.empty
+            elif field_info.default_factory is not None:
+                default = field_info.default_factory()  # type: ignore[call-arg]
+            else:
+                default = field_info.default
+
             typer_meta: typer.models.ArgumentInfo | typer.models.OptionInfo
             if field_info.kw_only is False:
                 typer_meta = typer.Argument(
@@ -142,19 +152,17 @@ def pydantic_to_typer(
                 )
             else:
                 panel = _panel_for_field(model_cls, name) if subpanels else None
-                typer_meta = typer.Option(help=help_text, rich_help_panel=panel)
+                typer_meta = typer.Option(
+                    help=help_text,
+                    rich_help_panel=panel,
+                    # Click omits `None` defaults entirely; surface them as
+                    # "[default: (None)]" so optional options are visibly so.
+                    show_default="None" if default is None else True,
+                )
 
             annotated = Annotated[base_type, typer_meta]  # type: ignore[valid-type]
             new_annotations[name] = annotated
 
-            default: object
-            if field_info.is_required():
-                default = inspect.Parameter.empty
-            elif field_info.default_factory is not None:
-                default = field_info.default_factory()  # type: ignore[call-arg]
-            else:
-                default = field_info.default
-
             new_params.append(
                 inspect.Parameter(
                     name,