kaqing 1.77.0__py3-none-any.whl → 2.0.171__py3-none-any.whl

adam/commands/code.py

@@ -0,0 +1,57 @@
+import code
+from functools import partial
+
+from adam.commands.command import Command
+from adam.commands.cql.utils_cql import cassandra_table_names, run_cql
+from adam.repl_state import ReplState, RequiredState
+from adam.utils import lines_to_tabular
+from adam.utils_k8s.statefulsets import StatefulSets
+
+class Code(Command):
+    COMMAND = 'python'
+
+    # the singleton pattern
+    def __new__(cls, *args, **kwargs):
+        if not hasattr(cls, 'instance'): cls.instance = super(Code, cls).__new__(cls)
+
+        return cls.instance
+
+    def __init__(self, successor: Command=None):
+        super().__init__(successor)
+
+    def command(self):
+        return Code.COMMAND
+
+    def required(self):
+        return RequiredState.NAMESPACE
+
+    def run(self, cmd: str, state: ReplState):
+        if not(args := self.args(cmd)):
+            return super().run(cmd, state)
+
+        with self.validate(args, state) as (args, state):
+            sts = state.sts
+            pod = state.pod
+            pods = StatefulSets.pod_names(state.sts, state.namespace)
+            tables = cassandra_table_names(state)
+            cql = partial(run_cql, state, show_out=True)
+
+            my_local = globals() | locals()
+            # my_local = globals() | {'StatefulSets': StatefulSets} | locals()
+            lines = [
+                'sts: StatefulSet name',
+                'pod: Pod name',
+                'pods: Pod names in the current StatefulSet',
+                'tables: Cassandra tables names in the current StatefulSet',
+                "cql('select...'): run cql statement"
+            ]
+
+            code.interact(local=my_local, banner=lines_to_tabular(lines, header='Variables', separator=':'))
+
+            return state
+
+    def completion(self, state: ReplState):
+        return super().completion(state)
+
+    def help(self, _: ReplState):
+        return f'{Code.COMMAND} \t invoke interactive Python shell'

adam/commands/command.py

