UW-269 Extend set_config.py tool to "export" variables

src/uwtools/config.py

@@ -21,6 +21,7 @@
 import yaml
 
 from uwtools import exceptions, logger
+from uwtools.exceptions import UWConfigError
 from uwtools.j2template import J2Template
 from uwtools.logger import Logger
 from uwtools.utils import cli_helpers
@@ -752,3 +753,22 @@ def create_config_obj(
                     raise ValueError(err_msg)
                 # Dump to file:
                 dump_method(path=outfile, cfg=config_obj)
+
+
+def print_config_section(config: dict, section_path: List[str], log: Logger) -> None:
+    """
+    Descends into the config via the given section keys, then prints the contents of the located
+    subtree as key=value pairs, one per line.
+    """
+    for key in section_path:
+        if isinstance(config[key], dict):
+            config = config[key]
+        else:
+            log.error(f"{key} type must be a dictionary")
+            raise UWConfigError("Key type must be a dictionary")
+    for key, value in config.items():
+        if type(value) not in (bool, float, int, str):
+            log.error(f"Non-scalar value {key} was provided")
+            raise UWConfigError("Section values provided must be scalar values")
+    for key, value in config.items():
+        print(f"{key}={value}")

src/uwtools/tests/test_config.py

@@ -22,6 +22,7 @@
 
 from uwtools import config, exceptions
 from uwtools.exceptions import UWConfigError
+from uwtools.logger import Logger
 from uwtools.tests.support import compare_files, fixture_path, line_in_lines, msg_in_caplog
 from uwtools.utils import cli_helpers
 
@@ -810,3 +811,46 @@ def test_YAMLConfig__load_unexpected_error(tmp_path):
         with raises(UWConfigError) as e:
             config.YAMLConfig(config_path=cfgfile)
         assert msg in str(e.value)
+
+
+def test_print_config_section_yaml(capsys):
+    config_obj = config.YAMLConfig(fixture_path("FV3_GFS_v16.yaml"))
+    section = ["sgs_tke", "profile_type"]
+    config.print_config_section(config_obj.data, section, log=Logger())
+    actual = capsys.readouterr().out
+    expected = """name=fixed
+surface_value=0.0\n"""
+    assert actual == expected
+
+
+def test_print_config_section_yaml_for_nonscalar():
+    config_obj = config.YAMLConfig(fixture_path("FV3_GFS_v16.yaml"))
+    section = ["o3mr"]
+    with raises(UWConfigError):
+        config.print_config_section(config_obj.data, section, log=Logger())
+
+
+def test_print_config_section_yaml_not_dict():
+    config_obj = config.YAMLConfig(fixture_path("FV3_GFS_v16.yaml"))
+    section = ["sgs_tke", "units"]
+    with raises(UWConfigError):
+        config.print_config_section(config_obj.data, section, log=Logger())
+
+
+def test_print_config_section_ini(capsys):
+    config_obj = config.INIConfig(fixture_path("simple3.ini"))
+    section = ["dessert"]
+    config.print_config_section(config_obj.data, section, log=Logger())
+    actual = capsys.readouterr().out
+    expected = """type=pie
+flavor={{flavor}}
+side=False
+servings=0\n"""
+    assert actual == expected
+
+
+def test_print_config_section_ini_missing_section():
+    config_obj = config.INIConfig(fixture_path("simple3.ini"))
+    section = ["sandwich"]
+    with raises(KeyError):
+        config.print_config_section(config_obj.data, section, log=Logger())