#!/usr/bin/env python3
-# © Copyright 2021-2022, Scott Gasch
+# © Copyright 2021-2023, Scott Gasch
"""Global program configuration driven by commandline arguments and,
optionally, from saved (local or Zookeeper) configuration files... with
return False
@staticmethod
- def print_usage() -> None:
- """Prints the normal help usage message out."""
- ARGS.print_help()
+ def usage() -> str:
+ """
+ Returns:
+ full program usage help text as a string.
+ """
+ return ARGS.format_help()
@staticmethod
- def usage() -> str:
+ def short_usage() -> str:
"""
Returns:
- program usage help text as a string.
+ program short usage text as a string.
"""
return ARGS.format_usage()
+ @staticmethod
+ def print_usage() -> None:
+ """Prints the full help usage message out."""
+ print(config.usage())
+
+ @staticmethod
+ def print_short_usage() -> None:
+ """Prints a short usage/help message."""
+ print(config.short_usage())
+
@staticmethod
def _reorder_arg_action_groups_before_help(entry_module: Optional[str]):
"""Internal. Used to reorder the arguments before dumping out a
>>> to_bool('on')
True
"""
- return in_str.lower() in ("true", "1", "yes", "y", "t", "on")
+ return in_str.lower() in {"true", "1", "yes", "y", "t", "on"}
- def _process_dynamic_args(self, event):
+ def _process_dynamic_args(self, event) -> None:
"""Invoked as a callback when a zk-based config changed."""
if not self.zk:
# when the user passes -h or --help, it will be visible on the
# screen w/o scrolling. This just makes for a nicer --help screen.
for arg in sys.argv:
- if arg in ("--help", "-h"):
+ if arg in {"--help", "-h"}:
if entry_module is not None:
entry_module = os.path.basename(entry_module)
ARGS._action_groups = Config._reorder_arg_action_groups_before_help(
def late_logging(self):
"""Log messages saved earlier now that logging has been initialized."""
logger = logging.getLogger(__name__)
- logger.debug("Original commandline was: %s", ORIG_ARGV)
+ logger.debug("Invocation commandline: %s", ORIG_ARGV)
for _ in self.saved_messages:
logger.debug(_)
def argv_after_parse() -> Optional[List[str]]:
"""Return the argv with all known arguments removed."""
- if CONFIG.has_been_parsed:
+ if CONFIG.has_been_parsed():
return CONFIG.parsed_argv
return None
Config.print_usage()
+def print_short_usage() -> None:
+ Config.print_short_usage()
+
+
def usage() -> str:
"""
Returns:
program usage help text as a string.
"""
return Config.usage()
+
+
+def short_usage() -> str:
+ """
+ Returns:
+ program short usage help text as a string.
+ """
+ return Config.short_usage()