@@ -0,0 +1,190 @@
+from abc import abstractmethod
+import copy
+import subprocess
+import sys
+from typing import Union
+
+from adam.repl_state import ReplState, RequiredState
+from adam.utils import is_lambda
+
+repl_cmds: list['Command'] = []
+
+class Command:
+    """Abstract base class for commands"""
+    def __init__(self, successor: 'Command'=None):
+        if not hasattr(self, '_successor'):
+            self._successor = successor
+
+    @abstractmethod
+    def command(self) -> str:
+        pass
+
+    # The chain of responsibility pattern
+    # Do not do child of child!!!
+    @abstractmethod
+    def run(self, cmd: str, state: ReplState):
+        if self._successor:
+            return self._successor.run(cmd, state)
+
+        return None
+
+    def completion(self, state: ReplState, leaf: dict[str, any] = None) -> dict[str, any]:
+        if not self.validate_state(state, show_err=False):
+            return {}
+
+        if is_lambda(leaf):
+            leaf = leaf()
+
+        d = leaf
+        for t in reversed(self.command().split(' ')):
+            d = {t: d}
+
+        return d
+
+    def required(self) -> RequiredState:
+        return None
+
+    def validate(self, args: list[str], state: ReplState, apply = True):
+        return ValidateHandler(self, args, state, apply = apply)
+
+    def validate_state(self, state: ReplState, show_err = True):
+        return state.validate(self.required(), show_err=show_err)
+
+    def help(self, _: ReplState) -> str:
+        return None
+
+    def args(self, cmd: str):
+        a = list(filter(None, cmd.split(' ')))
+        spec = self.command_tokens()
+        if spec != a[:len(spec)]:
+            return None
+
+        return a
+
+    def apply_state(self, args: list[str], state: ReplState, resolve_pg = True, args_to_check = 6) -> tuple[ReplState, list[str]]:
+        """
+        Applies any contextual arguments such as namespace or statefulset to the ReplState and returns any non-contextual arguments.
+        """
+        return state.apply_args(args, cmd=self.command_tokens(), resolve_pg=resolve_pg, args_to_check=args_to_check)
+
+    def command_tokens(self):
+        return self.command().split(' ')
+
+    # build a chain-of-responsibility chain
+    def chain(cl: list['Command']):
+        global repl_cmds
+        repl_cmds.extend(cl)
+
+        cmds = cl[0]
+        cmd = cmds
+        for successor in cl[1:]:
+            cmd._successor = successor
+            cmd = successor
+
+        return cmds
+
+    def command_to_completion(self):
+        # COMMAND = 'reaper activate schedule'
+        d = None
+        for t in reversed(self.command().split(' ')):
+            d = {t: d}
+
+        return d
+
+    def display_help():
+        args = copy.copy(sys.argv)
+        args.extend(['--help'])
+        subprocess.run(args)
+
+    def extract_options(args: list[str], trailing: Union[str, list[str]] = [], options: list[str] = []):
+        found_options: list[str] = []
+        found_trailing = None
+
+        if trailing is None:
+            trailing = []
+        elif isinstance(trailing, str):
+            trailing = [trailing]
+
+        if options is None:
+            options = []
+        elif isinstance(options, str):
+            options = [options]
+
+        new_args: list[str] = []
+        for index, arg in enumerate(args):
+            if index == len(args) - 1 and arg in trailing:
+                found_trailing = arg
+            elif arg in options:
+                found_options.append(arg)
+            else:
+                new_args.append(arg)
+
+        return new_args, found_trailing, found_options
+
+    def print_chain(cmd: 'Command'):
+        print(f'{cmd.command()}', end = '')
+        while s := cmd._successor:
+            print(f'-> {s.command()}', end = '')
+            cmd = s
+        print()
+
+class InvalidState(Exception):
+    def __init__(self, state: ReplState):
+        super().__init__(f'Invalid state')
+
+class ValidateHandler:
+    def __init__(self, cmd: Command, args: list[str], state: ReplState, apply = True):
+        self.cmd = cmd
+        self.args = args
+        self.state = state
+        self.apply = apply
+
+    def __enter__(self) -> tuple[list[str], ReplState]:
+        state = self.state
+        args = self.args
+        if self.apply:
+            state, args = self.cmd.apply_state(args, state)
+
+        if not self.cmd.validate_state(state):
+            raise InvalidState(state)
+
+        return args, state
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        return False
+
+class ExtractOptionsHandler:
+    def __init__(self, args: list[str], options: list[str] = None):
+        self.args = args
+        self.options = options
+
+    def __enter__(self) -> tuple[list[str], list[str]]:
+        args, _, options = Command.extract_options(self.args, options=self.options)
+        return args, options
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        return False
+
+class ExtractTrailingOptionsHandler:
+    def __init__(self, args: list[str], trailing: list[str] = None):
+        self.args = args
+        self.trailing = trailing
+
+    def __enter__(self) -> tuple[list[str], list[str]]:
+        args, trailing, _ = Command.extract_options(self.args, trailing=self.trailing)
+        return args, trailing
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        return False
+
+class ExtractAllOptionsHandler:
+    def __init__(self, args: list[str], trailing: list[str] = None, options: list[str] = None):
+        self.args = args
+        self.trailing = trailing
+        self.options = options
+
+    def __enter__(self) -> tuple[list[str], list[str]]:
+        return Command.extract_options(self.args, options=self.options)
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        return False

{walker → adam}/commands/command_helpers.py

@@ -1,6 +1,6 @@
 import click
 
-from walker.utils import log
+from adam.utils import log
 
 class ClusterCommandHelper(click.Command):
     def get_help(self, ctx: click.Context):

{walker → adam}/commands/commands_utils.py

@@ -1,16 +1,14 @@
-from concurrent.futures import ThreadPoolExecutor
-import time
 from kubernetes import client
 from typing import List
 
-from walker.checks.check_utils import run_checks
-from walker.columns.columns import Columns, collect_checks
-from walker.commands.issues import Issues
-from walker.k8s_utils.cassandra_nodes import CassandraNodes
-from walker.k8s_utils.pods import Pods
-from walker.k8s_utils.statefulsets import StatefulSets
-from walker.repl_state import ReplState
-from walker.utils import convert_seconds, duration, lines_to_tabular, log, log2
+from adam.checks.check_utils import run_checks
+from adam.columns.columns import Columns, collect_checks
+from adam.utils_issues import IssuesUtils
+from adam.utils_k8s.cassandra_nodes import CassandraNodes
+from adam.utils_k8s.pods import Pods
+from adam.utils_k8s.statefulsets import StatefulSets
+from adam.repl_state import ReplState
+from adam.utils import duration, lines_to_tabular, log, log2
 
 def show_pods(pods: List[client.V1Pod], ns: str, show_namespace = True, show_host_id = True):
     if len(pods) == 0:
