Add command to regenerate breeze command output images

.gitignore

@@ -225,3 +225,7 @@ licenses/LICENSES-ui.txt
 
 # Packaged breeze on Windows
 /breeze.exe
+
+# Generated out dir
+
+/out

BREEZE.rst

@@ -435,6 +435,17 @@ of help of the commands only when they change.
   :width: 100%
   :alt: Breeze command-hash-export
 
+Regenerating images for documentation
+=====================================
+
+This documentation contains exported images with "help" of their commands and parameters. You can
+regenerate all those images (which might be needed in case new version of rich is used) via
+``regenerate-breeze-images`` command.
+
+.. image:: ./images/breeze/output-regenerate-command-images.svg
+  :width: 100%
+  :alt: Breeze regenerate-command-images
+
 
 Starting complete Airflow installation
 ======================================

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

@@ -62,7 +62,7 @@
 )
 from airflow_breeze.utils.recording import output_file_for_recording
 from airflow_breeze.utils.reinstall import ask_to_reinstall_breeze, reinstall_breeze, warn_non_editable
-from airflow_breeze.utils.run_utils import run_command
+from airflow_breeze.utils.run_utils import assert_pre_commit_installed, run_command
 from airflow_breeze.utils.visuals import ASCIIART, ASCIIART_STYLE
 
 CONFIGURATION_AND_MAINTENANCE_COMMANDS = {
@@ -75,6 +75,7 @@
         "resource-check",
         "free-space",
         "fix-ownership",
+        "regenerate-command-images",
         "command-hash-export",
         "version",
     ],
@@ -533,3 +534,27 @@ def remove_autogenerated_code(script_path: str):
 
 def backup(script_path_file: Path):
     shutil.copy(str(script_path_file), str(script_path_file) + ".bak")
+
+
+@main.command(name="regenerate-command-images", help="Regenerate breeze command images.")
+@option_verbose
+@option_dry_run
+def regenerate_command_images(verbose: bool, dry_run: bool):
+    assert_pre_commit_installed(verbose=verbose)
+    perform_environment_checks(verbose=verbose)
+    try:
+        (AIRFLOW_SOURCES_ROOT / "images" / "breeze" / "output-commands-hash.txt").unlink()
+    except FileNotFoundError:
+        # when we go to Python 3.8+ we can add missing_ok = True instead of try/except
+        pass
+    command_to_execute = [sys.executable, "-m", "pre_commit", 'run', 'update-breeze-file', '--all-files']
+    env = os.environ.copy()
+    run_command(
+        command_to_execute,
+        verbose=verbose,
+        dry_run=dry_run,
+        check=False,
+        no_output_dump_on_exception=True,
+        text=True,
+        env=env,
+    )

images/breeze/output-commands-hash.txt

@@ -1 +1 @@
-5f6d42eb170dba8f19b375f8e7c588b3
+4741c257cb7cb98fd268d443cfa12135