Merge pull request #222 from DanCardin/dc/pyright

fix: Apply pyright strict typing.

Author: DanCardin

docs/source/api.md

@@ -2,7 +2,7 @@
 
 ```{eval-rst}
 .. autoapimodule:: cappa
-   :members: parse, invoke, invoke_async, collect, command, Command, Subcommand, Dep, Arg, ArgAction, Exit, Env, Completion, Output, FileMode, unpack_arguments, Group, Prompt, Confirm, ValueFrom, Default, State, Self
+   :members: parse, invoke, invoke_async, collect, command, Command, Subcommand, Dep, Arg, ArgAction, Exit, Env, Completion, Output, FileMode, unpack_arguments, Group, Prompt, Confirm, ValueFrom, Default, State, Self, default_parse
 ```
 
 ```{eval-rst}

docs/source/arg.md

@@ -457,6 +457,10 @@ Note cappa itself contains a number of component `parse_*` functions inside the
 module, which can be used in combination with your own custom `parse` functions.
 ```
 
+### `default_parse`
+
+A function [cappa.default_parse](cappa.default_parse) is exposed
+
 (parsing-json)=
 ### Parsing JSON
 

examples/defer_import_slow_startup/defer_import/main.py

@@ -17,4 +17,4 @@ class MeanCommand:
 
 
 def main():
-    cappa.invoke(DeferImport)
+    return cappa.invoke(DeferImport)

examples/defer_import_slow_startup/uv.lock

@@ -16,7 +16,7 @@ dependencies = [
     "rich >= 10.2.0",
     "typing-extensions >= 4.8.0",
     "typing-extensions >= 4.12.0; python_version >= '3.13'",
-    "type-lens >= 0.2.3",
+    "type-lens >= 0.2.4",
 ]
 
 [project.optional-dependencies]
@@ -80,6 +80,11 @@ warn_unused_ignores = true
 incremental = true
 check_untyped_defs = true
 
+[tool.pyright]
+typeCheckingMode = "strict"
+typeCheckingModeOverrides = { "type_lens/**" = "basic" }
+
+
 [tool.typos.default]
 extend-ignore-re = [".*#.*typos: ignore[^\\n]*\\n"]
 

pyproject.toml

@@ -6,7 +6,7 @@
 from cappa.help import HelpFormattable, HelpFormatter
 from cappa.invoke import Dep, Self
 from cappa.output import Exit, HelpExit, Output
-from cappa.parse import unpack_arguments
+from cappa.parse import default_parse, unpack_arguments
 from cappa.state import State
 from cappa.subcommand import Subcommand, Subcommands
 from cappa.type_view import Empty, EmptyType
@@ -46,6 +46,7 @@
     "backend",
     "collect",
     "command",
+    "default_parse",
     "invoke",
     "invoke_async",
     "parse",