Add --one-pass-only parameter to breeze docs build command

The parameter was previously supported in the docs-build script
but it was not exposed via breeze commands.

It allows to iterate faster on docs building, by default docs building
runs up to 3 passes in order to account for new cross-references
between multiple providers, this flag makes it one pass, which makes
it faster to summarize the errors when you try to nail down a problem
with docs.

Author: potiuk

dev/breeze/src/airflow_breeze/commands/developer_commands.py

@@ -312,6 +312,11 @@ def start_airflow(
     "Implies --clean-build",
     is_flag=True,
 )
+@click.option(
+    "--one-pass-only",
+    help="Builds documentation in one pass only. This is useful for debugging sphinx errors.",
+    is_flag=True,
+)
 @option_github_repository
 @option_verbose
 @option_dry_run
@@ -320,6 +325,7 @@ def build_docs(
     spellcheck_only: bool,
     for_production: bool,
     clean_build: bool,
+    one_pass_only: bool,
     package_filter: tuple[str],
     github_repository: str,
 ):

dev/breeze/src/airflow_breeze/commands/developer_commands_config.py

@@ -146,6 +146,7 @@
                 "--spellcheck-only",
                 "--clean-build",
                 "--for-production",
+                "--one-pass-only",
                 "--package-filter",
                 "--github-repository",
             ],

dev/breeze/src/airflow_breeze/params/doc_build_params.py

@@ -29,6 +29,7 @@ class DocBuildParams:
     spellcheck_only: bool
     for_production: bool
     skip_environment_initialization: bool = False
+    one_pass_only: bool = False
     github_actions = os.environ.get("GITHUB_ACTIONS", "false")
 
     @property
@@ -40,6 +41,8 @@ def args_doc_builder(self) -> list[str]:
             doc_args.append("--spellcheck-only")
         if self.for_production:
             doc_args.append("--for-production")
+        if self.one_pass_only:
+            doc_args.append("--one-pass-only")
         if AIRFLOW_BRANCH != "main":
             doc_args.append("--disable-provider-checks")
         if self.package_filter and len(self.package_filter) > 0:

images/breeze/output-commands-hash.txt

@@ -2,7 +2,7 @@
 # Please do not solve it but run `breeze setup regenerate-command-images`.
 # This command should fix the conflict and regenerate help images that you have conflict with.
 main:83de6a9bf2b1afecd1f9ce4cd0493733
-build-docs:61ddf42565c6e39b2a1b228b2a0e89de
+build-docs:093cf82ab80aee65c6ada9b16ac60612
 ci:find-newer-dependencies:8fa2b57f5f0523c928743b235ee3ab5a
 ci:fix-ownership:fee2c9ec9ef19686792002ae054fecdd
 ci:free-space:47234aa0a60b0efd84972e6e797379f8