chore: fix interrogate pre-commit

- Add docstrings for nested prompting helpers

- Exclude generated cforge/_version.py from interrogate hook

Signed-off-by: Matthew Grigsby <38010437+MatthewGrigsby@users.noreply.github.com>

Author: MatthewGrigsby

.pre-commit-config.yaml

@@ -530,5 +530,5 @@ repos:
     rev: 1.7.0  # or master if you're bold
     hooks:
       - id: interrogate
-        args: [--quiet, --fail-under=100]
+        args: [--quiet, --fail-under=100, --exclude, cforge/_version.py]
         files: ^cforge/

cforge/common/prompting.py

@@ -479,13 +479,15 @@ def _prompt_field_value(
         )
 
         def _format_string_default(default_value: Any) -> Tuple[str, bool]:
+            """Return a default prompt value (as text) and whether to show it."""
             if default_value is None:
                 return "", False
             if isinstance(default_value, str):
                 return default_value, True
             return json.dumps(default_value), True
 
         def _prompt_string_with_default() -> Tuple[Optional[str], bool]:
+            """Prompt for a string value while honoring schema defaults and required-ness."""
             default_text, show_default = _format_string_default(field_schema.get("default"))
             value = _prompt_string_value(
                 console=console,
@@ -743,13 +745,15 @@ def _prompt_object(field_schema: Dict[str, Any], prefilled: Optional[Dict[str, A
             additional_properties_schema = _resolve_effective_schema(schema, additional_properties)
 
             def _assign_typed_value(key: str, next_indent: str) -> None:
+                """Prompt for and assign a typed additional property value."""
                 value, _ = _prompt_field_value(key, additional_properties_schema, is_required=True, field_indent=next_indent)
                 data[key] = value
 
             _prompt_additional_properties(object_indent, _assign_typed_value)
         elif additional_properties is True and prompt_optional:
 
             def _assign_json_value(key: str, next_indent: str) -> None:
+                """Prompt for and assign a JSON additional property value."""
                 formatted_next_indent = _format_prompt_indent(next_indent)
                 console.print(f"{formatted_next_indent}Enter JSON value", end="")
                 raw_value = typer.prompt("", type=str)