add support for 'config --list-paths'

added config command to list all config files and dropin files which are
currently considered by west.

Author: thorsten-klein

src/west/app/config.py

@@ -7,7 +7,7 @@
 import argparse
 
 from west.commands import CommandError, WestCommand
-from west.configuration import ConfigFile
+from west.configuration import ConfigFile, Configuration
 
 CONFIG_DESCRIPTION = '''\
 West configuration file handling.
@@ -81,6 +81,14 @@
 
 To delete <name> everywhere it's set, including the system file:
     west config -D <name>
+
+To list the configuration files that are loaded (both the main config file
+and all drop-ins) in the exact order they were applied (where later values
+override earlier ones):
+    west config --list-paths
+    west config --local --list-paths
+    west config --global --list-paths
+    west config --system --list-paths
 '''
 
 CONFIG_EPILOG = '''\
@@ -113,10 +121,16 @@ def do_add_parser(self, parser_adder):
         ).add_mutually_exclusive_group()
 
         group.add_argument(
-            '-p',
             '--print-path',
             action='store_true',
-            help='print file path from according west config(--system, --global, --local)',
+            help='print the file path from according west '
+            'config (--local [default], --global, --system)',
+        )
+        group.add_argument(
+            '--list-paths',
+            action='store_true',
+            help='list all config files and dropin files that '
+            'are currently considered by west config',
         )
         group.add_argument(
             '-l', '--list', action='store_true', help='list all options and their values'
@@ -172,14 +186,16 @@ def do_run(self, args, user_args):
         if args.list:
             if args.name:
                 self.parser.error('-l cannot be combined with name argument')
-        elif not args.name and not args.print_path:
+        elif not any([args.name, args.print_path, args.list_paths]):
             self.parser.error('missing argument name (to list all options and values, use -l)')
         elif args.append:
             if args.value is None:
                 self.parser.error('-a requires both name and value')
 
         if args.print_path:
             self.print_path(args)
+        elif args.list_paths:
+            self.list_paths(args)
         elif args.list:
             self.list(args)
         elif delete:
@@ -196,6 +212,11 @@ def print_path(self, args):
         if config_path:
             print(config_path)
 
+    def list_paths(self, args):
+        config_paths = Configuration().get_paths(args.configfile or ALL)
+        for config_path in config_paths:
+            print(config_path)
+
     def list(self, args):
         what = args.configfile or ALL
         for option, value in self.config.items(configfile=what):

src/west/configuration.py

@@ -193,6 +193,16 @@ def get_path(self, configfile: ConfigFile = ConfigFile.LOCAL):
         elif configfile == ConfigFile.GLOBAL:
             return self._global_path
 
+    def get_paths(self, configfile: ConfigFile = ConfigFile.ALL):
+        ret = []
+        if self._global and configfile in [ConfigFile.GLOBAL, ConfigFile.ALL]:
+            ret += self._global._paths()
+        if self._system and configfile in [ConfigFile.SYSTEM, ConfigFile.ALL]:
+            ret += self._system._paths()
+        if self._local and configfile in [ConfigFile.LOCAL, ConfigFile.ALL]:
+            ret += self._local._paths()
+        return ret
+
     def get(
         self, option: str, default: str | None = None, configfile: ConfigFile = ConfigFile.ALL
     ) -> str | None:

tests/test_config.py

@@ -136,6 +136,86 @@ def test_config_print_path():
     cmd('config --system --print-path')
 
 
+TEST_CASES_CONFIG_LIST_PATHS = [
+    # (flag, env_var)
+    ('--local', 'WEST_CONFIG_LOCAL'),
+    ('--system', 'WEST_CONFIG_SYSTEM'),
+    ('--global', 'WEST_CONFIG_GLOBAL'),
+]
+
+
+@pytest.mark.parametrize("test_case", TEST_CASES_CONFIG_LIST_PATHS)
+def test_config_list_paths(test_case):
+    flag, env_var = test_case
+
+    # no config is listed (since it does not exist)
+    stdout = cmd(f'config {flag} --list-paths')
+    assert '' == stdout.rstrip()
+
+    # create the config
+    cmd(f'config {flag} pytest.key val')
+
+    # check that the config is listed now
+    stdout = cmd(f'config {flag} --list-paths')
+    config_path = pathlib.Path(os.environ[env_var])
+    assert f'{config_path}' == stdout.rstrip()
+
+
+def test_config_list_paths_extended():
+    WEST_CONFIG_LOCAL = os.environ['WEST_CONFIG_LOCAL']
+    WEST_CONFIG_GLOBAL = os.environ['WEST_CONFIG_GLOBAL']
+    WEST_CONFIG_SYSTEM = os.environ['WEST_CONFIG_SYSTEM']
+
+    # create the configs
+    cmd('config --local pytest.key val')
+    cmd('config --global pytest.key val')
+    cmd('config --system pytest.key val')
+
+    # list the configs
+    stdout = cmd('config --list-paths')
+    assert (
+        stdout.splitlines()
+        == textwrap.dedent(f'''\
+        {WEST_CONFIG_GLOBAL}
+        {WEST_CONFIG_SYSTEM}
+        {WEST_CONFIG_LOCAL}
+        ''').splitlines()
+    )
+
+    # create some dropins files
+    dropin_files = [
+        pathlib.Path(WEST_CONFIG_GLOBAL + '.d') / 'a.conf',
+        pathlib.Path(WEST_CONFIG_GLOBAL + '.d') / 'z.conf',
+        pathlib.Path(WEST_CONFIG_SYSTEM + '.d') / 'a.conf',
+        pathlib.Path(WEST_CONFIG_SYSTEM + '.d') / 'z.conf',
+        pathlib.Path(WEST_CONFIG_LOCAL + '.d') / 'a.conf',
+        pathlib.Path(WEST_CONFIG_LOCAL + '.d') / 'z.conf',
+    ]
+    for dropin_file in dropin_files:
+        dropin_file.parent.mkdir(exist_ok=True)
+        dropin_file.touch()
+
+    # list the configs
+    stdout = cmd('config --list-paths')
+    assert (
+        stdout.splitlines()
+        == textwrap.dedent(f'''\
+        {dropin_files[0]}
+        {dropin_files[1]}
+        {WEST_CONFIG_GLOBAL}
+        {dropin_files[2]}
+        {dropin_files[3]}
+        {WEST_CONFIG_SYSTEM}
+        {dropin_files[4]}
+        {dropin_files[5]}
+        {WEST_CONFIG_LOCAL}
+        ''').splitlines()
+    )
+
+    # print nothing if local config does not exist (exit code 0)
+    del os.environ['WEST_CONFIG_LOCAL']
+
+
 def test_config_local():
     # test_config_system for local variables.
     cmd('config --local pytest.local foo')