@@ -21,18 +19,10 @@ def show_pods(pods: List[client.V1Pod], ns: str, show_namespace = True, show_hos
     if show_host_id:
         names = [pod.metadata.name for pod in pods]
 
-        def get_host_id_with_pod(pod, ns):
-            return (CassandraNodes.get_host_id(pod, ns), pod)
-
-        def body(executor: ThreadPoolExecutor, pod, ns, show_out):
-            if executor:
-                return executor.submit(get_host_id_with_pod, pod, ns)
-
-            id = CassandraNodes.get_host_id(pod, ns)
-
-            return (id, pod)
-
-        host_ids_by_pod = {pod: id for id, pod in Pods.on_pods(names, ns, body, action='get-host-id', show_out=False)}
+        msg = 'd`Retrieving|Retrived {size} host ids'
+        with Pods.parallelize(names, msg=msg, action = 'get-host-id') as exec:
+            host_pods = exec.map(lambda pod: (CassandraNodes.get_host_id(pod, ns), pod))
+            host_ids_by_pod = {pod: id for id, pod in host_pods}
 
     def line(pod: client.V1Pod):
         pod_cnt = len(pod.status.container_statuses)
@@ -71,10 +61,10 @@ def show_rollout(sts: str, ns: str):
         else:
             log2(f'Cluster has completed rollout {d} ago.')
 
-def show_table(state: ReplState, pods: list[str], cols: str, header: str, show_output=False):
+def show_table(state: ReplState, pods: list[str], cols: str, header: str, show_out=False):
     columns = Columns.create_columns(cols)
 
-    results = run_checks(cluster=state.sts, pod=state.pod, namespace=state.namespace, checks=collect_checks(columns), show_output=show_output)
+    results = run_checks(cluster=state.sts, pod=state.pod, namespace=state.namespace, checks=collect_checks(columns), show_out=show_out)
 
     def line(pod_name: str):
         cells = [c.pod_value(results, pod_name) for c in columns]
@@ -85,4 +75,4 @@ def show_table(state: ReplState, pods: list[str], cols: str, header: str, show_o
 
     log(lines_to_tabular(lines, header, separator=','))
 
-    Issues.show(results, state.in_repl)
+    IssuesUtils.show(results, state.in_repl)

adam/commands/cp.py

@@ -0,0 +1,89 @@
+import click
+import pyperclip
+
+from adam.commands.command import Command
+from adam.commands.command_helpers import ClusterOrPodCommandHelper
+from adam.commands.cli_commands import CliCommands
+from adam.repl_state import ReplState, RequiredState
+from adam.utils import lines_to_tabular, log, log2
+
+class ClipboardCopy(Command):
+    COMMAND = 'cp'
+
+    # the singleton pattern
+    def __new__(cls, *args, **kwargs):
+        if not hasattr(cls, 'instance'): cls.instance = super(ClipboardCopy, cls).__new__(cls)
+
+        return cls.instance
+
+    def __init__(self, successor: Command=None):
+        super().__init__(successor)
+
+    def command(self):
+        return ClipboardCopy.COMMAND
+
+    def required(self):
+        return RequiredState.CLUSTER_OR_POD
+
+    def run(self, cmd: str, state: ReplState):
+        if not(args := self.args(cmd)):
+            return super().run(cmd, state)
+
+        with self.validate(args, state) as (args, state):
+            if len(args) < 1:
+                if state.in_repl:
+                    log2('Key is required.')
+                    log2()
+                    log2('Keys:')
+                    log2(lines_to_tabular([f'{k},{v}' for k, v in CliCommands.values(state, collapse=True).items()], separator=','))
+                else:
+                    log2('* Key is missing.')
+                    Command.display_help()
+
+                return 'command-missing'
+
+            key = args[0]
+            if not key in CliCommands.values(state):
+                if state.in_repl:
+                    log2('Key is required.')
+                    log2()
+                    log2('Keys:')
+                    log2(lines_to_tabular([f'{k},{v}' for k, v in CliCommands.values(state, collapse=True).items()], separator=','))
+                else:
+                    log2('* Invalid key')
+                    Command.display_help()
+
+                return 'command-invalid'
+
+            value = CliCommands.values(state)[key]
+            pyperclip.copy(value)
+            log2('The following line has been copied to clipboard. Use <Ctrl-V> to use it.')
+            log2(f'  {value}')
+
+            return 'value-copied'
+
+    def completion(self, state: ReplState):
+        return super().completion(state, lambda: {key: None for key in CliCommands.values(state).keys()})
+
+    def help(self, _: ReplState):
+        return f"{ClipboardCopy.COMMAND} <key>\t copy a value to clipboard for conveninence"
+
+class CopyCommandHelper(click.Command):
+    def lines(self):
+        return [
+            'node-exec-?: kubectl exec command to the Cassandra pod',
+            'reaper-exec: kubectl exec command to the Reaper pod',
+            'reaper-forward: kubectl port-forward command to the Reaper pod',
+            'reaper-ui: uri to Reaper ui',
+            'reaper-username: Reaper user name',
+            'reaper-password: Reaper password',
+        ]
+
+    def get_help(self, ctx: click.Context):
+        log(super().get_help(ctx))
+        log()
+        log('Keys:')
+
+        log(lines_to_tabular(self.lines(), separator=':'))
+        log()
+        ClusterOrPodCommandHelper.cluter_or_pod_help()

adam/commands/cql/cql_completions.py

@@ -0,0 +1,33 @@
+import time
+from adam.commands.cql.utils_cql import cassandra_keyspaces, cassandra_table_names
+from adam.commands.export.exporter import Exporter
+from adam.commands.export.export_databases import ExportDatabases
+from adam.config import Config
+from adam.repl_state import ReplState
+from adam.sql.sql_completer import SqlCompleter, SqlVariant
+from adam.utils import log_timing
+
+def cql_completions(state: ReplState) -> dict[str, any]:
+    ps = Config().get('cql.alter-tables.gc-grace-periods', '3600,86400,864000,7776000').split(',')
+    # warm up caches
+    with log_timing('cassandra_keyspaces'):
+        cassandra_keyspaces(state)
+    with log_timing('cassandra_table_names'):
+        cassandra_table_names(state)
+    with log_timing('ExportDatabases.database_names'):
+        ExportDatabases.database_names()
+
+    expandables = {
+        'keyspaces': lambda: cassandra_keyspaces(state),
+        'table-props': lambda: {
+            'GC_GRACE_SECONDS': ps
+        },
+        'export-dbs': lambda: ExportDatabases.database_names(),
+        'export-sessions': lambda: Exporter.export_session_names(state.sts, state.pod, state.namespace),
+        'export-sessions-incomplete': lambda: Exporter.export_session_names(state.sts, state.pod, state.namespace, export_state='pending_import'),
+    }
+
+    return SqlCompleter(
+        lambda: cassandra_table_names(state),
+        expandables=expandables,
+        variant=SqlVariant.CQL).completions_for_nesting()

{walker/commands → adam/commands/cql}/cqlsh.py

@@ -1,10 +1,13 @@
 import click
 
-from walker.commands.command import Command
-from walker.commands.command_helpers import ClusterOrPodCommandHelper
-from walker.commands.cql_utils import run_cql
-from walker.repl_state import ReplState, RequiredState
-from walker.utils import log, log2
+from adam.commands import extract_trailing_options
+from adam.commands.command import Command
+from adam.commands.command_helpers import ClusterOrPodCommandHelper
+from adam.commands.cql.cql_completions import cql_completions
+from adam.commands.cql.utils_cql import cassandra
+from adam.utils_k8s.statefulsets import StatefulSets
+from adam.repl_state import ReplState, RequiredState
+from adam.utils import log
 
 class Cqlsh(Command):
     COMMAND = 'cql'
@@ -28,43 +31,25 @@ class Cqlsh(Command):
         if not(args := self.args(cmd)):
             return super().run(cmd, state)
 
-        state, args = self.apply_state(args, state)
-        if not self.validate_state(state):
-            return state
-
-        opts = []
-        cqls = []
-        for arg in args:
-            if arg.startswith('--'):
-                opts.append(arg)
-            elif arg != '-e':
-                cqls.append(arg)
-        if not cqls:
-            if state.in_repl:
-                log2('Please enter cql statement. e.g. select host_id from system.local')
-            else:
-                log2('* CQL statement is missing.')
-                log2()
-                Command.display_help()
-
-            return 'no-cql'
-
-        cql = ' '.join(cqls)
-        return run_cql(state, cql, opts, show_out=True)
+        with self.validate(args, state) as (args, state):
+            with extract_trailing_options(args, '&') as (args, backgrounded):
+                with cassandra(state) as pods:
+                    pods.cql(args, background=backgrounded)
 
     def completion(self, state: ReplState) -> dict[str, any]:
+        if state.device != state.C:
+            # conflicts with psql completions
+            return {}
+
         if state.sts or state.pod:
-            return {Cqlsh.COMMAND: None} | {
-                'delete': {'from': None},
-                'insert': {'into': None},
-                'select': None,
-                'update': None,
-            }
+            c = cql_completions(state)
+            return c | \
+                   {f'@{p}': c for p in StatefulSets.pod_names(state.sts, state.namespace)}
 
         return {}
 
     def help(self, _: ReplState) -> str:
-        return f'[{Cqlsh.COMMAND}] <cql-statements>\t run cqlsh with queries'
+        return f'<cql-statements> [&]\t run cqlsh with queries'
 
 class CqlCommandHelper(click.Command):
     def get_help(self, ctx: click.Context):