Added missing lib/env.py + import + log.debug()

Author: adamlui

project-markers/utils/lib/env.py

@@ -0,0 +1,4 @@
+import sys
+
+def is_debug_mode() -> bool:
+    return any(arg in ('--debug', '-V') for arg in sys.argv[1:])

project-markers/utils/lib/log.py

@@ -1,7 +1,10 @@
 import os, sys
 from types import SimpleNamespace as sn
+from typing import Optional
 if sys.platform == 'win32' : import colorama ; colorama.init() # enable ANSI color support
 
+from . import env
+
 try : terminal_width = os.get_terminal_size()[0]
 except OSError : terminal_width = 80
 
@@ -29,6 +32,27 @@ def success(msg: str, *args, **kwargs) -> None : print(f'\n{colors.bg}{msg.forma
 def tip(msg: str, *args, **kwargs) -> None : print(f'\n{colors.bc}TIP: {msg.format(*args, **kwargs)}{colors.nc}')
 def warn(msg: str, *args, **kwargs) -> None : print(f'\n{colors.bo}WARNING: {msg.format(*args, **kwargs)}{colors.nc}')
 
+def debug(msg: str, cli: Optional[sn] = None, *args, **kwargs) -> None:
+    if not env.is_debug_mode() : return
+
+    # Init --debug [target]
+    debug_key=None
+    debug_argidx = sys.argv.index('--debug') if '--debug' in sys.argv else sys.argv.index('-V')
+    if debug_argidx +1 < len(sys.argv) and not sys.argv[debug_argidx +1].startswith('-'):
+        debug_key = sys.argv[debug_argidx +1].replace('-', '_')
+
+    if cli: # init data line
+        if debug_key:
+            data_val = getattr(cli.config, debug_key, f'cli.config key {debug_key!r} {cli.msgs.warn_NOT_FOUND.lower()}')
+        else:
+            data_val = cli.config
+        msg += f'\n{colors.gry}{data_val}{colors.nc}'
+
+    if args: # use 'em
+        msg = msg.format(*args, **kwargs)
+
+    print(f'\n{colors.by}DEBUG: {msg}{colors.nc}')
+
 def trunc(msg: str, end: str = '\n') -> None:
     truncated_lines = [
         line if len(line) < terminal_width else line[:terminal_width -4] + '...' for line in msg.splitlines()]