kaqing 2.0.14__py3-none-any.whl → 2.0.189__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Potentially problematic release.
This version of kaqing might be problematic. Click here for more details.
- adam/__init__.py +0 -2
- adam/app_session.py +9 -12
- adam/apps.py +20 -6
- adam/batch.py +16 -6
- adam/checks/check_utils.py +19 -49
- adam/checks/compactionstats.py +1 -1
- adam/checks/cpu.py +9 -3
- adam/checks/cpu_metrics.py +52 -0
- adam/checks/disk.py +3 -4
- adam/checks/gossip.py +1 -1
- adam/checks/memory.py +3 -3
- adam/checks/status.py +1 -1
- adam/columns/columns.py +3 -1
- adam/columns/cpu.py +3 -1
- adam/columns/cpu_metrics.py +22 -0
- adam/columns/memory.py +3 -4
- adam/commands/__init__.py +24 -0
- adam/commands/alter_tables.py +66 -0
- adam/commands/app/app.py +38 -0
- adam/commands/{app_ping.py → app/app_ping.py} +8 -14
- adam/commands/app/show_app_actions.py +49 -0
- adam/commands/{show → app}/show_app_id.py +9 -12
- adam/commands/{show → app}/show_app_queues.py +8 -14
- adam/commands/app/utils_app.py +106 -0
- adam/commands/audit/__init__.py +0 -0
- adam/commands/audit/audit.py +67 -0
- adam/commands/audit/audit_repair_tables.py +72 -0
- adam/commands/audit/audit_run.py +50 -0
- adam/commands/audit/completions_l.py +15 -0
- adam/commands/audit/show_last10.py +36 -0
- adam/commands/audit/show_slow10.py +36 -0
- adam/commands/audit/show_top10.py +36 -0
- adam/commands/audit/utils_show_top10.py +71 -0
- adam/commands/bash/__init__.py +5 -0
- adam/commands/bash/bash.py +36 -0
- adam/commands/bash/bash_completer.py +93 -0
- adam/commands/bash/utils_bash.py +16 -0
- adam/commands/cat.py +36 -0
- adam/commands/cd.py +14 -88
- adam/commands/check.py +18 -21
- adam/commands/cli_commands.py +11 -7
- adam/commands/clipboard_copy.py +87 -0
- adam/commands/code.py +57 -0
- adam/commands/command.py +220 -19
- adam/commands/commands_utils.py +28 -31
- adam/commands/cql/__init__.py +0 -0
- adam/commands/cql/completions_c.py +28 -0
- adam/commands/{cqlsh.py → cql/cqlsh.py} +13 -32
- adam/commands/cql/utils_cql.py +305 -0
- adam/commands/deploy/code_start.py +7 -10
- adam/commands/deploy/code_stop.py +4 -21
- adam/commands/deploy/code_utils.py +5 -5
- adam/commands/deploy/deploy.py +4 -40
- adam/commands/deploy/deploy_frontend.py +15 -18
- adam/commands/deploy/deploy_pg_agent.py +4 -7
- adam/commands/deploy/deploy_pod.py +74 -77
- adam/commands/deploy/deploy_utils.py +16 -26
- adam/commands/deploy/undeploy.py +4 -40
- adam/commands/deploy/undeploy_frontend.py +5 -8
- adam/commands/deploy/undeploy_pg_agent.py +7 -8
- adam/commands/deploy/undeploy_pod.py +16 -17
- adam/commands/devices/__init__.py +0 -0
- adam/commands/devices/device.py +149 -0
- adam/commands/devices/device_app.py +163 -0
- adam/commands/devices/device_auit_log.py +49 -0
- adam/commands/devices/device_cass.py +179 -0
- adam/commands/devices/device_export.py +87 -0
- adam/commands/devices/device_postgres.py +160 -0
- adam/commands/devices/devices.py +25 -0
- adam/commands/download_file.py +47 -0
- adam/commands/exit.py +1 -4
- adam/commands/export/__init__.py +0 -0
- adam/commands/export/clean_up_all_export_sessions.py +37 -0
- adam/commands/export/clean_up_export_sessions.py +39 -0
- adam/commands/export/completions_x.py +11 -0
- adam/commands/export/download_export_session.py +40 -0
- adam/commands/export/drop_export_database.py +39 -0
- adam/commands/export/drop_export_databases.py +37 -0
- adam/commands/export/export.py +37 -0
- adam/commands/export/export_databases.py +246 -0
- adam/commands/export/export_select.py +34 -0
- adam/commands/export/export_sessions.py +209 -0
- adam/commands/export/export_use.py +49 -0
- adam/commands/export/export_x_select.py +48 -0
- adam/commands/export/exporter.py +332 -0
- adam/commands/export/import_files.py +44 -0
- adam/commands/export/import_session.py +44 -0
- adam/commands/export/importer.py +81 -0
- adam/commands/export/importer_athena.py +148 -0
- adam/commands/export/importer_sqlite.py +67 -0
- adam/commands/export/show_column_counts.py +45 -0
- adam/commands/export/show_export_databases.py +39 -0
- adam/commands/export/show_export_session.py +39 -0
- adam/commands/export/show_export_sessions.py +37 -0
- adam/commands/export/utils_export.py +344 -0
- adam/commands/find_files.py +51 -0
- adam/commands/find_processes.py +76 -0
- adam/commands/head.py +36 -0
- adam/commands/help.py +14 -9
- adam/commands/intermediate_command.py +52 -0
- adam/commands/issues.py +14 -40
- adam/commands/kubectl.py +38 -0
- adam/commands/login.py +26 -25
- adam/commands/logs.py +5 -7
- adam/commands/ls.py +11 -115
- adam/commands/medusa/medusa.py +4 -46
- adam/commands/medusa/medusa_backup.py +22 -29
- adam/commands/medusa/medusa_restore.py +51 -49
- adam/commands/medusa/medusa_show_backupjobs.py +20 -21
- adam/commands/medusa/medusa_show_restorejobs.py +16 -21
- adam/commands/medusa/utils_medusa.py +15 -0
- adam/commands/nodetool.py +8 -17
- adam/commands/param_get.py +11 -14
- adam/commands/param_set.py +9 -13
- adam/commands/postgres/completions_p.py +22 -0
- adam/commands/postgres/postgres.py +49 -73
- adam/commands/postgres/postgres_databases.py +270 -0
- adam/commands/postgres/postgres_ls.py +4 -8
- adam/commands/postgres/postgres_preview.py +5 -9
- adam/commands/postgres/utils_postgres.py +79 -0
- adam/commands/preview_table.py +10 -69
- adam/commands/pwd.py +14 -43
- adam/commands/reaper/reaper.py +6 -49
- adam/commands/reaper/reaper_forward.py +49 -56
- adam/commands/reaper/reaper_forward_session.py +6 -0
- adam/commands/reaper/reaper_forward_stop.py +10 -16
- adam/commands/reaper/reaper_restart.py +8 -15
- adam/commands/reaper/reaper_run_abort.py +8 -33
- adam/commands/reaper/reaper_runs.py +43 -58
- adam/commands/reaper/reaper_runs_abort.py +29 -49
- adam/commands/reaper/reaper_schedule_activate.py +14 -33
- adam/commands/reaper/reaper_schedule_start.py +9 -33
- adam/commands/reaper/reaper_schedule_stop.py +9 -33
- adam/commands/reaper/reaper_schedules.py +4 -14
- adam/commands/reaper/reaper_status.py +8 -16
- adam/commands/reaper/utils_reaper.py +203 -0
- adam/commands/repair/repair.py +4 -46
- adam/commands/repair/repair_log.py +6 -12
- adam/commands/repair/repair_run.py +29 -36
- adam/commands/repair/repair_scan.py +33 -41
- adam/commands/repair/repair_stop.py +6 -13
- adam/commands/report.py +25 -21
- adam/commands/restart.py +27 -28
- adam/commands/rollout.py +20 -25
- adam/commands/shell.py +12 -4
- adam/commands/show/show.py +15 -46
- adam/commands/show/show_adam.py +3 -3
- adam/commands/show/show_cassandra_repairs.py +37 -0
- adam/commands/show/show_cassandra_status.py +48 -52
- adam/commands/show/show_cassandra_version.py +5 -18
- adam/commands/show/show_cli_commands.py +56 -0
- adam/commands/show/show_host.py +33 -0
- adam/commands/show/show_login.py +23 -27
- adam/commands/show/show_params.py +2 -5
- adam/commands/show/show_processes.py +18 -21
- adam/commands/show/show_storage.py +11 -20
- adam/commands/watch.py +27 -30
- adam/config.py +8 -6
- adam/embedded_params.py +1 -1
- adam/log.py +4 -4
- adam/pod_exec_result.py +13 -5
- adam/repl.py +136 -120
- adam/repl_commands.py +66 -24
- adam/repl_session.py +8 -1
- adam/repl_state.py +343 -73
- adam/sql/__init__.py +0 -0
- adam/sql/lark_completer.py +284 -0
- adam/sql/lark_parser.py +604 -0
- adam/sql/sql_completer.py +118 -0
- adam/sql/sql_state_machine.py +630 -0
- adam/sql/term_completer.py +76 -0
- adam/sso/authn_ad.py +7 -9
- adam/sso/authn_okta.py +4 -6
- adam/sso/cred_cache.py +4 -6
- adam/sso/idp.py +10 -13
- adam/utils.py +539 -11
- adam/utils_athena.py +145 -0
- adam/utils_audits.py +102 -0
- adam/utils_issues.py +32 -0
- adam/utils_k8s/__init__.py +0 -0
- adam/utils_k8s/app_clusters.py +28 -0
- adam/utils_k8s/app_pods.py +36 -0
- adam/utils_k8s/cassandra_clusters.py +44 -0
- adam/{k8s_utils → utils_k8s}/cassandra_nodes.py +12 -5
- adam/{k8s_utils → utils_k8s}/custom_resources.py +16 -17
- adam/{k8s_utils → utils_k8s}/deployment.py +2 -2
- adam/{k8s_utils → utils_k8s}/ingresses.py +2 -2
- adam/{k8s_utils → utils_k8s}/jobs.py +7 -11
- adam/utils_k8s/k8s.py +96 -0
- adam/{k8s_utils → utils_k8s}/kube_context.py +3 -3
- adam/{k8s_utils → utils_k8s}/pods.py +132 -83
- adam/{k8s_utils → utils_k8s}/secrets.py +7 -3
- adam/{k8s_utils → utils_k8s}/service_accounts.py +5 -4
- adam/{k8s_utils → utils_k8s}/services.py +2 -2
- adam/{k8s_utils → utils_k8s}/statefulsets.py +9 -16
- adam/utils_local.py +4 -0
- adam/utils_net.py +24 -0
- adam/utils_repl/__init__.py +0 -0
- adam/utils_repl/appendable_completer.py +6 -0
- adam/utils_repl/automata_completer.py +48 -0
- adam/utils_repl/repl_completer.py +172 -0
- adam/utils_repl/state_machine.py +173 -0
- adam/utils_sqlite.py +137 -0
- adam/version.py +1 -1
- {kaqing-2.0.14.dist-info → kaqing-2.0.189.dist-info}/METADATA +1 -1
- kaqing-2.0.189.dist-info/RECORD +253 -0
- kaqing-2.0.189.dist-info/top_level.txt +2 -0
- teddy/__init__.py +0 -0
- teddy/lark_parser.py +436 -0
- teddy/lark_parser2.py +618 -0
- adam/commands/app.py +0 -67
- adam/commands/bash.py +0 -87
- adam/commands/cp.py +0 -95
- adam/commands/cql_utils.py +0 -53
- adam/commands/devices.py +0 -89
- adam/commands/postgres/postgres_session.py +0 -247
- adam/commands/reaper/reaper_session.py +0 -159
- adam/commands/show/show_app_actions.py +0 -53
- adam/commands/show/show_commands.py +0 -61
- adam/commands/show/show_repairs.py +0 -47
- adam/k8s_utils/cassandra_clusters.py +0 -48
- kaqing-2.0.14.dist-info/RECORD +0 -167
- kaqing-2.0.14.dist-info/top_level.txt +0 -1
- /adam/{k8s_utils → commands/app}/__init__.py +0 -0
- /adam/{k8s_utils → utils_k8s}/config_maps.py +0 -0
- /adam/{k8s_utils → utils_k8s}/volumes.py +0 -0
- {kaqing-2.0.14.dist-info → kaqing-2.0.189.dist-info}/WHEEL +0 -0
- {kaqing-2.0.14.dist-info → kaqing-2.0.189.dist-info}/entry_points.txt +0 -0
|
@@ -0,0 +1,163 @@
|
|
|
1
|
+
from adam.apps import Apps
|
|
2
|
+
from adam.commands import app
|
|
3
|
+
from adam.commands.bash.bash_completer import BashCompleter
|
|
4
|
+
from adam.commands.command import Command, InvalidStateException
|
|
5
|
+
from adam.commands.devices.device import Device
|
|
6
|
+
from adam.config import Config
|
|
7
|
+
from adam.repl_state import ReplState
|
|
8
|
+
from adam.utils import tabulize, log, wait_log
|
|
9
|
+
from adam.utils_k8s.app_pods import AppPods
|
|
10
|
+
from adam.utils_k8s.ingresses import Ingresses
|
|
11
|
+
|
|
12
|
+
class DeviceApp(Command, Device):
|
|
13
|
+
COMMAND = f'{ReplState.A}:'
|
|
14
|
+
|
|
15
|
+
# the singleton pattern
|
|
16
|
+
def __new__(cls, *args, **kwargs):
|
|
17
|
+
if not hasattr(cls, 'instance'): cls.instance = super(DeviceApp, cls).__new__(cls)
|
|
18
|
+
|
|
19
|
+
return cls.instance
|
|
20
|
+
|
|
21
|
+
def __init__(self, successor: Command=None):
|
|
22
|
+
super().__init__(successor)
|
|
23
|
+
|
|
24
|
+
def command(self):
|
|
25
|
+
return DeviceApp.COMMAND
|
|
26
|
+
|
|
27
|
+
def run(self, cmd: str, state: ReplState):
|
|
28
|
+
if not self.args(cmd):
|
|
29
|
+
return super().run(cmd, state)
|
|
30
|
+
|
|
31
|
+
state.device = ReplState.A
|
|
32
|
+
|
|
33
|
+
return state
|
|
34
|
+
|
|
35
|
+
def completion(self, state: ReplState):
|
|
36
|
+
return super().completion(state)
|
|
37
|
+
|
|
38
|
+
def help(self, _: ReplState):
|
|
39
|
+
return f'{DeviceApp.COMMAND}\t move to App Operations device'
|
|
40
|
+
|
|
41
|
+
def pod(self, state: ReplState) -> str:
|
|
42
|
+
return state.app_pod
|
|
43
|
+
|
|
44
|
+
def pod_names(self, state: ReplState) -> list[str]:
|
|
45
|
+
return AppPods.pod_names(state.namespace, state.app_env, state.app_app)
|
|
46
|
+
|
|
47
|
+
def default_container(self, state: ReplState) -> str:
|
|
48
|
+
return Config().get('app.container-name', 'c3-server')
|
|
49
|
+
|
|
50
|
+
def ls(self, cmd: str, state: ReplState):
|
|
51
|
+
if state.app_pod:
|
|
52
|
+
return self.bash(state, state, cmd.split(' '))
|
|
53
|
+
elif state.app_app:
|
|
54
|
+
tabulize(self.pod_names(state), header='POD_NAME')
|
|
55
|
+
elif state.app_env:
|
|
56
|
+
def line(n: str, ns: str):
|
|
57
|
+
host = Ingresses.get_host(Config().get('app.login.ingress', '{app_id}-k8singr-appleader-001').replace('{app_id}', f'{ns}-{n}'), ns)
|
|
58
|
+
if not host:
|
|
59
|
+
return None
|
|
60
|
+
|
|
61
|
+
endpoint = Config().get('app.login.url', 'https://{host}/{env}/{app}').replace('{host}', host).replace('{env}', state.app_env).replace('{app}', 'c3')
|
|
62
|
+
if not endpoint:
|
|
63
|
+
return None
|
|
64
|
+
|
|
65
|
+
return f"{n.split('-')[1]},{Ingresses.get_host(f'{ns}-{n}-k8singr-appleader-001', ns)},{endpoint}"
|
|
66
|
+
|
|
67
|
+
svcs = [l for l in [line(n, ns) for n, ns in Apps.apps(state.app_env)] if l]
|
|
68
|
+
|
|
69
|
+
tabulize(svcs, header='APP,HOST,ENDPOINT', separator=',')
|
|
70
|
+
else:
|
|
71
|
+
tabulize(Apps.envs(), lambda a: a[0], header='ENV', separator=',')
|
|
72
|
+
|
|
73
|
+
def ls_completion(self, cmd, state, default: dict = {}):
|
|
74
|
+
if state.app_app:
|
|
75
|
+
return super().completion(state) | {f'@{p}': {cmd: None} for p in self.pod_names(state)}
|
|
76
|
+
|
|
77
|
+
return default
|
|
78
|
+
|
|
79
|
+
def cd(self, dir: str, state: ReplState):
|
|
80
|
+
if dir == '':
|
|
81
|
+
state.app_env = None
|
|
82
|
+
state.app_app = None
|
|
83
|
+
state.app_pod = None
|
|
84
|
+
elif dir == '..':
|
|
85
|
+
if state.app_pod:
|
|
86
|
+
state.app_pod = None
|
|
87
|
+
elif state.app_app:
|
|
88
|
+
state.app_app = None
|
|
89
|
+
else:
|
|
90
|
+
state.app_env = None
|
|
91
|
+
else:
|
|
92
|
+
if state.app_app:
|
|
93
|
+
state.app_pod = dir
|
|
94
|
+
elif not state.app_env:
|
|
95
|
+
tks = dir.split('@')
|
|
96
|
+
if len(tks) > 1:
|
|
97
|
+
state.namespace = tks[1]
|
|
98
|
+
|
|
99
|
+
state.app_env = dir.split('@')[0]
|
|
100
|
+
else:
|
|
101
|
+
state.app_app = dir
|
|
102
|
+
|
|
103
|
+
def cd_completion(self, cmd: str, state: ReplState, default: dict = {}):
|
|
104
|
+
if state.app_app:
|
|
105
|
+
return {cmd: {'..': None} | {pod: None for pod in self.pod_names(state)}}
|
|
106
|
+
elif state.app_env:
|
|
107
|
+
return {cmd: {'..': None} | {app[0].split('-')[1]: None for app in Apps.apps(state.app_env)}}
|
|
108
|
+
else:
|
|
109
|
+
return {cmd: {'..': None} | {env[0]: None for env in Apps.envs()}}
|
|
110
|
+
|
|
111
|
+
def pwd(self, state: ReplState):
|
|
112
|
+
words = []
|
|
113
|
+
|
|
114
|
+
if state.app_env:
|
|
115
|
+
words.append(f'env/{state.app_env}')
|
|
116
|
+
if state.app_app:
|
|
117
|
+
words.append(f'app/{state.app_app}')
|
|
118
|
+
|
|
119
|
+
return '\t'.join([f'{ReplState.A}:>'] + (words if words else ['/']))
|
|
120
|
+
|
|
121
|
+
def try_fallback_action(self, chain: Command, state: ReplState, cmd: str):
|
|
122
|
+
if state.app_app:
|
|
123
|
+
return True, chain.run(f'app {cmd}', state)
|
|
124
|
+
|
|
125
|
+
return False, None
|
|
126
|
+
|
|
127
|
+
def enter(self, state: ReplState):
|
|
128
|
+
if not state.app_env:
|
|
129
|
+
if auto_enter := Config().get('repl.a.auto-enter', 'c3/c3/*'):
|
|
130
|
+
if auto_enter != 'no':
|
|
131
|
+
ea = auto_enter.split('/')
|
|
132
|
+
state.app_env = ea[0]
|
|
133
|
+
if len(ea) > 2:
|
|
134
|
+
state.app_app = ea[1]
|
|
135
|
+
state.app_pod = ea[2]
|
|
136
|
+
if state.app_pod == '*':
|
|
137
|
+
if (pods := self.pod_names(state)):
|
|
138
|
+
state.app_pod = pods[0]
|
|
139
|
+
wait_log(f'Moving to {state.app_env}/{state.app_app}/{state.app_pod}...')
|
|
140
|
+
else:
|
|
141
|
+
wait_log(f'No pods found, moving to {state.app_env}/{state.app_app}...')
|
|
142
|
+
else:
|
|
143
|
+
wait_log(f'Moving to {state.app_env}/{state.app_app}/{state.app_pod}...')
|
|
144
|
+
elif len(ea) > 1:
|
|
145
|
+
state.app_app = ea[1]
|
|
146
|
+
wait_log(f'Moving to {state.app_env}/{state.app_app}...')
|
|
147
|
+
else:
|
|
148
|
+
wait_log(f'Moving to {state.app_env}...')
|
|
149
|
+
|
|
150
|
+
def bash_target_changed(self, s0: ReplState, s1: ReplState):
|
|
151
|
+
return s0.app_env != s1.app_env or s0.app_app != s1.app_app or s0.app_pod != s1.app_pod
|
|
152
|
+
|
|
153
|
+
def exec_no_dir(self, command: str, state: ReplState):
|
|
154
|
+
with app(state) as pods:
|
|
155
|
+
return pods.exec(command)
|
|
156
|
+
|
|
157
|
+
def exec_with_dir(self, command: str, session_just_created: bool, state: ReplState):
|
|
158
|
+
with app(state) as pods:
|
|
159
|
+
return pods.exec(command, not session_just_created)
|
|
160
|
+
|
|
161
|
+
def bash_completion(self, cmd: str, state: ReplState, default: dict = {}):
|
|
162
|
+
return {cmd: BashCompleter(lambda: [])} | \
|
|
163
|
+
{f'@{p}': {cmd: BashCompleter(lambda: [])} for p in self.pod_names(state)}
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
from adam.commands.command import Command
|
|
2
|
+
from adam.commands.devices.device import Device
|
|
3
|
+
from adam.repl_state import ReplState
|
|
4
|
+
from adam.utils import tabulize, log
|
|
5
|
+
from adam.utils_athena import Athena
|
|
6
|
+
|
|
7
|
+
class DeviceAuditLog(Command, Device):
|
|
8
|
+
COMMAND = f'{ReplState.L}:'
|
|
9
|
+
|
|
10
|
+
# the singleton pattern
|
|
11
|
+
def __new__(cls, *args, **kwargs):
|
|
12
|
+
if not hasattr(cls, 'instance'): cls.instance = super(DeviceAuditLog, cls).__new__(cls)
|
|
13
|
+
|
|
14
|
+
return cls.instance
|
|
15
|
+
|
|
16
|
+
def __init__(self, successor: Command=None):
|
|
17
|
+
super().__init__(successor)
|
|
18
|
+
|
|
19
|
+
def command(self):
|
|
20
|
+
return DeviceAuditLog.COMMAND
|
|
21
|
+
|
|
22
|
+
def run(self, cmd: str, state: ReplState):
|
|
23
|
+
if not self.args(cmd):
|
|
24
|
+
return super().run(cmd, state)
|
|
25
|
+
|
|
26
|
+
state.device = ReplState.L
|
|
27
|
+
|
|
28
|
+
return state
|
|
29
|
+
|
|
30
|
+
def completion(self, state: ReplState):
|
|
31
|
+
return super().completion(state)
|
|
32
|
+
|
|
33
|
+
def help(self, _: ReplState):
|
|
34
|
+
return f'{DeviceAuditLog.COMMAND}\t move to Audit Log Operations device'
|
|
35
|
+
|
|
36
|
+
def ls(self, cmd: str, _: ReplState):
|
|
37
|
+
tabulize(Athena.table_names(), header='NAME', separator=',')
|
|
38
|
+
|
|
39
|
+
def pwd(self, _: ReplState):
|
|
40
|
+
return '\t'.join([f'{ReplState.L}:>', '/'])
|
|
41
|
+
|
|
42
|
+
def try_fallback_action(self, chain: Command, state: ReplState, cmd: str):
|
|
43
|
+
return True, chain.run(f'audit {cmd}', state)
|
|
44
|
+
|
|
45
|
+
def show_tables(self, _: ReplState):
|
|
46
|
+
tabulize(Athena.table_names(), separator=',')
|
|
47
|
+
|
|
48
|
+
def show_table_preview(self, _: ReplState, table: str, rows: int):
|
|
49
|
+
Athena.run_query(f'select * from {table} limit {rows}')
|
|
@@ -0,0 +1,179 @@
|
|
|
1
|
+
from adam.commands.bash.bash_completer import BashCompleter
|
|
2
|
+
from adam.commands.command import Command, InvalidStateException
|
|
3
|
+
from adam.commands.commands_utils import show_pods, show_rollout
|
|
4
|
+
from adam.commands.cql.utils_cql import cassandra, cassandra_table_names
|
|
5
|
+
from adam.commands.devices.device import Device
|
|
6
|
+
from adam.config import Config
|
|
7
|
+
from adam.repl_state import ReplState
|
|
8
|
+
from adam.utils import tabulize, log, log2, wait_log
|
|
9
|
+
from adam.utils_k8s.cassandra_clusters import CassandraClusters
|
|
10
|
+
from adam.utils_k8s.custom_resources import CustomResources
|
|
11
|
+
from adam.utils_k8s.kube_context import KubeContext
|
|
12
|
+
from adam.utils_k8s.statefulsets import StatefulSets
|
|
13
|
+
|
|
14
|
+
class DeviceCass(Command, Device):
|
|
15
|
+
COMMAND = f'{ReplState.C}:'
|
|
16
|
+
|
|
17
|
+
# the singleton pattern
|
|
18
|
+
def __new__(cls, *args, **kwargs):
|
|
19
|
+
if not hasattr(cls, 'instance'): cls.instance = super(DeviceCass, cls).__new__(cls)
|
|
20
|
+
|
|
21
|
+
return cls.instance
|
|
22
|
+
|
|
23
|
+
def __init__(self, successor: Command=None):
|
|
24
|
+
super().__init__(successor)
|
|
25
|
+
|
|
26
|
+
def command(self):
|
|
27
|
+
return DeviceCass.COMMAND
|
|
28
|
+
|
|
29
|
+
def run(self, cmd: str, state: ReplState):
|
|
30
|
+
if not self.args(cmd):
|
|
31
|
+
return super().run(cmd, state)
|
|
32
|
+
|
|
33
|
+
state.device = ReplState.C
|
|
34
|
+
|
|
35
|
+
return state
|
|
36
|
+
|
|
37
|
+
def pod(self, state: ReplState) -> str:
|
|
38
|
+
return state.pod
|
|
39
|
+
|
|
40
|
+
def pod_names(self, state: ReplState) -> list[str]:
|
|
41
|
+
return StatefulSets.pod_names(state.sts, state.namespace)
|
|
42
|
+
|
|
43
|
+
def completion(self, state: ReplState):
|
|
44
|
+
return super().completion(state)
|
|
45
|
+
|
|
46
|
+
def help(self, _: ReplState):
|
|
47
|
+
return f'{DeviceCass.COMMAND}\t move to Cassandra Operations device'
|
|
48
|
+
|
|
49
|
+
def default_container(self, _: ReplState) -> str:
|
|
50
|
+
return 'cassandra'
|
|
51
|
+
|
|
52
|
+
def ls(self, cmd: str, state: ReplState):
|
|
53
|
+
if state.pod:
|
|
54
|
+
return self.bash(state, state, cmd.split(' '))
|
|
55
|
+
elif state.sts and state.namespace:
|
|
56
|
+
show_pods(StatefulSets.pods(state.sts, state.namespace), state.namespace, show_namespace=not KubeContext.in_cluster_namespace())
|
|
57
|
+
show_rollout(state.sts, state.namespace)
|
|
58
|
+
else:
|
|
59
|
+
self.show_statefulsets()
|
|
60
|
+
|
|
61
|
+
def ls_completion(self, cmd: str, state: ReplState, default: dict = {}):
|
|
62
|
+
if state.sts:
|
|
63
|
+
return super().completion(state) | {f'@{p}': {'ls': None} for p in self.pod_names(state)}
|
|
64
|
+
else:
|
|
65
|
+
return {cmd: {n: None for n in StatefulSets.list_sts_names()}}
|
|
66
|
+
|
|
67
|
+
def show_statefulsets(self):
|
|
68
|
+
ss = StatefulSets.list_sts_names()
|
|
69
|
+
if len(ss) == 0:
|
|
70
|
+
log2('No Cassandra clusters found.')
|
|
71
|
+
return
|
|
72
|
+
|
|
73
|
+
app_ids = CustomResources.get_app_ids()
|
|
74
|
+
list = []
|
|
75
|
+
for s in ss:
|
|
76
|
+
cr_name = CustomResources.get_cr_name(s)
|
|
77
|
+
app_id = 'Unknown'
|
|
78
|
+
if cr_name in app_ids:
|
|
79
|
+
app_id = app_ids[cr_name]
|
|
80
|
+
list.append(f"{s} {app_id}")
|
|
81
|
+
|
|
82
|
+
header = 'STATEFULSET_NAME@NAMESPACE APP_ID'
|
|
83
|
+
if KubeContext.in_cluster_namespace():
|
|
84
|
+
header = 'STATEFULSET_NAME APP_ID'
|
|
85
|
+
tabulize(list, header=header)
|
|
86
|
+
|
|
87
|
+
def cd(self, dir: str, state: ReplState):
|
|
88
|
+
if dir == '':
|
|
89
|
+
state.sts = None
|
|
90
|
+
state.pod = None
|
|
91
|
+
elif dir == '..':
|
|
92
|
+
if state.pod:
|
|
93
|
+
state.pod = None
|
|
94
|
+
else:
|
|
95
|
+
state.sts = None
|
|
96
|
+
else:
|
|
97
|
+
if not state.sts:
|
|
98
|
+
ss_and_ns = dir.split('@')
|
|
99
|
+
state.sts = ss_and_ns[0]
|
|
100
|
+
if len(ss_and_ns) > 1:
|
|
101
|
+
state.namespace = ss_and_ns[1]
|
|
102
|
+
elif not state.pod:
|
|
103
|
+
p, _ = KubeContext.is_pod_name(dir)
|
|
104
|
+
if p:
|
|
105
|
+
state.pod = p
|
|
106
|
+
else:
|
|
107
|
+
names = CassandraClusters.pod_names_by_host_id(state.sts, state.namespace)
|
|
108
|
+
if dir in names:
|
|
109
|
+
state.pod = names[dir]
|
|
110
|
+
else:
|
|
111
|
+
state.pod = dir
|
|
112
|
+
|
|
113
|
+
def cd_completion(self, cmd: str, state: ReplState, default: dict = {}):
|
|
114
|
+
if state.pod:
|
|
115
|
+
return {cmd: {'..': None}}
|
|
116
|
+
elif state.sts:
|
|
117
|
+
return {cmd: {'..': None} | {p: None for p in self.pod_names(state)}}
|
|
118
|
+
else:
|
|
119
|
+
return {cmd: {p: None for p in StatefulSets.list_sts_names()}}
|
|
120
|
+
|
|
121
|
+
def pwd(self, state: ReplState):
|
|
122
|
+
words = []
|
|
123
|
+
|
|
124
|
+
if state.sts:
|
|
125
|
+
words.append(f'sts/{state.sts}')
|
|
126
|
+
if state.pod:
|
|
127
|
+
words.append(f'pod/{state.pod}')
|
|
128
|
+
|
|
129
|
+
return '\t'.join([f'{ReplState.C}:>'] + (words if words else ['/']))
|
|
130
|
+
|
|
131
|
+
def try_fallback_action(self, chain: Command, state: ReplState, cmd: str):
|
|
132
|
+
if state.sts:
|
|
133
|
+
return True, chain.run(f'cql {cmd}', state)
|
|
134
|
+
|
|
135
|
+
return False, None
|
|
136
|
+
|
|
137
|
+
def enter(self, state: ReplState):
|
|
138
|
+
auto_enter = Config().get('repl.c.auto-enter', 'cluster')
|
|
139
|
+
if auto_enter and auto_enter in ['cluster', 'first-pod']:
|
|
140
|
+
sts = StatefulSets.list_sts_name_and_ns()
|
|
141
|
+
if not sts:
|
|
142
|
+
log2("No Cassandra clusters found.")
|
|
143
|
+
elif not state.sts and len(sts) == 1:
|
|
144
|
+
cluster = sts[0]
|
|
145
|
+
state.sts = cluster[0]
|
|
146
|
+
state.namespace = cluster[1]
|
|
147
|
+
if auto_enter == 'first-pod':
|
|
148
|
+
state.pod = f'{state.sts}-0'
|
|
149
|
+
if KubeContext().in_cluster_namespace:
|
|
150
|
+
wait_log(f'Moving to the only Cassandra cluster: {state.sts}...')
|
|
151
|
+
else:
|
|
152
|
+
wait_log(f'Moving to the only Cassandra cluster: {state.sts}@{state.namespace}...')
|
|
153
|
+
|
|
154
|
+
def show_tables(self, state: ReplState):
|
|
155
|
+
tabulize(cassandra_table_names(state), separator=',')
|
|
156
|
+
|
|
157
|
+
def show_table_preview(self, state: ReplState, table: str, rows: int):
|
|
158
|
+
with cassandra(state) as pods:
|
|
159
|
+
pods.cql(f'select * from {table} limit {rows}', show_out=True, use_single_quotes=True, on_any=True)
|
|
160
|
+
|
|
161
|
+
def bash_target_changed(self, s0: ReplState, s1: ReplState):
|
|
162
|
+
return s0.sts != s1.sts or s0.pod != s1.pod
|
|
163
|
+
|
|
164
|
+
def exec_no_dir(self, command: str, state: ReplState):
|
|
165
|
+
with cassandra(state) as pods:
|
|
166
|
+
return pods.exec(command, action='bash', show_out=True, shell='bash')
|
|
167
|
+
|
|
168
|
+
def exec_with_dir(self, command: str, session_just_created: bool, state: ReplState):
|
|
169
|
+
with cassandra(state) as pods:
|
|
170
|
+
return pods.exec(command, action='bash', show_out=not session_just_created, shell='bash')
|
|
171
|
+
|
|
172
|
+
def bash_completion(self, cmd: str, state: ReplState, default: dict = {}):
|
|
173
|
+
completions = {cmd: BashCompleter(lambda: [])}
|
|
174
|
+
|
|
175
|
+
if state.sts and state.namespace:
|
|
176
|
+
completions |= {f'@{p}': {cmd: BashCompleter(lambda: [])} for p in self.pod_names(state)}
|
|
177
|
+
|
|
178
|
+
return completions
|
|
179
|
+
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
from adam.commands.command import Command
|
|
2
|
+
from adam.commands.devices.device import Device
|
|
3
|
+
from adam.commands.export.export_databases import ExportDatabases, export_db
|
|
4
|
+
from adam.config import Config
|
|
5
|
+
from adam.repl_state import ReplState
|
|
6
|
+
from adam.utils import tabulize, log2, wait_log
|
|
7
|
+
|
|
8
|
+
class DeviceExport(Command, Device):
|
|
9
|
+
COMMAND = f'{ReplState.X}:'
|
|
10
|
+
|
|
11
|
+
# the singleton pattern
|
|
12
|
+
def __new__(cls, *args, **kwargs):
|
|
13
|
+
if not hasattr(cls, 'instance'): cls.instance = super(DeviceExport, cls).__new__(cls)
|
|
14
|
+
|
|
15
|
+
return cls.instance
|
|
16
|
+
|
|
17
|
+
def __init__(self, successor: Command=None):
|
|
18
|
+
super().__init__(successor)
|
|
19
|
+
|
|
20
|
+
def command(self):
|
|
21
|
+
return DeviceExport.COMMAND
|
|
22
|
+
|
|
23
|
+
def run(self, cmd: str, state: ReplState):
|
|
24
|
+
if not self.args(cmd):
|
|
25
|
+
return super().run(cmd, state)
|
|
26
|
+
|
|
27
|
+
state.device = ReplState.X
|
|
28
|
+
|
|
29
|
+
return state
|
|
30
|
+
|
|
31
|
+
def completion(self, state: ReplState):
|
|
32
|
+
return super().completion(state)
|
|
33
|
+
|
|
34
|
+
def help(self, _: ReplState):
|
|
35
|
+
return f'{DeviceExport.COMMAND}\t move to Export Database Operations device'
|
|
36
|
+
|
|
37
|
+
def ls(self, cmd: str, state: ReplState):
|
|
38
|
+
if state.export_session:
|
|
39
|
+
tabulize(ExportDatabases.table_names(state.export_session), header='NAME', separator=',')
|
|
40
|
+
else:
|
|
41
|
+
ExportDatabases.show_databases()
|
|
42
|
+
|
|
43
|
+
def show_table_preview(self, state: ReplState, table: str, rows: int):
|
|
44
|
+
if state.export_session:
|
|
45
|
+
with export_db(state) as dbs:
|
|
46
|
+
dbs.sql(f'select * from {table} limit {rows}')
|
|
47
|
+
|
|
48
|
+
def cd(self, dir: str, state: ReplState):
|
|
49
|
+
if dir in ['', '..']:
|
|
50
|
+
state.export_session = None
|
|
51
|
+
else:
|
|
52
|
+
state.export_session = dir
|
|
53
|
+
|
|
54
|
+
def cd_completion(self, cmd: str, state: ReplState, default: dict = {}):
|
|
55
|
+
if state.export_session:
|
|
56
|
+
return {cmd: {'..': None} | {n: None for n in ExportDatabases.database_names()}}
|
|
57
|
+
else:
|
|
58
|
+
return {cmd: {n: None for n in ExportDatabases.database_names()}}
|
|
59
|
+
|
|
60
|
+
def pwd(self, state: ReplState):
|
|
61
|
+
words = []
|
|
62
|
+
|
|
63
|
+
if state.export_session:
|
|
64
|
+
words.append(state.export_session)
|
|
65
|
+
|
|
66
|
+
return '\t'.join([f'{ReplState.X}:>'] + (words if words else ['/']))
|
|
67
|
+
|
|
68
|
+
def try_fallback_action(self, chain: Command, state: ReplState, cmd: str):
|
|
69
|
+
if cmd.startswith('select '):
|
|
70
|
+
cmd = f'xelect {cmd[7:]}'
|
|
71
|
+
|
|
72
|
+
result = chain.run(cmd, state)
|
|
73
|
+
if type(result) is ReplState:
|
|
74
|
+
if state.export_session and not result.export_session:
|
|
75
|
+
state.export_session = None
|
|
76
|
+
|
|
77
|
+
return True, result
|
|
78
|
+
|
|
79
|
+
def enter(self, state: ReplState):
|
|
80
|
+
if auto_enter := Config().get('repl.x.auto-enter', 'no'):
|
|
81
|
+
if auto_enter == 'latest':
|
|
82
|
+
wait_log(f'Moving to the latest export database...')
|
|
83
|
+
if dbs := ExportDatabases.database_names():
|
|
84
|
+
state.export_session = sorted(dbs)[-1]
|
|
85
|
+
else:
|
|
86
|
+
log2('No export database found.')
|
|
87
|
+
|
|
@@ -0,0 +1,160 @@
|
|
|
1
|
+
from adam.commands.bash.bash_completer import BashCompleter
|
|
2
|
+
from adam.commands.command import Command
|
|
3
|
+
from adam.commands.devices.device import Device
|
|
4
|
+
from adam.commands.postgres.postgres_databases import PostgresDatabases, pg_path
|
|
5
|
+
from adam.commands.postgres.utils_postgres import pg_database_names, pg_table_names, postgres
|
|
6
|
+
from adam.repl_state import ReplState
|
|
7
|
+
from adam.utils import tabulize, log2, wait_log
|
|
8
|
+
|
|
9
|
+
class DevicePostgres(Command, Device):
|
|
10
|
+
COMMAND = f'{ReplState.P}:'
|
|
11
|
+
|
|
12
|
+
# the singleton pattern
|
|
13
|
+
def __new__(cls, *args, **kwargs):
|
|
14
|
+
if not hasattr(cls, 'instance'): cls.instance = super(DevicePostgres, cls).__new__(cls)
|
|
15
|
+
|
|
16
|
+
return cls.instance
|
|
17
|
+
|
|
18
|
+
def __init__(self, successor: Command=None):
|
|
19
|
+
super().__init__(successor)
|
|
20
|
+
|
|
21
|
+
def command(self):
|
|
22
|
+
return DevicePostgres.COMMAND
|
|
23
|
+
|
|
24
|
+
def run(self, cmd: str, state: ReplState):
|
|
25
|
+
if not self.args(cmd):
|
|
26
|
+
return super().run(cmd, state)
|
|
27
|
+
|
|
28
|
+
state.device = ReplState.P
|
|
29
|
+
|
|
30
|
+
return state
|
|
31
|
+
|
|
32
|
+
def completion(self, state: ReplState):
|
|
33
|
+
return super().completion(state)
|
|
34
|
+
|
|
35
|
+
def help(self, _: ReplState):
|
|
36
|
+
return f'{DevicePostgres.COMMAND}\t move to Postgres Operations device'
|
|
37
|
+
|
|
38
|
+
def pod(self, state: ReplState) -> str:
|
|
39
|
+
pod, _ = PostgresDatabases.pod_and_container(state.namespace)
|
|
40
|
+
return pod
|
|
41
|
+
|
|
42
|
+
def pod_names(self, state: ReplState) -> list[str]:
|
|
43
|
+
return [self.pod(state)]
|
|
44
|
+
|
|
45
|
+
def default_container(self, state: ReplState) -> str:
|
|
46
|
+
_, container = PostgresDatabases.pod_and_container(state.namespace)
|
|
47
|
+
return container
|
|
48
|
+
|
|
49
|
+
def ls(self, cmd: str, state: ReplState):
|
|
50
|
+
if state.pod_targetted:
|
|
51
|
+
self.bash(state, state, ['ls'])
|
|
52
|
+
return
|
|
53
|
+
|
|
54
|
+
with pg_path(state) as (host, database):
|
|
55
|
+
if database:
|
|
56
|
+
tabulize(pg_table_names(state), header='NAME', separator=',')
|
|
57
|
+
elif host:
|
|
58
|
+
tabulize(pg_database_names(state), header='DATABASE', separator=',')
|
|
59
|
+
else:
|
|
60
|
+
self.show_pg_hosts(state)
|
|
61
|
+
|
|
62
|
+
def show_pg_hosts(self, state: ReplState):
|
|
63
|
+
if state.namespace:
|
|
64
|
+
tabulize(PostgresDatabases.hosts(state),
|
|
65
|
+
lambda p: f'{p.host},{p.endpoint()}:{p.port()},{p.username()},{p.password()}',
|
|
66
|
+
header='NAME,ENDPOINT,USERNAME,PASSWORD',
|
|
67
|
+
separator=',')
|
|
68
|
+
else:
|
|
69
|
+
tabulize(PostgresDatabases.hosts(state),
|
|
70
|
+
lambda p: f'{p.host},{p.namespace},{p.endpoint()}:{p.port()},{p.username()},{p.password()}',
|
|
71
|
+
header='NAME,NAMESPACE,ENDPOINT,USERNAME,PASSWORD',
|
|
72
|
+
separator=',')
|
|
73
|
+
|
|
74
|
+
def cd(self, dir: str, state: ReplState):
|
|
75
|
+
if dir == '':
|
|
76
|
+
state.pg_path = None
|
|
77
|
+
return
|
|
78
|
+
|
|
79
|
+
with pg_path(state) as (host, database):
|
|
80
|
+
if dir == '..':
|
|
81
|
+
if database:
|
|
82
|
+
database = None
|
|
83
|
+
else:
|
|
84
|
+
host = None
|
|
85
|
+
else:
|
|
86
|
+
tks = dir.split('@')
|
|
87
|
+
if not host:
|
|
88
|
+
host = tks[0]
|
|
89
|
+
else:
|
|
90
|
+
database = tks[0]
|
|
91
|
+
|
|
92
|
+
if len(tks) > 1:
|
|
93
|
+
state.namespace = tks[1]
|
|
94
|
+
|
|
95
|
+
if database:
|
|
96
|
+
state.pg_path = f'{host}/{database}'
|
|
97
|
+
else:
|
|
98
|
+
state.pg_path = host
|
|
99
|
+
|
|
100
|
+
def cd_completion(self, cmd: str, state: ReplState, default: dict = {}):
|
|
101
|
+
return {cmd: {d: None for d in self.direct_dirs(cmd, state, default=default)}}
|
|
102
|
+
|
|
103
|
+
def direct_dirs(self, cmd: str, state: ReplState, default: dict = {}) -> list[str]:
|
|
104
|
+
with pg_path(state) as (host, database):
|
|
105
|
+
if database:
|
|
106
|
+
return ['..']
|
|
107
|
+
elif host:
|
|
108
|
+
return ['..'] + [p for p in pg_database_names(state)]
|
|
109
|
+
else:
|
|
110
|
+
return [p for p in PostgresDatabases.host_names(state.namespace)]
|
|
111
|
+
|
|
112
|
+
def pwd(self, state: ReplState):
|
|
113
|
+
words = []
|
|
114
|
+
|
|
115
|
+
with pg_path(state) as (host, database):
|
|
116
|
+
if host:
|
|
117
|
+
words.append(f'host/{host}')
|
|
118
|
+
if database:
|
|
119
|
+
words.append(f'database/{database}')
|
|
120
|
+
|
|
121
|
+
return '\t'.join([f'{ReplState.P}:>'] + (words if words else ['/']))
|
|
122
|
+
|
|
123
|
+
def try_fallback_action(self, chain: Command, state: ReplState, cmd: str):
|
|
124
|
+
with pg_path(state) as (_, database):
|
|
125
|
+
if not database:
|
|
126
|
+
database = PostgresDatabases.default_db()
|
|
127
|
+
|
|
128
|
+
if database:
|
|
129
|
+
return True, chain.run(f'pg {cmd}', state)
|
|
130
|
+
|
|
131
|
+
return False, None
|
|
132
|
+
|
|
133
|
+
def enter(self, _: ReplState):
|
|
134
|
+
wait_log('Inspecting postgres database instances...')
|
|
135
|
+
|
|
136
|
+
def show_tables(self, state: ReplState):
|
|
137
|
+
tabulize(PostgresDatabases.tables(state, default_schema=True), lambda d: d['name'], separator=',')
|
|
138
|
+
|
|
139
|
+
def show_table_preview(self, state: ReplState, table: str, rows: int):
|
|
140
|
+
PostgresDatabases.run_sql(state, f'select * from {table} limit {rows}')
|
|
141
|
+
|
|
142
|
+
def bash(self, s0: ReplState, s1: ReplState, args: list[str]):
|
|
143
|
+
pod, container = PostgresDatabases.pod_and_container(s1.namespace)
|
|
144
|
+
log2(f'Running on {pod}(container:{container})...')
|
|
145
|
+
|
|
146
|
+
return super().bash(s0, s1, args)
|
|
147
|
+
|
|
148
|
+
def bash_target_changed(self, s0: ReplState, s1: ReplState):
|
|
149
|
+
return s0.pg_path != s1.pg_path
|
|
150
|
+
|
|
151
|
+
def exec_no_dir(self, command: str, state: ReplState):
|
|
152
|
+
with postgres(state) as pod:
|
|
153
|
+
return pod.exec(command, show_out=True)
|
|
154
|
+
|
|
155
|
+
def exec_with_dir(self, command: str, session_just_created: bool, state: ReplState):
|
|
156
|
+
with postgres(state) as pod:
|
|
157
|
+
return pod.exec(command, show_out=not session_just_created)
|
|
158
|
+
|
|
159
|
+
def bash_completion(self, cmd: str, state: ReplState, default: dict = {}):
|
|
160
|
+
return {cmd: BashCompleter(lambda: [])}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
from adam.commands.devices.device import Device
|
|
2
|
+
from adam.commands.devices.device_app import DeviceApp
|
|
3
|
+
from adam.commands.devices.device_auit_log import DeviceAuditLog
|
|
4
|
+
from adam.commands.devices.device_cass import DeviceCass
|
|
5
|
+
from adam.commands.devices.device_export import DeviceExport
|
|
6
|
+
from adam.commands.devices.device_postgres import DevicePostgres
|
|
7
|
+
from adam.repl_state import ReplState
|
|
8
|
+
|
|
9
|
+
class Devices:
|
|
10
|
+
def device(state: ReplState) -> Device:
|
|
11
|
+
if state.device == ReplState.A:
|
|
12
|
+
return DeviceApp()
|
|
13
|
+
elif state.device == ReplState.C:
|
|
14
|
+
return DeviceCass()
|
|
15
|
+
elif state.device == ReplState.L:
|
|
16
|
+
return DeviceAuditLog()
|
|
17
|
+
elif state.device == ReplState.P:
|
|
18
|
+
return DevicePostgres()
|
|
19
|
+
elif state.device == ReplState.X:
|
|
20
|
+
return DeviceExport()
|
|
21
|
+
|
|
22
|
+
return DeviceCass()
|
|
23
|
+
|
|
24
|
+
def all():
|
|
25
|
+
return [DeviceApp(), DeviceCass(), DeviceAuditLog(), DevicePostgres(), DeviceExport()]
|