5th debug level added. documentation and tests adjusted.

Author: juliusroeder

cotainr/cli.py

@@ -190,8 +190,8 @@ def add_arguments(cls, *, parser):
             help=(
                 "increase the verbosity of the output from cotainr. "
                 "Can be used multiple times: Once for subprocess output, "
-                "twice for subprocess INFO, three times for DEBUG, "
-                "and four times for TRACE"
+                "twice for subprocess INFO, three times for VERBOSE, four times for DEBUG "
+                "and five times for TRACE."
             ),
         )
         verbose_quiet_group.add_argument(

cotainr/pack.py

@@ -402,10 +402,10 @@ def _conda_verbosity_arg(self):
         elif self._verbosity == 2:
             # Conda INFO
             return " -v"
-        elif self._verbosity == 3:
+        elif self._verbosity == 3 or self._verbosity == 4:
             # Conda DEBUG
             return " -vv"
-        elif self._verbosity >= 4:
+        elif self._verbosity >= 5:
             # Conda TRACE
             return " -vvv"
         else:

cotainr/tests/cli/test_build.py

@@ -475,8 +475,8 @@ def test_CLI_subcommand_help_message(self, argparse_options_line, capsys):
             "                        completing the container build process\n"
             "  --verbose, -v         increase the verbosity of the output from cotainr. Can\n"
             "                        be used multiple times: Once for subprocess output,\n"
-            "                        twice for subprocess INFO, three times for DEBUG, and\n"
-            "                        four times for TRACE\n"
+            "                        twice for subprocess INFO, three times for VERBOSE,\n"
+            "                        four times for DEBUG and five times for TRACE.\n"
             "  --quiet, -q           do not show any non-CRITICAL output from cotainr\n"
             "  --log-to-file         create files containing all logging information shown\n"
             "                        on stdout/stderr\n"

cotainr/tests/container/test_singularity_sandbox.py

@@ -364,7 +364,16 @@ def test_use_own_log_dispatcher(self, capsys, patch_disable_stream_subprocess):
 class Test_AddVerbosityArg:
     @pytest.mark.parametrize(
         ["verbosity", "verbosity_arg"],
-        [(-1, "-s"), (0, "-q"), (1, None), (2, None), (3, "-v"), (4, "-d"), (5, "-d")],
+        [
+            (-1, "-s"),
+            (0, "-q"),
+            (1, None),
+            (2, None),
+            (3, "-v"),
+            (4, "-d"),
+            (5, "-d"),
+            (6, "-d"),
+        ],
     )
     def test_correct_mapping_of_verbosity(self, verbosity, verbosity_arg):
         sandbox = SingularitySandbox(base_image="my_base_image_6021")

cotainr/tests/pack/test_conda_install.py

@@ -516,7 +516,15 @@ def test_unknown_arch_error(self, arch):
 class Test_CondaVerbosityArg:
     @pytest.mark.parametrize(
         ["verbosity", "verbosity_arg"],
-        [(-1, " -q"), (0, " -q"), (1, ""), (2, " -v"), (3, " -vv"), (4, " -vvv")],
+        [
+            (-1, " -q"),
+            (0, " -q"),
+            (1, ""),
+            (2, " -v"),
+            (3, " -vv"),
+            (4, " -vv"),
+            (5, " -vvv"),
+        ],
     )
     def test_correct_mapping_of_verbosity(
         self,

doc/development/tracing_logging.rst

@@ -78,7 +78,8 @@ Within `cotainr`, we map the subcommand `--verbose` / `--quiet` flags to a `verb
 -v                   1                      INFO                  INFO                         <None>                   <None>
 -vv                  2                      DEBUG                 INFO                         <None>                   -v
 -vvv                 3                      DEBUG                 DEBUG                        -v                       -vv
--vvvv                4                      DEBUG                 DEBUG                        -d                       -vvv
+-vvvv                4                      DEBUG                 DEBUG                        -d                       -vv
+-vvvvv               5                      DEBUG                 DEBUG                        -d                       -vvv
 ===================  =====================  ====================  ===========================  =======================  =================
 
 The subcommand `--verbose` / `--quiet` flags are mapped to a `verbosity` level as part of the parsing of the CLI arguments, e.g. as in :class:`cotainr.CLI.build.add_arguments`. Based on the `verbosity` level,