Update doc for infrahubctl and fix for hidden commands

Author: dgarros

docs/docs/infrahubctl/infrahubctl-object.mdx

@@ -17,6 +17,7 @@ $ infrahubctl object [OPTIONS] COMMAND [ARGS]...
 **Commands**:
 
 * `load`: Load one or multiple objects files into...
+* `validate`: Validate one or multiple objects files.
 
 ## `infrahubctl object load`
 
@@ -38,3 +39,24 @@ $ infrahubctl object load [OPTIONS] PATHS...
 * `--branch TEXT`: Branch on which to load the objects.
 * `--config-file TEXT`: [env var: INFRAHUBCTL_CONFIG; default: infrahubctl.toml]
 * `--help`: Show this message and exit.
+
+## `infrahubctl object validate`
+
+Validate one or multiple objects files.
+
+**Usage**:
+
+```console
+$ infrahubctl object validate [OPTIONS] PATHS...
+```
+
+**Arguments**:
+
+* `PATHS...`: [required]
+
+**Options**:
+
+* `--debug / --no-debug`: [default: no-debug]
+* `--branch TEXT`: Branch on which to validate the objects.
+* `--config-file TEXT`: [env var: INFRAHUBCTL_CONFIG; default: infrahubctl.toml]
+* `--help`: Show this message and exit.

tasks.py

@@ -24,14 +24,23 @@ def _generate_infrahubctl_documentation(context: Context) -> None:
 
     output_dir = DOCUMENTATION_DIRECTORY / "docs" / "infrahubctl"
     output_dir.mkdir(parents=True, exist_ok=True)
+
+    # Delete any existing infrahubctl- files in output dir
+    for file in output_dir.glob("infrahubctl-*"):
+        file.unlink()
+
     print(" - Generate infrahubctl CLI documentation")
     for cmd in app.registered_commands:
+        if cmd.hidden:
+            continue
         exec_cmd = f'poetry run typer --func {cmd.name} infrahub_sdk.ctl.cli_commands utils docs --name "infrahubctl {cmd.name}"'
         exec_cmd += f" --output docs/docs/infrahubctl/infrahubctl-{cmd.name}.mdx"
         with context.cd(MAIN_DIRECTORY_PATH):
             context.run(exec_cmd)
 
     for cmd in app.registered_groups:
+        if cmd.hidden:
+            continue
         exec_cmd = f"poetry run typer infrahub_sdk.ctl.{cmd.name} utils docs"
         exec_cmd += f' --name "infrahubctl {cmd.name}" --output docs/docs/infrahubctl/infrahubctl-{cmd.name}.mdx'
         with context.cd(MAIN_DIRECTORY_PATH):