[dg] Add option to output html docs to file instead of tmpfile/browser (#27632)

## Summary

I selfishly want this functionality for e2e tests, but I also think
users might find it helpful

Author: benpankow

python_modules/libraries/dagster-dg/dagster_dg/cli/component_type.py

@@ -12,7 +12,7 @@
 from dagster_dg.component_key import GlobalComponentKey
 from dagster_dg.config import normalize_cli_config
 from dagster_dg.context import DgContext
-from dagster_dg.docs import markdown_for_component_type, render_markdown_in_browser
+from dagster_dg.docs import html_from_markdown, markdown_for_component_type, open_html_in_browser
 from dagster_dg.scaffold import scaffold_component_type
 from dagster_dg.utils import (
     DgClickCommand,
@@ -61,11 +61,13 @@ def component_type_scaffold_command(
 
 @component_type_group.command(name="docs", cls=DgClickCommand)
 @click.argument("component_type", type=str)
+@click.option("--output", type=click.Choice(["browser", "cli"]), default="browser")
 @dg_global_options
 @click.pass_context
 def component_type_docs_command(
     context: click.Context,
     component_type: str,
+    output: str,
     **global_options: object,
 ) -> None:
     """Get detailed information on a registered Dagster component type."""
@@ -76,7 +78,11 @@ def component_type_docs_command(
     if not registry.has_global(component_key):
         exit_with_error(f"Component type`{component_type}` not found.")
 
-    render_markdown_in_browser(markdown_for_component_type(registry.get_global(component_key)))
+    markdown = markdown_for_component_type(registry.get_global(component_key))
+    if output == "browser":
+        open_html_in_browser(html_from_markdown(markdown))
+    else:
+        click.echo(html_from_markdown(markdown))
 
 
 # ########################

python_modules/libraries/dagster-dg/dagster_dg/docs.py

@@ -143,7 +143,7 @@ def generate_sample_yaml(component_type: str, json_schema: Mapping[str, Any]) ->
     return "\n".join(commented_lines)
 
 
-def render_markdown_in_browser(markdown_content: str) -> None:
+def html_from_markdown(markdown_content: str) -> str:
     # Convert the markdown string to HTML
     html_content = markdown.markdown(markdown_content)
 
@@ -161,10 +161,13 @@ def render_markdown_in_browser(markdown_content: str) -> None:
     </body>
     </html>
     """
+    return full_html
 
+
+def open_html_in_browser(html_content: str) -> None:
     # Create a temporary file
     with tempfile.NamedTemporaryFile(delete=False, suffix=".html") as temp_file:
-        temp_file.write(full_html.encode("utf-8"))
+        temp_file.write(html_content.encode("utf-8"))
         temp_file_path = temp_file.name
 
     # Open the temporary file in the default web browser
@@ -179,8 +182,8 @@ def markdown_for_component_type(remote_component_type: RemoteComponentType) -> s
     rows = len(sample_yaml.split("\n")) + 1
     return f"""
 ## Component: `{component_type_name}`
- 
-### Description: 
+
+### Description:
 {remote_component_type.description}
 
 ### Sample Component Params:

python_modules/libraries/dagster-dg/dagster_dg_tests/cli_tests/test_component_type_commands.py

@@ -112,6 +112,20 @@ def test_component_type_docs_success():
         assert_runner_result(result)
 
 
+def test_component_type_docs_success_output_console():
+    with ProxyRunner.test() as runner, isolated_components_venv(runner):
+        result = runner.invoke(
+            "component-type",
+            "docs",
+            "complex_schema_asset@dagster_components.test",
+            "--output",
+            "cli",
+        )
+        assert_runner_result(result)
+        assert "<html" in result.output
+        assert "An asset that has a complex params schema." in result.output
+
+
 def test_component_type_docs_with_no_dagster_components_fails() -> None:
     with (
         ProxyRunner.test() as runner,