Settings: Add settings comparison utility

CHANGES.md

@@ -1,6 +1,7 @@
 # Changelog
 
 ## Unreleased
+- Settings: Added settings comparison utility. Thanks, @WalBeh.
 
 ## 2025/04/23 v0.0.32
 - MCP: Add subsystem providing a few server and client utilities through

cratedb_toolkit/cli.py

@@ -12,6 +12,7 @@
 from .io.cli import cli as io_cli
 from .job.cli import cli_list_jobs
 from .query.cli import cli as query_cli
+from .settings.cli import cli as settings_cli
 from .shell.cli import cli as shell_cli
 
 
@@ -32,5 +33,6 @@ def cli(ctx: click.Context, verbose: bool, debug: bool):
 cli.add_command(query_cli, name="query")
 cli.add_command(rockset_cli, name="rockset")
 cli.add_command(shell_cli, name="shell")
+cli.add_command(settings_cli, name="settings")
 cli.add_command(tail_cli, name="tail")
 cli.add_command(cli_list_jobs)

cratedb_toolkit/docs/cli.py

@@ -39,7 +39,7 @@ def help_functions():
 
 def help_settings():
     """
-    Extract CrateDB configuration settings by scraping relevant documentation pages.
+    Scrape CrateDB configuration settings from documentation.
 
     Examples
     ========
@@ -101,7 +101,7 @@ def settings(format_: str, output: str):
 
     Output in JSON, Markdown, or SQL format.
     """
-    from .settings import SettingsExtractor
+    from cratedb_toolkit.docs.settings import SettingsExtractor
 
     try:
         extractor = SettingsExtractor()

cratedb_toolkit/settings/cli.py

@@ -0,0 +1,26 @@
+import logging
+
+import click
+from click_aliases import ClickAliasedGroup
+
+from cratedb_toolkit.docs.cli import settings as docs_settings_cli
+from cratedb_toolkit.util.cli import boot_click
+
+from .compare import compare_cluster_settings
+
+logger = logging.getLogger(__name__)
+
+
+@click.group(cls=ClickAliasedGroup)
+@click.option("--verbose", is_flag=True, required=False, help="Turn on logging")
+@click.option("--debug", is_flag=True, required=False, help="Turn on logging with debug level")
+@click.pass_context
+def cli(ctx: click.Context, verbose: bool, debug: bool):
+    """
+    Tools for working with CrateDB's settings.
+    """
+    return boot_click(ctx, verbose, debug)
+
+
+cli.add_command(compare_cluster_settings, name="compare")
+cli.add_command(docs_settings_cli, name="list")