meerschaum 3.0.0rc2__py3-none-any.whl → 3.0.0rc3__py3-none-any.whl

meerschaum/_internal/shell/Shell.py

@@ -781,10 +781,11 @@ class Shell(cmd.Cmd):
             instance_keys += ':main'
 
         conn_attrs = parse_instance_keys(instance_keys, construct=False, debug=debug)
-        if conn_attrs is None or not conn_attrs:
-            conn_keys = str(get_connector(debug=debug))
-        else:
-            conn_keys = instance_keys
+        conn_keys = (
+            str(get_connector(debug=debug))
+            if conn_attrs is None
+            else instance_keys
+        )
 
         shell_attrs['instance_keys'] = conn_keys
 

meerschaum/actions/bootstrap.py

@@ -429,7 +429,7 @@ def _bootstrap_plugins(
         action = [prompt("Enter the name of your new plugin:")]
 
     for plugin_name in action:
-        bootstrap_success, bootstrap_msg = bootstrap_plugin(plugin_name)
+        bootstrap_success, bootstrap_msg = bootstrap_plugin(plugin_name, debug=debug)
         if not bootstrap_success:
             return bootstrap_success, bootstrap_msg
 

meerschaum/actions/edit.py

@@ -552,7 +552,12 @@ def _edit_tokens(
     dateutil_parser = mrsm.attempt_import('dateutil.parser')
 
     if not action:
-        return False, "Provide token labels or IDs for the tokens to edit."
+        return (
+            False, (
+                "Provide token labels or IDs for the tokens to edit\n"
+                "    (run `show tokens` to see registered tokens)."
+            )
+        )
 
     conn = parse_instance_keys(mrsm_instance)
 
@@ -628,8 +633,6 @@ def _edit_tokens(
 
     return True, msg
 
-        
-
 
 ### NOTE: This must be the final statement of the module.
 ###       Any subactions added below these lines will not

meerschaum/actions/start.py

@@ -676,7 +676,7 @@ def _start_pipeline(
 
     try:
         run_loop()
-    except KeyboardInterrupt:
+    except (KeyboardInterrupt, SystemExit):
         warn("Cancelled pipeline.", stack=False)
         if proc is not None:
             _stop_process(proc)

meerschaum/api/dash/callbacks/__init__.py

@@ -10,6 +10,7 @@ from meerschaum.api import debug as _debug
 import meerschaum.api.dash.callbacks.dashboard
 import meerschaum.api.dash.callbacks.login
 import meerschaum.api.dash.callbacks.plugins
+import meerschaum.api.dash.callbacks.tokens
 import meerschaum.api.dash.callbacks.jobs
 import meerschaum.api.dash.callbacks.register
 import meerschaum.api.dash.callbacks.pipes

meerschaum/api/dash/callbacks/dashboard.py

@@ -72,8 +72,6 @@ keys_state = (
     State({'type': 'input-flags-dropdown', 'index': ALL}, 'value'),
     State({'type': 'input-flags-dropdown-text', 'index': ALL}, 'value'),
     State('instance-select', 'value'),
-    State('content-div-right', 'children'),
-    State('success-alert-div', 'children'),
     State('session-store', 'data'),
 )
 
@@ -103,15 +101,20 @@ omit_actions = {
 _paths = {
     'login'   : pages.login.layout,
     ''        : pages.dashboard.layout,
+    'pipes'   : pages.pipes.layout,
     'plugins' : pages.plugins.layout,
+    'tokens'  : pages.tokens.layout,
     'register': pages.register.layout,
     'pipes'   : pages.pipes.layout,
-    'job'     : pages.job.layout,
+    'jobs'    : pages.jobs.layout,
 }
-_required_login = {''}
+_required_login = {'', 'tokens', 'jobs', 'pipes'}
 _pages = {
     'Web Console': '/dash/',
+    'Pipes': '/dash/pipes',
     'Plugins': '/dash/plugins',
+    'Tokens': '/dash/tokens',
+    'Jobs': '/dash/jobs',
 }
 
 
@@ -495,16 +498,12 @@ def update_flags(input_flags_dropdown_values, n_clicks, input_flags_texts):
 
 @dash_app.callback(
     Output('connector-keys-dropdown', 'options'),
-    Output('connector-keys-list', 'children'),
     Output('connector-keys-dropdown', 'value'),
     Output('metric-keys-dropdown', 'options'),
-    Output('metric-keys-list', 'children'),
     Output('metric-keys-dropdown', 'value'),
     Output('location-keys-dropdown', 'options'),
-    Output('location-keys-list', 'children'),
     Output('location-keys-dropdown', 'value'),
     Output('tags-dropdown', 'options'),
-    Output('tags-list', 'children'),
     Output('tags-dropdown', 'value'),
     Output('instance-select', 'value'),
     Output('instance-alert-div', 'children'),
@@ -664,22 +663,14 @@ def update_keys_options(
             for _tag in _tags_options
         ]
     ]
-    _connectors_datalist = [html.Option(value=o['value']) for o in _connectors_options]
-    _metrics_datalist = [html.Option(value=o['value']) for o in _metrics_options]
-    _locations_datalist = [html.Option(value=o['value']) for o in _locations_options]
-    _tags_datalist = [html.Option(value=o['value']) for o in _tags_options]
     return (
         _connectors_options,
-        _connectors_datalist,
         connector_keys,
         _metrics_options,
-        _metrics_datalist,
         metric_keys,
         _locations_options,
-        _locations_datalist,
         location_keys,
         _tags_options,
-        _tags_datalist,
         tags,
         (instance_keys if update_instance_keys else dash.no_update),
         instance_alerts,
@@ -856,6 +847,7 @@ dash_app.clientside_callback(
 @dash_app.callback(
     Output("download-dataframe-csv", "data"),
     Input({'type': 'pipe-download-csv-button', 'index': ALL}, 'n_clicks'),
+    prevent_initial_call=True,
 )
 def download_pipe_csv(n_clicks):
     """
@@ -885,6 +877,7 @@ def download_pipe_csv(n_clicks):
     Output({'type': 'pipe-accordion', 'index': MATCH}, 'children'),
     Input({'type': 'pipe-accordion', 'index': MATCH}, 'active_item'),
     State('session-store', 'data'),
+    prevent_initial_call=True,
 )
 def update_pipe_accordion(item, session_store_data):
     """
@@ -908,7 +901,8 @@ def update_pipe_accordion(item, session_store_data):
 @dash_app.callback(
     Output({'type': 'update-parameters-success-div', 'index': MATCH}, 'children'),
     Input({'type': 'update-parameters-button', 'index': MATCH}, 'n_clicks'),
-    State({'type': 'parameters-editor', 'index': MATCH}, 'value')
+    State({'type': 'parameters-editor', 'index': MATCH}, 'value'),
+    prevent_initial_call=True,
 )
 def update_pipe_parameters_click(n_clicks, parameters_editor_text):
     if not n_clicks:
@@ -942,6 +936,7 @@ def update_pipe_parameters_click(n_clicks, parameters_editor_text):
     Output({'type': 'update-sql-success-div', 'index': MATCH}, 'children'),
     Input({'type': 'update-sql-button', 'index': MATCH}, 'n_clicks'),
     State({'type': 'sql-editor', 'index': MATCH}, 'value'),
+    prevent_initial_call=True,
 )
 def update_pipe_sql_click(n_clicks, sql_editor_text):
     if not n_clicks:
@@ -968,7 +963,8 @@ def update_pipe_sql_click(n_clicks, sql_editor_text):
 @dash_app.callback(
     Output({'type': 'sync-success-div', 'index': MATCH}, 'children'),
     Input({'type': 'update-sync-button', 'index': MATCH}, 'n_clicks'),
-    State({'type': 'sync-editor', 'index': MATCH}, 'value')
+    State({'type': 'sync-editor', 'index': MATCH}, 'value'),
+    prevent_initial_call=True,
 )
 def sync_documents_click(n_clicks, sync_editor_text):
     if not n_clicks:
@@ -1014,6 +1010,7 @@ def sync_documents_click(n_clicks, sync_editor_text):
     State({'type': 'limit-input', 'index': MATCH}, 'value'),
     State({'type': 'query-data-begin-input', 'index': MATCH}, 'value'),
     State({'type': 'query-data-end-input', 'index': MATCH}, 'value'),
+    prevent_initial_call=True,
 )
 def query_data_click(n_clicks, query_editor_text, limit_value, begin, end):
     triggered = dash.callback_context.triggered
@@ -1130,6 +1127,7 @@ def toggle_navbar_collapse(n_clicks: Optional[int], is_open: bool) -> bool:
     Output('session-store', 'data'),
     Input("sign-out-button", "n_clicks"),
     State('session-store', 'data'),
+    prevent_initial_call=True,
 )
 def sign_out_button_click(
     n_clicks: Optional[int],
@@ -1150,6 +1148,7 @@ def sign_out_button_click(
     Output({'type': 'parameters-editor', 'index': MATCH}, 'value'),
     Input({'type': 'parameters-as-yaml-button', 'index': MATCH}, 'n_clicks'),
     Input({'type': 'parameters-as-json-button', 'index': MATCH}, 'n_clicks'),
+    prevent_initial_call=True,
 )
 def parameters_as_yaml_or_json_click(
     yaml_n_clicks: Optional[int],
@@ -1178,6 +1177,7 @@ def parameters_as_yaml_or_json_click(
     Output({'type': 'sync-editor', 'index': MATCH}, 'value'),
     Input({'type': 'sync-as-json-button', 'index': MATCH}, 'n_clicks'),
     Input({'type': 'sync-as-lines-button', 'index': MATCH}, 'n_clicks'),
+    prevent_initial_call=True,
 )
 def sync_as_json_or_lines_click(
     json_n_clicks: Optional[int],
@@ -1206,6 +1206,7 @@ def sync_as_json_or_lines_click(
     Output('pages-offcanvas', 'children'),
     Input('logo-img', 'n_clicks'),
     State('pages-offcanvas', 'is_open'),
+    prevent_initial_call=True,
 )
 def toggle_pages_offcanvas(n_clicks: Optional[int], is_open: bool):
     """

meerschaum/api/dash/callbacks/jobs.py

@@ -13,12 +13,13 @@ import time
 import traceback
 from datetime import datetime, timezone
 
+from meerschaum.jobs import get_jobs
 from meerschaum.utils.typing import Optional, Dict, Any
 from meerschaum.api import CHECK_UPDATE
 from meerschaum.api.dash import dash_app
 from meerschaum.api.dash.sessions import get_username_from_session
 from meerschaum.utils.packages import attempt_import, import_dcc, import_html
-from meerschaum.api.dash.components import alert_from_success_tuple
+from meerschaum.api.dash.components import alert_from_success_tuple, build_cards_grid
 from meerschaum.api.dash.jobs import (
     build_job_card,
     build_manage_job_buttons_div_children,
@@ -251,17 +252,22 @@ def render_job_page_from_url(
     session_data: Optional[Dict[str, Any]],
 ):
     """
-    Load the `/job/{name}` page.
+    Load the `/dash/jobs/{name}` page.
     """
-    if not str(pathname).startswith('/dash/job'):
+    if not str(pathname).startswith('/dash/jobs'):
         return no_update
 
     session_id = (session_data or {}).get('session-id', None)
     authenticated = is_session_authenticated(str(session_id))
 
-    job_name = pathname.replace('/dash/job', '').lstrip('/').rstrip('/')
+    job_name = pathname.replace('/dash/jobs', '').lstrip('/').rstrip('/')
     if not job_name:
-        return no_update
+        jobs = get_jobs(executor_keys='local', combine_local_and_systemd=True)
+        cards = [
+            build_job_card(job, authenticated=authenticated, include_follow=False)
+            for job in jobs.values()
+        ]
+        return [html.Br(), build_cards_grid(cards, 3), html.Br()]
 
     job = _get_job(job_name)
     if not job.exists():

meerschaum/api/dash/callbacks/pipes.py

@@ -9,11 +9,17 @@ from urllib.parse import parse_qs
 
 from dash.dependencies import Input, Output, State
 from dash import no_update
+from dash.exceptions import PreventUpdate
 
 import meerschaum as mrsm
 from meerschaum.api.dash import dash_app
-from meerschaum.api.dash.pipes import build_pipe_card
-from meerschaum.api import CHECK_UPDATE
+from meerschaum.api.dash.components import alert_from_success_tuple, build_cards_grid
+from meerschaum.api.dash.pipes import (
+    build_pipe_card,
+    build_pipes_dropdown_keys_row,
+    build_pipes_tags_dropdown,
+)
+from meerschaum.api import CHECK_UPDATE, get_api_connector
 from meerschaum.utils.packages import import_html, import_dcc
 from meerschaum.api.dash.sessions import is_session_authenticated
 from meerschaum.utils.typing import Optional, Dict, Any
@@ -36,16 +42,74 @@ def render_pipe_page_from_url(
 
     session_id = (session_data or {}).get('session-id', None)
     authenticated = is_session_authenticated(str(session_id))
+    query_params = parse_qs(pipe_search.lstrip('?')) if pipe_search else {}
+    instance = query_params.get('instance', [None])[0] or str(get_api_connector())
+    tags = query_params.get('tags', [None])[0] or []
+    if isinstance(tags, str):
+        tags = tags.split(',')
+
+    connector_keys = query_params.get('connector_keys', [None])[0] or []
+    if isinstance(connector_keys, str):
+        connector_keys = connector_keys.split(',')
+
+    metric_keys = query_params.get('metric_keys', [None])[0] or []
+    if isinstance(metric_keys, str):
+        metric_keys = metric_keys.split(',')
+
+    location_keys = query_params.get('location_keys', [None])[0] or []
+    if isinstance(location_keys, str):
+        location_keys = location_keys.split(',')
+
+    instance_connector = mrsm.get_connector(instance)
+    if instance_connector is None:
+        return [
+            html.Br(),
+            alert_from_success_tuple((False, f"Invalid instance keys '{instance}'.")),
+            html.Br(),
+        ]
 
     keys = pathname.replace('/dash/pipes', '').lstrip('/').rstrip('/').split('/')
     if len(keys) not in (2, 3):
-        return no_update
+        pipes = mrsm.get_pipes(
+            as_list=True,
+            connector_keys=connector_keys,
+            metric_keys=metric_keys,
+            location_keys=location_keys,
+            tags=tags,
+            instance=instance_connector,
+        )
+        cards = [
+            build_pipe_card(pipe, authenticated=authenticated, include_manage=False)
+            for pipe in pipes
+        ]
+        return [
+            html.Div([
+                html.Br(),
+                build_pipes_dropdown_keys_row(
+                    connector_keys,
+                    metric_keys,
+                    location_keys,
+                    tags,
+                    pipes,
+                    instance_connector,
+                ),
+                html.Br(),
+                build_pipes_tags_dropdown(
+                    connector_keys,
+                    metric_keys,
+                    location_keys,
+                    tags,
+                    instance,
+                ),
+            ]),
+            html.Br(),
+            build_cards_grid(cards, 1),
+            html.Br(),
+        ]
 
     ck = keys[0]
     mk = keys[1]
     lk = keys[2] if len(keys) == 3 else None
-    query_params = parse_qs(pipe_search.lstrip('?')) if pipe_search else {}
-    instance = query_params.get('instance', [None])[0]
 
     pipe = mrsm.Pipe(ck, mk, lk, instance=instance)
     return [
@@ -53,3 +117,40 @@ def render_pipe_page_from_url(
         build_pipe_card(pipe, authenticated=authenticated, include_manage=False),
         html.Br(),
     ]
+
+
+@dash_app.callback(
+    Output('pipes-location', 'search'),
+    Input('pipes-connector-keys-dropdown', 'value'),
+    Input('pipes-metric-keys-dropdown', 'value'),
+    Input('pipes-location-keys-dropdown', 'value'),
+    Input('pipes-tags-dropdown', 'value'),
+)
+def update_location_on_pipes_filter_change(connector_keys, metric_keys, location_keys, tags):
+    """
+    Update the URL parameters when clicking the dropdowns.
+    """
+    if not any((connector_keys or []) + (metric_keys or []) + (location_keys or []) + (tags or [])):
+        return ''
+
+    search_str = "?"
+    
+    if connector_keys:
+        search_str += "connector_keys=" + ','.join(connector_keys)
+        if metric_keys or location_keys or tags:
+            search_str += '&'
+
+    if metric_keys:
+        search_str += "metric_keys=" + ','.join(metric_keys)
+        if location_keys or tags:
+            search_str += '&'
+
+    if location_keys:
+        search_str += "location_keys=" + ','.join(location_keys)
+        if tags:
+            search_str += '&'
+
+    if tags:
+        search_str += "tags=" + ','.join(tags)
+
+    return search_str

meerschaum/api/dash/callbacks/settings/__init__.py

@@ -6,4 +6,3 @@ Define the callbacks for the settings pages.
 """
 
 import meerschaum.api.dash.callbacks.settings.password_reset
-import meerschaum.api.dash.callbacks.settings.tokens

meerschaum/api/dash/callbacks/{settings/tokens.py → tokens.py}

@@ -163,7 +163,7 @@ def register_token_click(
     token = Token(
         label=(name or None),
         user=get_user_from_session(session_id),
-        expiration=(datetime.fromisoformat(f"{expiration}T00:00:00Z") if expiration is not None else None),
+        expiration=(datetime.fromisoformat(f"{expiration}") if expiration is not None else None),
     )
     return False, True, build_tokens_register_output_modal(token)
 

meerschaum/api/dash/jobs.py

@@ -98,7 +98,7 @@ def build_job_card(
             html.B(
                 html.A(
                     "🔗 " + job.name,
-                    href=f"/dash/job/{job.name}",
+                    href=f"/dash/jobs/{job.name}",
                     target="_blank",
                     style={
                         'color': 'white',

meerschaum/api/dash/pages/__init__.py

@@ -9,7 +9,8 @@ import meerschaum.api.dash.pages.error
 import meerschaum.api.dash.pages.login
 import meerschaum.api.dash.pages.dashboard
 import meerschaum.api.dash.pages.plugins
+import meerschaum.api.dash.pages.tokens
 import meerschaum.api.dash.pages.register
 import meerschaum.api.dash.pages.pipes
-import meerschaum.api.dash.pages.job
+import meerschaum.api.dash.pages.jobs
 import meerschaum.api.dash.pages.settings

meerschaum/api/dash/pages/{job.py → jobs.py}

@@ -11,11 +11,14 @@ from meerschaum.utils.packages import import_html, import_dcc
 html, dcc = import_html(check_update=CHECK_UPDATE), import_dcc(check_update=CHECK_UPDATE)
 import dash_bootstrap_components as dbc
 
-from meerschaum.api.dash.components import download_logs, refresh_jobs_interval
+from meerschaum.api.dash.components import download_logs, refresh_jobs_interval, pages_navbar
 
-layout = dbc.Container([
-    dcc.Location('job-location'),
-    html.Div(id='job-output-div'),
-    download_logs,
-    refresh_jobs_interval,
-])
+layout = [
+    pages_navbar,
+    dbc.Container([
+        dcc.Location('job-location'),
+        html.Div(id='job-output-div'),
+        download_logs,
+        refresh_jobs_interval,
+    ]),
+]

meerschaum/api/dash/pages/pipes.py

@@ -7,16 +7,17 @@ Display pipes via a shareable URL.
 
 from meerschaum.api import CHECK_UPDATE
 from meerschaum.utils.packages import import_html, import_dcc
-from meerschaum.api.dash.components import download_dataframe, pages_navbar
+from meerschaum.api.dash.components import download_dataframe, pages_navbar, navbar
 
 html, dcc = import_html(check_update=CHECK_UPDATE), import_dcc(check_update=CHECK_UPDATE)
 import dash_bootstrap_components as dbc
 
+
 layout = [
     pages_navbar,
+    dcc.Location('pipes-location'),
+    download_dataframe,
     dbc.Container([
-        dcc.Location('pipes-location'),
-        download_dataframe,
         html.Div(id='pipe-output-div'),
     ])
 ]

meerschaum/api/dash/pages/settings/__init__.py

@@ -6,4 +6,3 @@ Define the layouts for the `settings` pages.
 """
 
 import meerschaum.api.dash.pages.settings.password_reset
-import meerschaum.api.dash.pages.settings.tokens

meerschaum/api/dash/pages/{settings/tokens.py → tokens.py}

@@ -8,16 +8,13 @@ Define the tokens page layout.
 import dash_bootstrap_components as dbc
 import dash.html as html
 import dash.dcc as dcc
-from meerschaum.plugins import web_page
 from meerschaum._internal.static import STATIC_CONFIG
+from meerschaum.api.dash.components import pages_navbar
 
 
-@web_page('tokens', login_required=True, page_group='Settings')
-def page_layout():
-    """
-    Return the layout for the tokens page.
-    """
-    return dbc.Container([
+layout = [
+    pages_navbar,
+    dbc.Container([
         html.Br(), 
         html.H3('Tokens'),
         html.Div(id="tokens-alert-div"),
@@ -52,4 +49,5 @@ def page_layout():
             style={'text-align': 'right'},
         ),
         html.Div(id='tokens-output-div'),
-    ])
+    ]),
+]

meerschaum/api/dash/pipes.py

@@ -12,6 +12,7 @@ import shlex
 from textwrap import dedent
 from urllib.parse import urlencode
 
+from meerschaum.utils import fetch_pipes_keys
 from meerschaum.utils.typing import List, Optional, Dict, Any, Tuple, Union
 from meerschaum.utils.misc import string_to_dict
 from meerschaum.utils.packages import attempt_import, import_dcc, import_html, import_pandas
@@ -817,3 +818,133 @@ def get_backtrack_text(
         json_text = '[]'
 
     return json.dumps(json.loads(json_text), indent=4, separators=(',', ': '))
+
+
+def build_pipes_dropdown_keys_row(
+    connector_keys: List[str],
+    metric_keys: List[str],
+    location_keys: List[str],
+    tags: List[str],
+    pipes: List[mrsm.Pipe],
+    instance_connector: mrsm.connectors.InstanceConnector,
+) -> dbc.Row:
+    """
+    Return the dropdown keys row for the dedicated pipes page.
+    """
+    ck_alone = connector_keys and not any([str(x) for x in (tags + metric_keys + location_keys)])
+    mk_alone = metric_keys and not any([str(x) for x in (connector_keys + tags + location_keys)])
+    lk_alone = location_keys and not any([str(x) for x in (connector_keys + metric_keys + tags)])
+    all_keys = fetch_pipes_keys('registered', instance_connector)
+    return dbc.Row(
+        [
+            dbc.Col(
+                html.Div(
+                    [
+                        dcc.Dropdown(
+                            id='pipes-connector-keys-dropdown',
+                            options=(
+                                sorted(list({pipe.connector_keys for pipe in pipes}))
+                                if not ck_alone
+                                else sorted(list({ck for ck, _, _ in all_keys}))
+                            ),
+                            value=[str(ck) for ck in connector_keys],
+                            placeholder='Connectors',
+                            multi=True,
+                        ),
+                    ],
+                    className='dbc_dark',
+                ),
+                lg=4,
+                md=12,
+                sm=12,
+            ),
+            dbc.Col(
+                html.Div(
+                    [
+                        dcc.Dropdown(
+                            id='pipes-metric-keys-dropdown',
+                            options=(
+                                sorted(list({pipe.metric_key for pipe in pipes}))
+                                if not mk_alone
+                                else sorted(list({mk for _, mk, _ in all_keys}))
+                            ),
+                            value=[str(mk) for mk in metric_keys],
+                            placeholder='Metrics',
+                            multi=True,
+                        ),
+                    ],
+                    className='dbc_dark'
+                ),
+                lg=4,
+                md=12,
+                sm=12,
+            ),
+            dbc.Col(
+                html.Div(
+                    [
+                        dcc.Dropdown(
+                            id='pipes-location-keys-dropdown',
+                            options=(
+                                sorted(list({str(pipe.location_key) for pipe in pipes}))
+                                if not lk_alone
+                                else sorted(list({str(lk) for _, _, lk in all_keys}))
+                            ),
+                            value=[str(lk) for lk in location_keys],
+                            placeholder='Locations',
+                            multi=True,
+                        ),
+                    ],
+                    className='dbc_dark'
+                ),
+                lg=4,
+                md=12,
+                sm=12,
+            ),
+        ] ### end of filters row children
+    )
+
+
+def build_pipes_tags_dropdown(
+    connector_keys: List[str],
+    metric_keys: List[str],
+    location_keys: List[str],
+    tags: List[str],
+    instance: str,
+) -> html.Div:
+    """
+    Build the tags dropdown for the dedicated pipes page.
+    """
+    _tags_alone = tags and not any([str(x) for x in (connector_keys + metric_keys + location_keys)])
+    _tags_pipes = mrsm.get_pipes(
+        connector_keys=connector_keys,
+        metric_keys=metric_keys,
+        location_keys=location_keys,
+        tags=tags,
+        instance=instance,
+        as_tags_dict=True,
+    )
+
+    _all_tags = list(
+        mrsm.get_pipes(
+            instance=instance,
+            as_tags_dict=True,
+        )
+    ) if _tags_alone else []
+
+    tags_options = [
+        str(tag)
+        for tag in (_all_tags if _tags_alone else _tags_pipes)
+    ]
+
+    return html.Div(
+        dcc.Dropdown(
+            id='pipes-tags-dropdown',
+            options=tags_options,
+            value=tags,
+            placeholder='Tags',
+            multi=True,
+            searchable=True,
+        ),
+        className="dbc_dark",
+        id="pipes-tags-dropdown-div",
+    )