Rename shortcut to alias

Author: marcleblanc2

src/src_py_lib/utils/logging.py

@@ -104,28 +104,28 @@ class LoggingConfig(Config):
         cli_flag="--verbose",
         cli_aliases=("-v",),
         cli_action="store_true",
-        help="Shortcut for --src-log-level DEBUG",
+        help="Alias for --src-log-level DEBUG",
     )
     quiet: bool = config_field(
         default=False,
         env_var=SRC_LOG_QUIET,
         cli_flag="--quiet",
         cli_aliases=("-q",),
         cli_action="store_true",
-        help="Shortcut for --src-log-level WARNING",
+        help="Alias for --src-log-level WARNING",
     )
     silent: bool = config_field(
         default=False,
         env_var=SRC_LOG_SILENT,
         cli_flag="--silent",
         cli_aliases=("-s",),
         cli_action="store_true",
-        help="Shortcut for --src-log-level ERROR",
+        help="Alias for --src-log-level ERROR",
     )
 
     @model_validator(mode="after")
-    def validate_log_level_shortcuts(self) -> Self:
-        """Require at most one shortcut for the terminal/log-file level."""
+    def validate_log_level_alias(self) -> Self:
+        """Require at most one alias for the terminal/log-file level."""
         if sum((self.verbose, self.quiet, self.silent)) > 1:
             raise ValueError("choose only one of --verbose/-v, --quiet/-q, or --silent/-s")
         return self
@@ -139,9 +139,9 @@ def resolve_log_level_name(
     quiet: bool | None = None,
     silent: bool | None = None,
 ) -> str | None:
-    """Resolve common CLI log-level shortcuts to a level name.
+    """Resolve common CLI log-level alias to a level name.
 
-    Shortcut flags intentionally only map to strings. Explicit log-level
+    Alias flags intentionally only map to strings. Explicit log-level
     values are returned unchanged so `configure_logging()` owns parsing
     and fallback behavior.
     """
@@ -172,7 +172,7 @@ def logging_settings_from_config(
     suppress_http_dependency_logs: bool = True,
     resource_sample_interval_seconds: float | None = None,
 ) -> LoggingSettings:
-    """Return `LoggingSettings` using common CLI log-level shortcuts."""
+    """Return `LoggingSettings` using common CLI log-level alias."""
     explicit_level = resolve_log_level_name(config)
     return LoggingSettings(
         logger_name=logger_name,

tests/test_logging_http_clients.py

@@ -547,7 +547,7 @@ def test_logging_config_mixin_adds_log_level_from_cli_and_env(self) -> None:
         self.assertTrue(cli_config.verbose)
         self.assertEqual(env_config.src_log_level, "ERROR")
 
-    def test_logging_config_rejects_multiple_log_level_shortcuts(self) -> None:
+    def test_logging_config_rejects_multiple_log_level_alias(self) -> None:
         with self.assertRaisesRegex(ConfigError, "choose only one of --verbose"):
             load_config(
                 LoggingExampleConfig,
@@ -556,7 +556,7 @@ def test_logging_config_rejects_multiple_log_level_shortcuts(self) -> None:
                 resolve_op_refs=False,
             )
 
-    def test_resolve_log_level_name_maps_cli_shortcuts(self) -> None:
+    def test_resolve_log_level_name_maps_cli_alias(self) -> None:
         self.assertEqual(resolve_log_level_name(verbose=True), "DEBUG")
         self.assertEqual(resolve_log_level_name(quiet=True), "WARNING")
         self.assertEqual(resolve_log_level_name(silent=True), "ERROR")