finish the debugging setup

Author: aignas

python/pip_install/pip_repository.bzl

@@ -584,7 +584,17 @@ python_interpreter. An example value: "@python3_x86_64-unknown-linux-gnu//:pytho
     ),
     "quiet": attr.bool(
         default = True,
-        doc = "If True, suppress printing stdout and stderr output to the terminal.",
+        doc = """\
+If True, suppress printing stdout and stderr output to the terminal.
+
+If you would like to get more diagnostic output, please use:
+
+    RULES_PYTHON_REPO_DEBUG=1
+
+or
+
+    RULES_PYTHON_REPO_DEBUG_VERBOSITY=<INFO|DEBUG|TRACE>
+""",
     ),
     "repo_prefix": attr.string(
         doc = """

python/private/bzlmod/pip.bzl

@@ -555,13 +555,6 @@ The Python version the dependencies are targetting, in Major.Minor format
 If an interpreter isn't explicitly provided (using `python_interpreter` or
 `python_interpreter_target`), then the version specified here must have
 a corresponding `python.toolchain()` configured.
-""",
-        ),
-        "verbosity": attr.string(
-            default = "",
-            values = ["TRACE", "DEBUG", "INFO"],
-            doc = """
-The verbosity with which we should print diagnostic messages when 'quiet = False'.
 """,
         ),
         "whl_modifications": attr.label_keyed_string_dict(

python/private/repo_utils.bzl

@@ -51,13 +51,13 @@ def _logger(rctx):
     Returns:
         A struct with attributes logging: trace, debug, info, warn, fail.
     """
-    debug_value = rctx.os.environ.get(REPO_DEBUG_ENV_VAR)
-    if debug_value == "1":
+    if _is_repo_debug_enabled(rctx):
         verbosity_level = "DEBUG"
     else:
         verbosity_level = "WARN"
 
-    verbosity_level = rctx.os.environ.get(REPO_VERBOSITY_ENV_VAR) or verbosity_level
+    env_var_verbosity = rctx.os.environ.get(REPO_VERBOSITY_ENV_VAR)
+    verbosity_level = env_var_verbosity or verbosity_level
 
     verbosity = {
         "DEBUG": 2,
@@ -69,7 +69,7 @@ def _logger(rctx):
         if verbosity < enabled_on_verbosity:
             return
 
-        print("{}: ".format(level.upper()), message_cb())  # buildifier: disable=print
+        print("\nrules_python: {}: ".format(level.upper()), message_cb())  # buildifier: disable=print
 
     return struct(
         trace = lambda message_cb: _log(3, "TRACE", message_cb),