meerschaum 2.7.8__tar.gz → 2.7.9__tar.gz

{meerschaum-2.7.8/meerschaum.egg-info → meerschaum-2.7.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: meerschaum
-Version: 2.7.8
+Version: 2.7.9
 Summary: Sync Time-Series Pipes with Meerschaum
 Home-page: https://meerschaum.io
 Author: Bennett Meares

meerschaum-2.7.9/meerschaum/_internal/term/TermPageHandler.py

@@ -0,0 +1,70 @@
+#! /usr/bin/env python3
+# -*- coding: utf-8 -*-
+# vim:fenc=utf-8
+
+"""
+Define the terminal page handler class.
+"""
+
+from __future__ import annotations
+from typing import Any
+
+import meerschaum as mrsm
+from meerschaum.utils.warnings import warn
+tornado_web = mrsm.attempt_import('tornado.web', lazy=False)
+terminado = mrsm.attempt_import('terminado', lazy=False)
+
+tmux_suffix = mrsm.get_config('system', 'webterm', 'tmux', 'session_suffix')
+
+
+class TermPageHandler(tornado_web.RequestHandler):
+
+    def get(self, term_name):
+        term_manager = self.application.settings['term_manager']
+        shell_command = [
+            cmd.replace('MRSM_SESSION', term_name + tmux_suffix)
+            for cmd in term_manager.shell_command
+        ]
+        terminal = term_manager.new_terminal(shell_command=shell_command)
+        terminal.term_name = term_name
+        term_manager.terminals[term_name] = terminal
+        term_manager.start_reading(terminal)
+        return self.render(
+            "termpage.html",
+            static=self.static_url,
+            ws_url_path=f"/_websocket/{term_name}",
+        )
+
+
+class CustomTermSocket(terminado.TermSocket):
+
+    def open(self, url_component: Any = None) -> None:
+        super(terminado.TermSocket, self).open(url_component)
+        url_component = (
+            url_component.decode("utf-8")
+            if isinstance(url_component, bytes)
+            else url_component
+        )
+        self.term_name = url_component
+        shell_command = [
+            cmd.replace('MRSM_SESSION', self.term_name + tmux_suffix)
+            for cmd in self.term_manager.shell_command
+        ]
+        if self.term_name not in self.term_manager.terminals:
+            self.terminal = self.term_manager.new_terminal(shell_command=shell_command)
+            self.terminal.term_name = self.term_name
+            self.term_manager.terminals[self.term_name] = self.terminal
+            self.term_manager.start_reading(self.terminal)
+        else:
+            self.terminal = self.term_manager.terminals[self.term_name]
+        self.terminal.clients.append(self)
+        self.send_json_message(["setup", {}])
+        buffered = ""
+        preopen_buffer = self.terminal.read_buffer.copy()
+        while True:
+            if not preopen_buffer:
+                break
+            s = preopen_buffer.popleft()
+            buffered += s
+        if buffered:
+            self.on_pty_read(buffered)

{meerschaum-2.7.8 → meerschaum-2.7.9}/meerschaum/_internal/term/__init__.py

@@ -9,10 +9,14 @@ Build the web console virtual terminal using Tornado and xterm.js.
 from __future__ import annotations
 
 from typing import Optional, Tuple
+
+import meerschaum as mrsm
 from meerschaum.utils.packages import attempt_import
-from meerschaum._internal.term.TermPageHandler import TermPageHandler
+from meerschaum._internal.term.TermPageHandler import TermPageHandler, CustomTermSocket
 from meerschaum.config._paths import API_TEMPLATES_PATH, API_STATIC_PATH
 from meerschaum.utils.venv import venv_executable
+from meerschaum.utils.misc import is_tmux_available
+from meerschaum.utils.daemon._names import get_new_daemon_name
 
 tornado, tornado_ioloop, terminado = attempt_import(
     'tornado', 'tornado.ioloop', 'terminado', lazy=False,
@@ -40,16 +44,19 @@ def get_webterm_app_and_manager(
         "from meerschaum._internal.entry import get_shell; "
         f"get_shell({shell_kwargs_str}).cmdloop()"
     ]
+    webterm_cf = mrsm.get_config('system', 'webterm')
+    if webterm_cf.get('tmux', {}).get('enabled', False) and is_tmux_available():
+        commands = ['tmux', 'new-session', '-A', '-s', 'MRSM_SESSION'] + commands
 
-    term_manager = terminado.UniqueTermManager(shell_command=commands)
+    term_manager = terminado.NamedTermManager(shell_command=commands)
     handlers = [
         (
-            r"/websocket",
-            terminado.TermSocket,
+            r"/_websocket/(.+)/?",
+            CustomTermSocket,
             {'term_manager': term_manager}
         ),
         (
-            r"/",
+            r"/webterm/(.+)/?",
             TermPageHandler
         ),
     ]
@@ -57,5 +64,6 @@ def get_webterm_app_and_manager(
         handlers,
         static_path=API_STATIC_PATH,
         template_path=API_TEMPLATES_PATH,
+        term_manager=term_manager,
     )
     return tornado_app, term_manager

meerschaum-2.7.9/meerschaum/_internal/term/tools.py

@@ -0,0 +1,60 @@
+#! /usr/bin/env python3
+# -*- coding: utf-8 -*-
+# vim:fenc=utf-8
+
+"""
+Utility functions regarding the webterm.
+"""
+
+import meerschaum as mrsm
+from meerschaum.utils.typing import List
+
+
+def is_webterm_running(
+    host: str,
+    port: int,
+    protocol: str = 'http',
+    session_id: str = 'mrsm',
+) -> int:
+    """
+    Determine whether the webterm service is running on a given host and port.
+    """
+    requests = mrsm.attempt_import('requests', lazy=False)
+    url = f'{protocol}://{host}:{port}/webterm/{session_id}'
+    try:
+        r = requests.get(url, timeout=3)
+    except Exception as e:
+        return False
+    if not r:
+        return False
+    return '<title>Meerschaum Shell</title>' in r.text
+
+
+def kill_tmux_session(session: str) -> bool:
+    """
+    Kill a tmux session if it exists.
+    """
+    from meerschaum.utils.process import run_process
+    command = ['tmux', 'kill-session', '-t', session]
+    return run_process(command, capture_output=True) == 0
+
+
+def get_mrsm_tmux_sessions() -> List[str]:
+    """
+    Return a list of tmux sessions created by Meerschaum.
+    """
+    from meerschaum.utils.process import run_process
+    tmux_suffix = mrsm.get_config('system', 'webterm', 'tmux', 'session_suffix')
+    command = ['tmux', 'ls']
+    proc = run_process(command, capture_output=True, as_proc=True)
+    if proc.returncode != 0:
+        return []
+    sessions = [
+        line.split(':', maxsplit=1)[0]
+        for line in proc.stdout.read().decode('utf-8').split('\n')
+    ]
+    return [
+        session
+        for session in sessions
+        if session.endswith(tmux_suffix)
+    ]

{meerschaum-2.7.8 → meerschaum-2.7.9}/meerschaum/actions/start.py

@@ -314,6 +314,11 @@ def _start_gui(
     """
     Start the Meerschaum GUI application.
     """
+    import json
+    import time
+    import uuid
+    import platform
+
     from meerschaum.utils.venv import venv_exec
     from meerschaum.utils.packages import attempt_import
     from meerschaum.utils.warnings import warn
@@ -321,17 +326,14 @@ def _start_gui(
     from meerschaum.utils.networking import find_open_ports
     from meerschaum.connectors.parse import parse_instance_keys
     from meerschaum._internal.term.tools import is_webterm_running
-    import platform
     webview, requests = attempt_import('webview', 'requests')
-    import json
-    import time
 
     success, msg = True, "Success"
     host = '127.0.0.1'
     if port is None:
         port = 8765
 
-    if not is_webterm_running(host, port):
+    if not is_webterm_running(host, port, session_id='mrsm'):
         port = next(find_open_ports(port, 9000))
 
     api_kw = {
@@ -350,7 +352,7 @@ def _start_gui(
     )
     if debug:
         print(start_tornado_code)
-    base_url = 'http://' + api_kw['host'] + ':' + str(api_kw['port'])
+    base_url = 'http://' + api_kw['host'] + ':' + str(api_kw['port']) + '/webterm/mrsm'
 
     process = venv_exec(
         start_tornado_code, as_proc=True, debug=debug, capture_output=(not debug)
@@ -375,7 +377,7 @@ def _start_gui(
     try:
         webview.create_window(
             'Meerschaum Shell', 
-            f'http://127.0.0.1:{port}',
+            f'http://127.0.0.1:{port}/webterm/mrsm',
             height=650,
             width=1000
         )
@@ -415,8 +417,13 @@ def _start_webterm(
         - `-i`, '--instance'
             The default instance to use for the Webterm shell.
     """
+    import uuid
     from meerschaum._internal.term import get_webterm_app_and_manager, tornado_ioloop
-    from meerschaum._internal.term.tools import is_webterm_running
+    from meerschaum._internal.term.tools import (
+        is_webterm_running,
+        get_mrsm_tmux_sessions,
+        kill_tmux_session,
+    )
     from meerschaum.utils.networking import find_open_ports
     from meerschaum.utils.warnings import info
 
@@ -426,19 +433,23 @@ def _start_webterm(
         port = 8765
     if sysargs is None:
         sysargs = ['start', 'webterm']
+    session_id = 'mrsm'
     tornado_app, term_manager = get_webterm_app_and_manager(instance_keys=mrsm_instance)
 
-    if is_webterm_running(host, port):
+    if is_webterm_running(host, port, session_id=session_id):
         if force:
             port = next(find_open_ports(port + 1, 9000))
         else:
             return False, (
-                f"The webterm is already running at http://{host}:{port}\n\n"
+                f"The webterm is already running at http://{host}:{port}/webterm/{session_id}\n\n"
                 + "    Include `-f` to start another server on a new port\n"
                 + "    or specify a different port with `-p`."
             )
     if not nopretty:
-        info(f"Starting the webterm at http://{host}:{port} ...\n    Press CTRL+C to quit.")
+        info(
+            f"Starting the webterm at http://{host}:{port}/webterm/{session_id} ..."
+            "\n    Press CTRL+C to quit."
+        )
     tornado_app.listen(port, host)
     loop = tornado_ioloop.IOLoop.instance()
     try:
@@ -451,6 +462,10 @@ def _start_webterm(
         term_manager.shutdown()
         loop.close()
 
+    sessions = get_mrsm_tmux_sessions()
+    for session in sessions:
+        kill_tmux_session(session)
+
     return True, "Success"
 
 

{meerschaum-2.7.8 → meerschaum-2.7.9}/meerschaum/api/dash/callbacks/dashboard.py

@@ -190,6 +190,7 @@ def update_page_layout_div(
     Input('go-button', 'n_clicks'),
     Input('get-pipes-button', 'n_clicks'),
     Input('get-jobs-button', 'n_clicks'),
+    Input('show-webterm-button', 'n_clicks'),
     Input('get-plugins-button', 'n_clicks'),
     Input('get-users-button', 'n_clicks'),
     Input('get-graphs-button', 'n_clicks'),
@@ -229,7 +230,7 @@ def update_content(*args):
     ### NOTE: functions MUST return a list of content and a list of alerts
     triggers = {
         'go-button': lambda x: ([], []),
-        'cancel-button': lambda x: ([], []),
+        'show-webterm-button': lambda x: ([], []),
         'get-pipes-button': get_pipes_cards,
         'get-jobs-button': get_jobs_cards,
         'get-plugins-button': get_plugins_cards,
@@ -251,7 +252,12 @@ def update_content(*args):
     webterm_style = {
         'display': (
             'none'
-            if trigger not in ('instance-select', 'cancel-button', 'go-button')
+            if trigger not in (
+                'instance-select',
+                'cancel-button',
+                'go-button',
+                'show-webterm-button',
+            )
             else 'block'
         )
     }
@@ -650,6 +656,41 @@ dash_app.clientside_callback(
     State('mrsm-location', 'href'),
 )
 
+dash_app.clientside_callback(
+    """
+    function(n_clicks, url){
+        if (!n_clicks) { return dash_clientside.no_update; }
+        iframe = document.getElementById('webterm-iframe');
+        if (!iframe){ return dash_clientside.no_update; }
+
+        iframe.contentWindow.postMessage(
+            {
+                action: "__TMUX_NEW_WINDOW"
+            },
+            url
+        );
+        return dash_clientside.no_update;
+    }
+    """,
+    Output('mrsm-location', 'href'),
+    Input('webterm-new-tab-button', 'n_clicks'),
+    State('mrsm-location', 'href'),
+)
+
+dash_app.clientside_callback(
+    """
+    function(n_clicks, url){
+        if (!n_clicks) { return dash_clientside.no_update; }
+        iframe = document.getElementById('webterm-iframe');
+        if (!iframe){ return dash_clientside.no_update; }
+        iframe.src = iframe.src;
+        return dash_clientside.no_update;
+    }
+    """,
+    Output('mrsm-location', 'href'),
+    Input('webterm-refresh-button', 'n_clicks'),
+    State('mrsm-location', 'href'),
+)
 
 @dash_app.callback(
     Output(component_id='connector-keys-input', component_property='value'),

{meerschaum-2.7.8 → meerschaum-2.7.9}/meerschaum/api/dash/components.py

@@ -23,7 +23,7 @@ dex = attempt_import('dash_extensions', lazy=False, check_update=CHECK_UPDATE)
 dash_ace = attempt_import('dash_ace', lazy=False, check_update=CHECK_UPDATE)
 _load_builtin_custom_connectors()
 
-go_button = dbc.Button('Execute', id='go-button', color='primary', style={'width': '100%'})
+go_button = dbc.Button('Exec', id='go-button', color='primary', style={'width': '100%'})
 test_button = dbc.Button('Test', id='test-button', color='danger', style={'display': 'none'})
 get_items_menu = dbc.DropdownMenu(
     label='More', id='get-items-menu', children=[
@@ -50,19 +50,26 @@ show_jobs_button = dbc.Button(
     style={'width': '100%'},
 )
 cancel_button = dbc.Button(
-    'Terminal',
+    'Term',
     id='cancel-button',
     color='dark',
     style={'width': '100%', 'background-color': 'black', 'display': 'none'},
 )
+show_webterm_button = dbc.Button(
+    'Term',
+    id='show-webterm-button',
+    color='dark',
+    style={'width': '100%', 'background-color': 'black'},
+)
 bottom_buttons_content = dbc.Card(
     dbc.CardBody(
         dbc.Row([
-            dbc.Col(go_button, lg=3, md=4, sm=12),
-            dbc.Col(show_pipes_button, lg=3, md=4, sm=12),
-            dbc.Col(show_jobs_button, lg=3, md=4, sm=12),
+            dbc.Col(go_button, xl=2, lg=3, md=3, sm=12),
+            dbc.Col(show_pipes_button, xl=2, lg=3, md=3, sm=12),
+            dbc.Col(show_jobs_button, xl=2, lg=3, md=3, sm=12),
+            dbc.Col(show_webterm_button, xl=2, lg=3, md=3, sm=12),
             dbc.Col(lg=True, md=False, sm=False),
-            dbc.Col(get_items_menu, lg=2, md=12, sm=12),
+            dbc.Col(get_items_menu, xl=2, lg=12, md=12, sm=12),
         ])
     )
 )