kaqing 2.0.14__py3-none-any.whl → 2.0.189__py3-none-any.whl

adam/utils.py

@@ -1,3 +1,4 @@
+from concurrent.futures import Future, ThreadPoolExecutor
 from contextlib import redirect_stdout
 import copy
 import csv
@@ -9,7 +10,9 @@ import os
 from pathlib import Path
 import random
 import string
-from typing import cast
+import threading
+import traceback
+from typing import Callable, Iterator, TypeVar, Union
 from dateutil import parser
 import subprocess
 import sys
@@ -17,12 +20,33 @@ import time
 import click
 import yaml
 
+from prompt_toolkit.completion import Completer
+
 from . import __version__
 
-def to_tabular(lines: str, header: str = None, dashed_line = False):
-    return lines_to_tabular(lines.split('\n'), header, dashed_line)
+T = TypeVar('T')
+
+log_state = threading.local()
+
+class LogConfig:
+    is_debug = lambda: False
+    is_debug_timing = lambda: False
+    is_debug_complete = lambda: False
+    is_display_help = True
+
+NO_SORT = 0
+SORT = 1
+REVERSE_SORT = -1
+
+def tabulize(lines: list[T], fn: Callable[..., T] = None, header: str = None, dashed_line = False, separator = ' ', to: int = 1, sorted: int = NO_SORT):
+    if fn:
+        lines = list(map(fn, lines))
+
+    if sorted == SORT:
+        lines.sort()
+    elif sorted == REVERSE_SORT:
+        lines.sort(reverse=True)
 
-def lines_to_tabular(lines: list[str], header: str = None, dashed_line = False, separator = ' '):
     maxes = []
     nls = []
 
@@ -53,7 +77,14 @@ def lines_to_tabular(lines: list[str], header: str = None, dashed_line = False,
     for line in lines:
         format_line(line)
 
-    return '\n'.join(nls)
+    table = '\n'.join(nls)
+
+    if to == 1:
+        log(table)
+    elif to == 2:
+        log2(table)
+
+    return table
 
 def convert_seconds(total_seconds_float):
     total_seconds_int = int(total_seconds_float)  # Convert float to integer seconds
@@ -70,18 +101,28 @@ def epoch(timestamp_string: str):
     return parser.parse(timestamp_string).timestamp()
 
 def log(s = None):
+    if not loggable():
+        return False
+
     # want to print empty line for False or empty collection
     if s == None:
         print()
     else:
         click.echo(s)
 
+    return True
+
 def log2(s = None, nl = True):
+    if not loggable():
+        return False
+
     if s:
         click.echo(s, err=True, nl=nl)
     else:
         print(file=sys.stderr)
 
+    return True
+
 def elapsed_time(start_time: float):
     end_time = time.time()
     elapsed_time = end_time - start_time
@@ -96,7 +137,7 @@ def duration(start_time: float, end_time: float = None):
         end_time = time.time()
     d = convert_seconds(end_time - start_time)
     t = []
-    if d[0]:
+    if d:
         t.append(f'{d[0]}h')
     if t or d[1]:
         t.append(f'{d[1]}m')
@@ -122,9 +163,25 @@ def deep_merge_dicts(dict1, dict2):
             merged_dict[key] = deep_merge_dicts(merged_dict[key], value)
         elif key not in merged_dict or value:
             # Otherwise, overwrite or add the value from dict2
-            merged_dict[key] = value
+            if key in merged_dict and isinstance(merged_dict[key], Completer):
+                print('SEAN completer found, ignoring', key, value)
+            else:
+                merged_dict[key] = value
     return merged_dict
 
+def deep_sort_dict(d):
+    """
+    Recursively sorts a dictionary by its keys, and any nested lists by their elements.
+    """
+    if not isinstance(d, (dict, list)):
+        return d
+
+    if isinstance(d, dict):
+        return {k: deep_sort_dict(d[k]) for k in sorted(d)}
+
+    if isinstance(d, list):
+        return sorted([deep_sort_dict(item) for item in d])
+
 def get_deep_keys(d, current_path=""):
     """
     Recursively collects all combined keys (paths) from a deep dictionary.
@@ -147,6 +204,9 @@ def get_deep_keys(d, current_path=""):
     return keys
 
 def display_help(replace_arg = False):
+    if not LogConfig.is_display_help:
+        return
+
     args = copy.copy(sys.argv)
     if replace_arg:
         args[len(args) - 1] = '--help'
@@ -191,12 +251,13 @@ def json_to_csv(json_data: list[dict[any, any]], delimiter: str = ','):
         with redirect_stdout(body) as f:
             dict_writer = csv.DictWriter(f, keys, delimiter=delimiter)
             dict_writer.writerows(flattened_data)
+
         return header.getvalue().strip('\r\n'), [l.strip('\r') for l in body.getvalue().split('\n')]
     else:
         return None
 
 def log_to_file(config: dict[any, any]):
-    try:
+    with log_exc():
         base = f"/kaqing/logs"
         os.makedirs(base, exist_ok=True)
 
@@ -211,8 +272,6 @@ def log_to_file(config: dict[any, any]):
                     f.write(config)
             else:
                     f.write(config)
-    except:
-        pass
 
 def copy_config_file(rel_path: str, module: str, suffix: str = '.yaml', show_out = True):
     dir = f'{Path.home()}/.kaqing'
@@ -228,4 +287,473 @@ def copy_config_file(rel_path: str, module: str, suffix: str = '.yaml', show_out
     return path
 
 def idp_token_from_env():
-    return os.getenv('IDP_TOKEN')
+    return os.getenv('IDP_TOKEN')
+
+def is_lambda(func):
+    return callable(func) and hasattr(func, '__name__') and func.__name__ == '<lambda>'
+
+def debug(s = None):
+    if LogConfig.is_debug():
+        log2(f'DEBUG {s}')
+
+def debug_complete(s = None):
+    if LogConfig.is_debug_complete():
+        log2(f'DEBUG {s}')
+
+def debug_trace():
+    if LogConfig.is_debug():
+        log2(traceback.format_exc())
+
+def in_docker() -> bool:
+    if os.path.exists('/.dockerenv'):
+        return True
+
+    try:
+        with open('/proc/1/cgroup', 'rt') as f:
+            for line in f:
+                if 'docker' in line or 'lxc' in line:
+                    return True
+    except FileNotFoundError:
+        pass
+
+    return False
+
+class Ing:
+    def __init__(self, msg: str, suppress_log=False):
+        self.msg = msg
+        self.suppress_log = suppress_log
+
+    def __enter__(self):
+        if not hasattr(log_state, 'ing_cnt'):
+            log_state.ing_cnt = 0
+
+        try:
+            if not log_state.ing_cnt:
+                if not self.suppress_log and not LogConfig.is_debug():
+                    log2(f'{self.msg}...', nl=False)
+
+            return None
+        finally:
+            log_state.ing_cnt += 1
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        log_state.ing_cnt -= 1
+        if not log_state.ing_cnt:
+            if not self.suppress_log and not LogConfig.is_debug():
+                log2(' OK')
+
+        return False
+
+def ing(msg: str, body: Callable[[], None]=None, suppress_log=False):
+    if not body:
+        return Ing(msg, suppress_log=suppress_log)
+
+    r = None
+
+    t = Ing(msg, suppress_log=suppress_log)
+    t.__enter__()
+    try:
+        r = body()
+    finally:
+        t.__exit__(None, None, None)
+
+    return r
+
+def loggable():
+    return LogConfig.is_debug() or not hasattr(log_state, 'ing_cnt') or not log_state.ing_cnt
+
+class TimingNode:
+    def __init__(self, depth: int, s0: time.time = time.time(), line: str = None):
+        self.depth = depth
+        self.s0 = s0
+        self.line = line
+        self.children = []
+
+    def __str__(self):
+        return f'[{self.depth}: {self.line}, children={len(self.children)}]'
+
+    def tree(self):
+        lines = []
+        if self.line:
+            lines.append(self.line)
+
+        for child in self.children:
+            if child.line:
+                lines.append(child.tree())
+        return '\n'.join(lines)
+
+class LogTiming:
+    def __init__(self, msg: str, s0: time.time = None):
+        self.msg = msg
+        self.s0 = s0
+
+    def __enter__(self):
+        if not LogConfig.is_debug_timing():
+            return
+
+        if not hasattr(log_state, 'timings'):
+            log_state.timings = TimingNode(0)
+
+        self.me = log_state.timings
+        log_state.timings = TimingNode(self.me.depth+1)
+        if not self.s0:
+            self.s0 = time.time()
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        if not LogConfig.is_debug_timing():
+            return False
+
+        child = log_state.timings
+        log_state.timings.line = timing_log_line(self.me.depth, self.msg, self.s0)
+
+        if child and child.line:
+            self.me.children.append(child)
+        log_state.timings = self.me
+
+        if not self.me.depth:
+            log2(self.me.tree())
+            log_state.timings = TimingNode(0)
+
+        return False
+
+def log_timing(msg: str, body: Callable[[], None]=None, s0: time.time = None):
+    if not s0 and not body:
+        return LogTiming(msg, s0=s0)
+
+    if not LogConfig.is_debug_timing():
+        if body:
+            return body()
+
+        return
+
+    r = None
+
+    t = LogTiming(msg, s0=s0)
+    t.__enter__()
+    try:
+        if body:
+            r = body()
+    finally:
+        t.__exit__(None, None, None)
+
+    return r
+
+def timing_log_line(depth: int, msg: str, s0: time.time):
+    # print('SEAN log timing', msg, threading.current_thread().name)
+    elapsed = time.time() - s0
+    offloaded = '-' if threading.current_thread().name.startswith('offload') or threading.current_thread().name.startswith('async') else '+'
+    prefix = f'[{offloaded} timings] '
+
+    if depth:
+        if elapsed > 0.01:
+            prefix = ('  ' * (depth-1)) + '* '
+        else:
+            prefix = '  ' * depth
+
+    return f'{prefix}{msg}: {elapsed:.2f} sec'
+
+class WaitLog:
+    wait_log_flag = False
+
+def wait_log(msg: str):
+    if not WaitLog.wait_log_flag:
+        log2(msg)
+        WaitLog.wait_log_flag = True
+
+def clear_wait_log_flag():
+    WaitLog.wait_log_flag = False
+
+def bytes_generator_from_file(file_path, chunk_size=4096):
+    with open(file_path, 'rb') as f:
+        while True:
+            chunk = f.read(chunk_size)
+            if not chunk:
+                break
+            yield chunk
+
+class GeneratorStream(io.RawIOBase):
+    def __init__(self, generator):
+        self._generator = generator
+        self._buffer = b''  # Buffer to store leftover bytes from generator yields
+
+    def readable(self):
+        return True
+
+    def _read_from_generator(self):
+        try:
+            chunk = next(self._generator)
+            if isinstance(chunk, str):
+                chunk = chunk.encode('utf-8')  # Encode if generator yields strings
+            self._buffer += chunk
+        except StopIteration:
+            pass  # Generator exhausted
+
+    def readinto(self, b):
+        # Fill the buffer if necessary
+        while len(self._buffer) < len(b):
+            old_buffer_len = len(self._buffer)
+            self._read_from_generator()
+            if len(self._buffer) == old_buffer_len:  # Generator exhausted and buffer empty
+                break
+
+        bytes_to_read = min(len(b), len(self._buffer))
+        b[:bytes_to_read] = self._buffer[:bytes_to_read]
+        self._buffer = self._buffer[bytes_to_read:]
+        return bytes_to_read
+
+    def read(self, size=-1):
+        if size == -1:  # Read all remaining data
+            while True:
+                old_buffer_len = len(self._buffer)
+                self._read_from_generator()
+                if len(self._buffer) == old_buffer_len:
+                    break
+            data = self._buffer
+            self._buffer = b''
+            return data
+        else:
+            # Ensure enough data in buffer
+            while len(self._buffer) < size:
+                old_buffer_len = len(self._buffer)
+                self._read_from_generator()
+                if len(self._buffer) == old_buffer_len:
+                    break
+
+            data = self._buffer[:size]
+            self._buffer = self._buffer[size:]
+            return data
+
+class LogTrace:
+    def __init__(self, err_msg: Union[str, callable, bool] = None):
+        self.err_msg = err_msg
+
+    def __enter__(self):
+        return None
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        if exc_type is not None:
+            if self.err_msg is True:
+                log2(str(exc_val))
+            elif callable(self.err_msg):
+                log2(self.err_msg(exc_val))
+            elif self.err_msg is not False and self.err_msg:
+                log2(self.err_msg)
+
+            if self.err_msg is not False and LogConfig.is_debug():
+                traceback.print_exception(exc_type, exc_val, exc_tb, file=sys.stderr)
+
+        # swallow exception
+        return True
+
+def log_exc(err_msg: Union[str, callable, bool] = None):
+    return LogTrace(err_msg=err_msg)
+
+class ParallelService:
+    def __init__(self, handler: 'ParallelMapHandler'):
+        self.handler = handler
+
+    def map(self, fn: Callable[..., T]) -> Iterator[T]:
+        executor = self.handler.executor
+        collection = self.handler.collection
+        collect = self.handler.collect
+        samples_cnt = self.handler.samples
+
+        iterator = None
+        if executor:
+            iterator = executor.map(fn, collection)
+        elif samples_cnt < sys.maxsize:
+            samples = []
+
+            for elem in collection:
+                if not samples_cnt:
+                    break
+
+                samples.append(fn(elem))
+                samples_cnt -= 1
+
+            iterator = iter(samples)
+        else:
+            iterator = map(fn, collection)
+
+        if collect:
+            return list(iterator)
+        else:
+            return iterator
+
+class ParallelMapHandler:
+    def __init__(self, collection: list, workers: int, samples: int = sys.maxsize, msg: str = None, collect = True):
+        self.collection = collection
+        self.workers = workers
+        self.executor = None
+        self.samples = samples
+        self.msg = msg
+        if msg and msg.startswith('d`'):
+            if LogConfig.is_debug():
+                self.msg = msg.replace('d`', '', 1)
+            else:
+                self.msg = None
+        self.collect = collect
+
+        self.begin = []
+        self.end = []
+        self.start_time = None
+
+    def __enter__(self):
+        self.calc_msgs()
+
+        if self.workers > 1 and (not self.size() or self.size()) and self.samples == sys.maxsize:
+            self.start_time = time.time()
+
+            self.executor = ThreadPoolExecutor(max_workers=self.workers)
+            self.executor.__enter__()
+
+        return ParallelService(self)
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        if self.executor:
+            self.executor.__exit__(exc_type, exc_val, exc_tb)
+
+        if self.end:
+            log2(f'{" ".join(self.end)} in {elapsed_time(self.start_time)}.')
+
+        return False
+
+    def size(self):
+        if not self.collection:
+            return 0
+
+        return len(self.collection)
+
+    def calc_msgs(self):
+        if not self.msg:
+            return
+
+        size = self.size()
+        offloaded = False
+        serially = False
+        sampling = False
+        if size == 0:
+            offloaded = True
+            self.msg = self.msg.replace('{size}', '1')
+        elif self.workers > 1 and size > 1 and self.samples == sys.maxsize:
+            self.msg = self.msg.replace('{size}', f'{size}')
+        elif self.samples < sys.maxsize:
+            sampling = True
+            if self.samples > size:
+                self.samples = size
+            self.msg = self.msg.replace('{size}', f'{self.samples}/{size} sample')
+        else:
+            serially = True
+            self.msg = self.msg.replace('{size}', f'{size}')
+
+        for token in self.msg.split(' '):
+            if '|' in token:
+                self.begin.append(token.split('|')[0])
+                if not sampling and not serially and not offloaded:
+                    self.end.append(token.split('|')[1])
+            else:
+                self.begin.append(token)
+                if not sampling and not serially and not offloaded:
+                    self.end.append(token)
+
+        if offloaded:
+            log2(f'{" ".join(self.begin)} offloaded...')
+        elif sampling or serially:
+            log2(f'{" ".join(self.begin)} serially...')
+        else:
+            log2(f'{" ".join(self.begin)} with {self.workers} workers...')
+
+def parallelize(collection: list, workers: int = 0, samples = sys.maxsize, msg: str = None, collect = True):
+    return ParallelMapHandler(collection, workers, samples = samples, msg = msg, collect = collect)
+
+class OffloadService:
+    def __init__(self, handler: 'OffloadHandler'):
+        self.handler = handler
+
+    def submit(self, fn: Callable[..., T], /, *args, **kwargs) -> Future[T]:
+        executor = self.handler.executor
+
+        if executor:
+            return executor.submit(fn, *args, **kwargs)
+        else:
+            future = Future()
+
+            future.set_result(fn(*args, **kwargs))
+
+            return future
+
+class OffloadHandler(ParallelMapHandler):
+    def __init__(self, max_workers: int, msg: str = None):
+        super().__init__(None, max_workers, msg=msg, collect=False )
+
+    def __enter__(self):
+        self.calc_msgs()
+
+        if self.workers > 1:
+        # if self.workers > 1 and (not self.size() or self.size()) and self.samples == sys.maxsize:
+            self.start_time = time.time()
+
+            self.executor = ThreadPoolExecutor(max_workers=self.workers, thread_name_prefix='offload')
+            self.executor.__enter__()
+
+        return OffloadService(self)
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        if self.executor:
+            self.executor.__exit__(exc_type, exc_val, exc_tb)
+
+        if self.end:
+            log2(f'{" ".join(self.end)} in {elapsed_time(self.start_time)}.')
+
+        return False
+
+    # def size(self):
+    #     if not self.collection:
+    #         return 0
+
+    #     return len(self.collection)
+
+    def calc_msgs(self):
+        if not self.msg:
+            return
+
+        size = self.size()
+            # return
+
+        offloaded = False
+        serially = False
+        sampling = False
+        if size == 0:
+            offloaded = True
+            self.msg = self.msg.replace('{size}', '1')
+        elif self.workers > 1 and size > 1 and self.samples == sys.maxsize:
+            self.msg = self.msg.replace('{size}', f'{size}')
+        elif self.samples < sys.maxsize:
+            sampling = True
+            if self.samples > size:
+                self.samples = size
+            self.msg = self.msg.replace('{size}', f'{self.samples}/{size} sample')
+        else:
+            serially = True
+            self.msg = self.msg.replace('{size}', f'{size}')
+            # return
+
+        for token in self.msg.split(' '):
+            if '|' in token:
+                self.begin.append(token.split('|')[0])
+                if not sampling and not serially and not offloaded:
+                    self.end.append(token.split('|')[1])
+            else:
+                self.begin.append(token)
+                if not sampling and not serially and not offloaded:
+                    self.end.append(token)
+
+        if offloaded:
+            log2(f'{" ".join(self.begin)} offloaded...')
+        elif sampling or serially:
+            log2(f'{" ".join(self.begin)} serially...')
+        else:
+            log2(f'{" ".join(self.begin)} with {self.workers} workers...')
+
+def offload(max_workers: int = 3, msg: str = None):
+    return OffloadHandler(max_workers, msg = msg)