meerschaum 2.9.4__tar.gz → 3.0.0__tar.gz

meerschaum-3.0.0/MANIFEST.in

@@ -0,0 +1,2 @@
+prune tests
+prune docs

meerschaum-3.0.0/NOTICE

@@ -0,0 +1,2 @@
+Consult the text file 'ACKNOWLEDGEMENTS.md' for licensing information regarding dynamically linked dependencies.
+

{meerschaum-2.9.4 → meerschaum-3.0.0}/PKG-INFO

@@ -1,12 +1,10 @@
 Metadata-Version: 2.4
 Name: meerschaum
-Version: 2.9.4
+Version: 3.0.0
 Summary: Sync Time-Series Pipes with Meerschaum
-Home-page: https://meerschaum.io
-Author: Bennett Meares
-Author-email: bennett.meares@gmail.com
-Maintainer-email: bennett.meares@gmail.com
-License: Apache Software License 2.0
+Author-email: Bennett Meares <bennett.meares@gmail.com>
+Maintainer-email: Bennett Meares <bennett.meares@gmail.com>
+License-Expression: Apache-2.0
 Project-URL: Documentation, https://docs.meerschaum.io
 Project-URL: Changelog, https://meerschaum.io/news/changelog
 Project-URL: GitHub, https://github.com/bmeares/Meerschaum
@@ -29,6 +27,7 @@ Classifier: Natural Language :: English
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
+License-File: NOTICE
 Provides-Extra: required
 Provides-Extra: minimal
 Provides-Extra: formatting
@@ -63,14 +62,16 @@ Requires-Dist: fasteners>=0.19.0; extra == "core"
 Requires-Dist: virtualenv>=20.1.0; extra == "core"
 Requires-Dist: attrs>=24.2.0; extra == "core"
 Requires-Dist: uv>=0.2.11; extra == "core"
+Requires-Dist: pydantic>=2.11.7; extra == "core"
+Requires-Dist: annotated-types>=0.7.0; extra == "core"
 Provides-Extra: jobs
-Requires-Dist: dill>=0.3.3; extra == "jobs"
-Requires-Dist: python-daemon>=0.2.3; extra == "jobs"
-Requires-Dist: watchfiles>=0.21.0; extra == "jobs"
-Requires-Dist: psutil>=5.8.0; extra == "jobs"
+Requires-Dist: dill>=0.4.0; extra == "jobs"
+Requires-Dist: python-daemon>=3.1.2; extra == "jobs"
+Requires-Dist: watchfiles>=1.1.0; extra == "jobs"
+Requires-Dist: psutil>=7.0.0; extra == "jobs"
 Provides-Extra: drivers
 Requires-Dist: cryptography>=38.0.1; extra == "drivers"
-Requires-Dist: psycopg[binary]>=3.2.1; extra == "drivers"
+Requires-Dist: psycopg[binary]>=3.2.9; extra == "drivers"
 Requires-Dist: PyMySQL>=0.9.0; extra == "drivers"
 Requires-Dist: aiomysql>=0.0.21; extra == "drivers"
 Requires-Dist: sqlalchemy-cockroachdb>=2.0.0; extra == "drivers"
@@ -114,7 +115,7 @@ Requires-Dist: mkdocs-awesome-pages-plugin>=2.5.0; extra == "docs"
 Requires-Dist: mkdocs-section-index>=0.3.3; extra == "docs"
 Requires-Dist: mkdocs-linkcheck>=1.0.6; extra == "docs"
 Requires-Dist: mkdocs-redirects>=1.0.4; extra == "docs"
-Requires-Dist: jinja2==3.0.3; extra == "docs"
+Requires-Dist: jinja2>=3.1.6; extra == "docs"
 Provides-Extra: gui
 Requires-Dist: pywebview>=3.6.3; extra == "gui"
 Requires-Dist: pycparser>=2.21.0; extra == "gui"
@@ -125,20 +126,20 @@ Requires-Dist: modin[ray]>=0.8.3; extra == "extras"
 Requires-Dist: nanoid>=2.0.0; extra == "extras"
 Requires-Dist: importlib-metadata>=4.12.0; extra == "extras"
 Provides-Extra: sql
-Requires-Dist: numpy>=1.18.5; extra == "sql"
-Requires-Dist: pandas[parquet]>=2.0.1; extra == "sql"
-Requires-Dist: pyarrow>=16.1.0; extra == "sql"
+Requires-Dist: numpy>=2.3.1; extra == "sql"
+Requires-Dist: pandas[parquet]>=2.3.1; extra == "sql"
+Requires-Dist: pyarrow>=20.0.0; extra == "sql"
 Requires-Dist: dask[complete]>=2024.12.1; extra == "sql"
 Requires-Dist: partd>=1.4.2; extra == "sql"
 Requires-Dist: pytz; extra == "sql"
-Requires-Dist: joblib>=0.17.0; extra == "sql"
-Requires-Dist: SQLAlchemy>=2.0.5; extra == "sql"
+Requires-Dist: joblib>=1.5.1; extra == "sql"
+Requires-Dist: SQLAlchemy>=2.0.41; extra == "sql"
 Requires-Dist: GeoAlchemy2>=0.17.1; extra == "sql"
-Requires-Dist: databases>=0.4.0; extra == "sql"
-Requires-Dist: aiosqlite>=0.16.0; extra == "sql"
-Requires-Dist: asyncpg>=0.21.0; extra == "sql"
+Requires-Dist: databases>=0.9.0; extra == "sql"
+Requires-Dist: aiosqlite>=0.21.0; extra == "sql"
+Requires-Dist: asyncpg>=0.30.0; extra == "sql"
 Requires-Dist: cryptography>=38.0.1; extra == "sql"
-Requires-Dist: psycopg[binary]>=3.2.1; extra == "sql"
+Requires-Dist: psycopg[binary]>=3.2.9; extra == "sql"
 Requires-Dist: PyMySQL>=0.9.0; extra == "sql"
 Requires-Dist: aiomysql>=0.0.21; extra == "sql"
 Requires-Dist: sqlalchemy-cockroachdb>=2.0.0; extra == "sql"
@@ -166,43 +167,46 @@ Requires-Dist: fasteners>=0.19.0; extra == "sql"
 Requires-Dist: virtualenv>=20.1.0; extra == "sql"
 Requires-Dist: attrs>=24.2.0; extra == "sql"
 Requires-Dist: uv>=0.2.11; extra == "sql"
+Requires-Dist: pydantic>=2.11.7; extra == "sql"
+Requires-Dist: annotated-types>=0.7.0; extra == "sql"
 Requires-Dist: pyproj>=3.7.1; extra == "sql"
 Requires-Dist: geopandas>=1.0.1; extra == "sql"
 Requires-Dist: shapely>=2.0.7; extra == "sql"
 Provides-Extra: dash
-Requires-Dist: Flask-Compress>=1.10.1; extra == "dash"
-Requires-Dist: dash>=2.6.2; extra == "dash"
+Requires-Dist: Flask-Compress>=1.17.0; extra == "dash"
+Requires-Dist: dash>=3.1.1; extra == "dash"
 Requires-Dist: dash-bootstrap-components>=1.7.1; extra == "dash"
 Requires-Dist: dash-ace>=0.2.1; extra == "dash"
-Requires-Dist: dash-extensions>=1.0.4; extra == "dash"
-Requires-Dist: dash-daq>=0.5.0; extra == "dash"
-Requires-Dist: terminado>=0.12.1; extra == "dash"
-Requires-Dist: tornado>=6.1.0; extra == "dash"
+Requires-Dist: dash-extensions>=2.0.4; extra == "dash"
+Requires-Dist: dash-daq>=0.6.0; extra == "dash"
+Requires-Dist: terminado>=0.18.1; extra == "dash"
+Requires-Dist: tornado>=6.5.1; extra == "dash"
 Provides-Extra: api
-Requires-Dist: uvicorn[standard]>=0.29.0; extra == "api"
-Requires-Dist: gunicorn>=22.0.0; extra == "api"
-Requires-Dist: python-dotenv>=0.20.0; extra == "api"
-Requires-Dist: websockets>=11.0.3; extra == "api"
-Requires-Dist: fastapi>=0.111.0; extra == "api"
-Requires-Dist: fastapi-login>=1.7.2; extra == "api"
-Requires-Dist: python-multipart>=0.0.9; extra == "api"
-Requires-Dist: httpx>=0.27.2; extra == "api"
-Requires-Dist: httpcore>=1.0.6; extra == "api"
-Requires-Dist: valkey>=6.0.0; extra == "api"
-Requires-Dist: numpy>=1.18.5; extra == "api"
-Requires-Dist: pandas[parquet]>=2.0.1; extra == "api"
-Requires-Dist: pyarrow>=16.1.0; extra == "api"
+Requires-Dist: uvicorn[standard]>=0.35.0; extra == "api"
+Requires-Dist: gunicorn>=23.0.0; extra == "api"
+Requires-Dist: python-dotenv>=1.1.1; extra == "api"
+Requires-Dist: websockets>=15.0.1; extra == "api"
+Requires-Dist: fastapi>=0.116.0; extra == "api"
+Requires-Dist: fastapi-login>=1.10.3; extra == "api"
+Requires-Dist: python-multipart>=0.0.20; extra == "api"
+Requires-Dist: httpx>=0.28.1; extra == "api"
+Requires-Dist: httpcore>=1.0.9; extra == "api"
+Requires-Dist: valkey>=6.1.0; extra == "api"
+Requires-Dist: python-jose>=3.5.0; extra == "api"
+Requires-Dist: numpy>=2.3.1; extra == "api"
+Requires-Dist: pandas[parquet]>=2.3.1; extra == "api"
+Requires-Dist: pyarrow>=20.0.0; extra == "api"
 Requires-Dist: dask[complete]>=2024.12.1; extra == "api"
 Requires-Dist: partd>=1.4.2; extra == "api"
 Requires-Dist: pytz; extra == "api"
-Requires-Dist: joblib>=0.17.0; extra == "api"
-Requires-Dist: SQLAlchemy>=2.0.5; extra == "api"
+Requires-Dist: joblib>=1.5.1; extra == "api"
+Requires-Dist: SQLAlchemy>=2.0.41; extra == "api"
 Requires-Dist: GeoAlchemy2>=0.17.1; extra == "api"
-Requires-Dist: databases>=0.4.0; extra == "api"
-Requires-Dist: aiosqlite>=0.16.0; extra == "api"
-Requires-Dist: asyncpg>=0.21.0; extra == "api"
+Requires-Dist: databases>=0.9.0; extra == "api"
+Requires-Dist: aiosqlite>=0.21.0; extra == "api"
+Requires-Dist: asyncpg>=0.30.0; extra == "api"
 Requires-Dist: cryptography>=38.0.1; extra == "api"
-Requires-Dist: psycopg[binary]>=3.2.1; extra == "api"
+Requires-Dist: psycopg[binary]>=3.2.9; extra == "api"
 Requires-Dist: PyMySQL>=0.9.0; extra == "api"
 Requires-Dist: aiomysql>=0.0.21; extra == "api"
 Requires-Dist: sqlalchemy-cockroachdb>=2.0.0; extra == "api"
@@ -230,6 +234,8 @@ Requires-Dist: fasteners>=0.19.0; extra == "api"
 Requires-Dist: virtualenv>=20.1.0; extra == "api"
 Requires-Dist: attrs>=24.2.0; extra == "api"
 Requires-Dist: uv>=0.2.11; extra == "api"
+Requires-Dist: pydantic>=2.11.7; extra == "api"
+Requires-Dist: annotated-types>=0.7.0; extra == "api"
 Requires-Dist: pyproj>=3.7.1; extra == "api"
 Requires-Dist: geopandas>=1.0.1; extra == "api"
 Requires-Dist: shapely>=2.0.7; extra == "api"
@@ -241,18 +247,18 @@ Requires-Dist: colorama>=0.4.3; extra == "api"
 Requires-Dist: rich>=13.4.2; extra == "api"
 Requires-Dist: more-termcolor>=1.1.3; extra == "api"
 Requires-Dist: humanfriendly>=10.0.0; extra == "api"
-Requires-Dist: Flask-Compress>=1.10.1; extra == "api"
-Requires-Dist: dash>=2.6.2; extra == "api"
+Requires-Dist: Flask-Compress>=1.17.0; extra == "api"
+Requires-Dist: dash>=3.1.1; extra == "api"
 Requires-Dist: dash-bootstrap-components>=1.7.1; extra == "api"
 Requires-Dist: dash-ace>=0.2.1; extra == "api"
-Requires-Dist: dash-extensions>=1.0.4; extra == "api"
-Requires-Dist: dash-daq>=0.5.0; extra == "api"
-Requires-Dist: terminado>=0.12.1; extra == "api"
-Requires-Dist: tornado>=6.1.0; extra == "api"
-Requires-Dist: dill>=0.3.3; extra == "api"
-Requires-Dist: python-daemon>=0.2.3; extra == "api"
-Requires-Dist: watchfiles>=0.21.0; extra == "api"
-Requires-Dist: psutil>=5.8.0; extra == "api"
+Requires-Dist: dash-extensions>=2.0.4; extra == "api"
+Requires-Dist: dash-daq>=0.6.0; extra == "api"
+Requires-Dist: terminado>=0.18.1; extra == "api"
+Requires-Dist: tornado>=6.5.1; extra == "api"
+Requires-Dist: dill>=0.4.0; extra == "api"
+Requires-Dist: python-daemon>=3.1.2; extra == "api"
+Requires-Dist: watchfiles>=1.1.0; extra == "api"
+Requires-Dist: psutil>=7.0.0; extra == "api"
 Provides-Extra: full
 Requires-Dist: pprintpp>=0.4.0; extra == "full"
 Requires-Dist: asciitree>=0.3.3; extra == "full"
@@ -284,12 +290,14 @@ Requires-Dist: fasteners>=0.19.0; extra == "full"
 Requires-Dist: virtualenv>=20.1.0; extra == "full"
 Requires-Dist: attrs>=24.2.0; extra == "full"
 Requires-Dist: uv>=0.2.11; extra == "full"
-Requires-Dist: dill>=0.3.3; extra == "full"
-Requires-Dist: python-daemon>=0.2.3; extra == "full"
-Requires-Dist: watchfiles>=0.21.0; extra == "full"
-Requires-Dist: psutil>=5.8.0; extra == "full"
+Requires-Dist: pydantic>=2.11.7; extra == "full"
+Requires-Dist: annotated-types>=0.7.0; extra == "full"
+Requires-Dist: dill>=0.4.0; extra == "full"
+Requires-Dist: python-daemon>=3.1.2; extra == "full"
+Requires-Dist: watchfiles>=1.1.0; extra == "full"
+Requires-Dist: psutil>=7.0.0; extra == "full"
 Requires-Dist: cryptography>=38.0.1; extra == "full"
-Requires-Dist: psycopg[binary]>=3.2.1; extra == "full"
+Requires-Dist: psycopg[binary]>=3.2.9; extra == "full"
 Requires-Dist: PyMySQL>=0.9.0; extra == "full"
 Requires-Dist: aiomysql>=0.0.21; extra == "full"
 Requires-Dist: sqlalchemy-cockroachdb>=2.0.0; extra == "full"
@@ -300,49 +308,39 @@ Requires-Dist: geopandas>=1.0.1; extra == "full"
 Requires-Dist: shapely>=2.0.7; extra == "full"
 Requires-Dist: pywebview>=3.6.3; extra == "full"
 Requires-Dist: pycparser>=2.21.0; extra == "full"
-Requires-Dist: numpy>=1.18.5; extra == "full"
-Requires-Dist: pandas[parquet]>=2.0.1; extra == "full"
-Requires-Dist: pyarrow>=16.1.0; extra == "full"
+Requires-Dist: numpy>=2.3.1; extra == "full"
+Requires-Dist: pandas[parquet]>=2.3.1; extra == "full"
+Requires-Dist: pyarrow>=20.0.0; extra == "full"
 Requires-Dist: dask[complete]>=2024.12.1; extra == "full"
 Requires-Dist: partd>=1.4.2; extra == "full"
 Requires-Dist: pytz; extra == "full"
-Requires-Dist: joblib>=0.17.0; extra == "full"
-Requires-Dist: SQLAlchemy>=2.0.5; extra == "full"
+Requires-Dist: joblib>=1.5.1; extra == "full"
+Requires-Dist: SQLAlchemy>=2.0.41; extra == "full"
 Requires-Dist: GeoAlchemy2>=0.17.1; extra == "full"
-Requires-Dist: databases>=0.4.0; extra == "full"
-Requires-Dist: aiosqlite>=0.16.0; extra == "full"
-Requires-Dist: asyncpg>=0.21.0; extra == "full"
-Requires-Dist: Flask-Compress>=1.10.1; extra == "full"
-Requires-Dist: dash>=2.6.2; extra == "full"
+Requires-Dist: databases>=0.9.0; extra == "full"
+Requires-Dist: aiosqlite>=0.21.0; extra == "full"
+Requires-Dist: asyncpg>=0.30.0; extra == "full"
+Requires-Dist: Flask-Compress>=1.17.0; extra == "full"
+Requires-Dist: dash>=3.1.1; extra == "full"
 Requires-Dist: dash-bootstrap-components>=1.7.1; extra == "full"
 Requires-Dist: dash-ace>=0.2.1; extra == "full"
-Requires-Dist: dash-extensions>=1.0.4; extra == "full"
-Requires-Dist: dash-daq>=0.5.0; extra == "full"
-Requires-Dist: terminado>=0.12.1; extra == "full"
-Requires-Dist: tornado>=6.1.0; extra == "full"
-Requires-Dist: uvicorn[standard]>=0.29.0; extra == "full"
-Requires-Dist: gunicorn>=22.0.0; extra == "full"
-Requires-Dist: python-dotenv>=0.20.0; extra == "full"
-Requires-Dist: websockets>=11.0.3; extra == "full"
-Requires-Dist: fastapi>=0.111.0; extra == "full"
-Requires-Dist: fastapi-login>=1.7.2; extra == "full"
-Requires-Dist: python-multipart>=0.0.9; extra == "full"
-Requires-Dist: httpx>=0.27.2; extra == "full"
-Requires-Dist: httpcore>=1.0.6; extra == "full"
-Requires-Dist: valkey>=6.0.0; extra == "full"
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: license
+Requires-Dist: dash-extensions>=2.0.4; extra == "full"
+Requires-Dist: dash-daq>=0.6.0; extra == "full"
+Requires-Dist: terminado>=0.18.1; extra == "full"
+Requires-Dist: tornado>=6.5.1; extra == "full"
+Requires-Dist: uvicorn[standard]>=0.35.0; extra == "full"
+Requires-Dist: gunicorn>=23.0.0; extra == "full"
+Requires-Dist: python-dotenv>=1.1.1; extra == "full"
+Requires-Dist: websockets>=15.0.1; extra == "full"
+Requires-Dist: fastapi>=0.116.0; extra == "full"
+Requires-Dist: fastapi-login>=1.10.3; extra == "full"
+Requires-Dist: python-multipart>=0.0.20; extra == "full"
+Requires-Dist: httpx>=0.28.1; extra == "full"
+Requires-Dist: httpcore>=1.0.9; extra == "full"
+Requires-Dist: valkey>=6.1.0; extra == "full"
+Requires-Dist: python-jose>=3.5.0; extra == "full"
 Dynamic: license-file
-Dynamic: maintainer-email
-Dynamic: project-url
 Dynamic: provides-extra
-Dynamic: requires-python
-Dynamic: summary
 
 <img src="https://meerschaum.io/assets/banner_1920x320.png" alt="Meerschaum banner" style="width: 100%"/>
 

{meerschaum-2.9.4 → meerschaum-3.0.0}/meerschaum/__init__.py

@@ -3,7 +3,7 @@
 # vim:fenc=utf-8
 
 """
-Copyright 2023 Bennett Meares
+Copyright 2025 Bennett Meares
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -19,13 +19,14 @@ limitations under the License.
 """
 
 import atexit
+
 from meerschaum.utils.typing import SuccessTuple
 from meerschaum.utils.packages import attempt_import
 from meerschaum.core.Pipe import Pipe
 from meerschaum.plugins import Plugin
 from meerschaum.utils.venv import Venv
 from meerschaum.jobs import Job, make_executor
-from meerschaum.connectors import get_connector, Connector, make_connector
+from meerschaum.connectors import get_connector, Connector, InstanceConnector, make_connector
 from meerschaum.utils import get_pipes
 from meerschaum.utils.formatting import pprint
 from meerschaum._internal.docs import index as __doc__
@@ -42,6 +43,7 @@ __all__ = (
     "get_config",
     "Pipe",
     "Plugin",
+    "SuccessTuple",
     "Venv",
     "Plugin",
     "Job",
@@ -55,6 +57,7 @@ __all__ = (
     "utils",
     "SuccessTuple",
     "Connector",
+    "InstanceConnector",
     "make_connector",
     "entry",
 )

{meerschaum-2.9.4 → meerschaum-3.0.0}/meerschaum/_internal/__init__.py

@@ -6,3 +6,4 @@
 Modules, classes, and variables declared in _internal are not intended for general public use.
 """
 
+from meerschaum._internal.static import STATIC_CONFIG

{meerschaum-2.9.4 → meerschaum-3.0.0}/meerschaum/_internal/arguments/_parse_arguments.py

@@ -23,7 +23,7 @@ def split_pipeline_sysargs(sysargs: List[str]) -> Tuple[List[str], List[str]]:
     """
     Split `sysargs` into the main pipeline and the flags following the pipeline separator (`:`).
     """
-    from meerschaum.config.static import STATIC_CONFIG
+    from meerschaum._internal.static import STATIC_CONFIG
     pipeline_key = STATIC_CONFIG['system']['arguments']['pipeline_key']
     if pipeline_key not in sysargs:
         return sysargs, []
@@ -40,7 +40,7 @@ def split_chained_sysargs(sysargs: List[str]) -> List[List[str]]:
     Split a `sysargs` list containing "and" keys (`+`)
     into a list of individual `sysargs`.
     """
-    from meerschaum.config.static import STATIC_CONFIG
+    from meerschaum._internal.static import STATIC_CONFIG
     and_key = STATIC_CONFIG['system']['arguments']['and_key']
 
     if not sysargs or and_key not in sysargs:
@@ -90,7 +90,7 @@ def parse_arguments(sysargs: List[str]) -> Dict[str, Any]:
 
     """
     import shlex
-    from meerschaum.config.static import STATIC_CONFIG
+    from meerschaum._internal.static import STATIC_CONFIG
     from meerschaum._internal.arguments._parser import parser
 
     global _loaded_plugins_args
@@ -360,7 +360,7 @@ def remove_leading_action(
     """
     from meerschaum.actions import get_action, get_main_action_name
     from meerschaum.utils.warnings import warn
-    from meerschaum.config.static import STATIC_CONFIG
+    from meerschaum._internal.static import STATIC_CONFIG
     action_function = get_action(action, _actions=_actions)
     if action_function is None:
         return action

{meerschaum-2.9.4 → meerschaum-3.0.0}/meerschaum/_internal/arguments/_parser.py

@@ -40,7 +40,8 @@ class ArgumentParser(argparse.ArgumentParser):
 
 def parse_datetime(dt_str: str) -> Union[datetime, int, str]:
     """Parse a string into a datetime."""
-    from meerschaum.utils.misc import is_int, round_time
+    from meerschaum.utils.dtypes import round_time
+    from meerschaum.utils.misc import is_int
     if is_int(dt_str):
         return int(dt_str)
 
@@ -139,7 +140,11 @@ def parse_help(sysargs: Union[List[str], Dict[str, Any]]) -> None:
     ### Check for subactions.
     if len(args['action']) > 1:
         try:
-            subaction = get_subactions(args['action'][0])[args['action'][1]]
+            subactions = get_subactions(args['action'][0])
+            subaction_name = args['action'][1]
+            if subaction_name not in subactions:
+                subaction_name = subaction_name + 's'
+            subaction = subactions[subaction_name]
         except Exception:
             subaction = None
         if subaction is not None:
@@ -195,6 +200,7 @@ groups['pipes'] = parser.add_argument_group(title='Pipes options')
 groups['sync'] = parser.add_argument_group(title='Sync options')
 groups['api'] = parser.add_argument_group(title='API options')
 groups['plugins'] = parser.add_argument_group(title='Plugins options')
+groups['tokens'] = parser.add_argument_group(title='Tokens options')
 groups['packages'] = parser.add_argument_group(title='Packages options')
 groups['debug'] = parser.add_argument_group(title='Debugging options')
 groups['misc'] = parser.add_argument_group(title='Miscellaneous options')
@@ -375,7 +381,7 @@ groups['sync'].add_argument(
 groups['sync'].add_argument(
     '--cache', action='store_true',
     help=(
-        "When syncing or viewing a pipe's data, sync to a local database for later analysis."
+        "Sync pipes' metadata to disk."
     )
 )
 
@@ -387,13 +393,21 @@ groups['api'].add_argument(
     '--host', type=str,
     help="The host address to bind to for the API server. Defaults to '0.0.0.0'."
 )
+groups['api'].add_argument(
+    '--webterm-port', type=int,
+    help="The port on which to run the webterm server.",
+)
 groups['api'].add_argument(
     '-w', '--workers', type=int,
     help = "How many workers to run a concurrent action (e.g. running the API or syncing pipes)"
 )
 groups['api'].add_argument(
     '--no-dash', '--nodash', action='store_true',
-    help = 'When starting the API, do not start the Web interface.',
+    help = 'When starting the API, do not start the Web Console dashboard.',
+)
+groups['api'].add_argument(
+    '--no-webterm', '--nowebterm', action='store_true',
+    help="When starting the API, do not start the Webterm.",
 )
 groups['api'].add_argument(
     '--private', '--private-mode', action='store_true',
@@ -419,12 +433,23 @@ groups['api'].add_argument(
     '--certfile', type=str,
     help = "Start the API server with this certfile (requires --keyfile).",
 )
+
 ### Plugins options
 groups['plugins'].add_argument(
     '-r', '--repository', '--repo', type=str,
     help="Meerschaum plugins repository to connect to. Specify an API label (default: 'mrsm')"
 )
 
+### Tokens options
+groups['tokens'].add_argument(
+    '--ttl-days', type=int,
+    help="For how many days should a token be valid.",
+)
+groups['tokens'].add_argument(
+    '--scopes', '--scope', nargs='+',
+    help="Which scope permissions to grant to a token.",
+)
+
 ### Packages options
 groups['packages'].add_argument(
     '--venv', type=str,
@@ -491,3 +516,7 @@ groups['misc'].add_argument(
         + "Default behavior is to only allow recognized actions."
     )
 )
+groups['misc'].add_argument(
+    '--no-daemon', action='store_true',
+    help="Do not use the Meerschaum CLI daemon to execute the action.",
+)

meerschaum-3.0.0/meerschaum/_internal/cli/__init__.py

@@ -0,0 +1,6 @@
+#! /usr/bin/env python3
+# vim:fenc=utf-8
+
+"""
+Define internal utilities for interacting with the CLI daemons.
+"""

meerschaum-3.0.0/meerschaum/_internal/cli/daemons.py

@@ -0,0 +1,103 @@
+#! /usr/bin/env python3
+# vim:fenc=utf-8
+
+"""
+Define the CLI daemons utilities.
+"""
+
+import os
+import threading
+import pathlib
+from typing import Optional, List
+
+import meerschaum as mrsm
+
+
+def get_cli_daemon(ix: Optional[int] = None):
+    """
+    Get the CLI daemon.
+    """
+    from meerschaum._internal.cli.workers import ActionWorker
+    ix = ix if ix is not None else get_available_cli_daemon_ix()
+    return ActionWorker(ix)
+
+
+def get_cli_lock_path(ix: int) -> pathlib.Path:
+    """
+    Return the path to a CLI daemon's lock file.
+    """
+    from meerschaum.config.paths import CLI_RESOURCES_PATH
+    return CLI_RESOURCES_PATH / f"ix-{ix}.lock"
+
+
+def get_cli_session_id() -> str:
+    """
+    Return the session ID to use for the current process and thread.
+    """
+    return f"{os.getpid()}.{threading.current_thread().ident}"
+
+
+def get_available_cli_daemon_ix() -> int:
+    """
+    Return the index for an available CLI daemon.
+    """
+    max_ix = mrsm.get_config('system', 'cli', 'max_daemons') - 1
+    ix = 0
+    while True:
+        lock_path = get_cli_lock_path(ix)
+        if not lock_path.exists():
+            return ix
+        
+        ix += 1
+        if ix > max_ix:
+            raise EnvironmentError("Too many CLI daemons are running.")
+
+
+def get_existing_cli_daemon_indices() -> List[int]:
+    """
+    Return a list of the existing CLI daemons.
+    """
+    from meerschaum.utils.daemon import get_daemon_ids
+    daemon_ids = [daemon_id for daemon_id in get_daemon_ids() if daemon_id.startswith('.cli.')]
+    indices = []
+
+    for daemon_id in daemon_ids:
+        try:
+            ix = int(daemon_id[len('.cli.'):])
+            indices.append(ix)
+        except Exception:
+            pass
+
+    return indices
+
+
+def get_existing_cli_daemons() -> 'List[ActionWorker]':
+    """
+    Return a list of the existing CLI daemons.
+    """
+    from meerschaum._internal.cli.workers import ActionWorker
+    indices = get_existing_cli_daemon_indices()
+    return [
+        ActionWorker(ix)
+        for ix in indices
+    ]
+
+
+def _get_cli_session_dir_path(session_id: str) -> pathlib.Path:
+    """
+    Return the path to the file handles for the CLI session.
+    """
+    from meerschaum.config.paths import CLI_RESOURCES_PATH
+    return CLI_RESOURCES_PATH / session_id
+
+
+def _get_cli_stream_path(
+    session_id: str,
+    action_id: str,
+    stream: str = 'stdout',
+) -> pathlib.Path:
+    """
+    Return the file path for the stdout / stderr file stream.
+    """
+    session_dir_path = _get_cli_session_dir_path(session_id)
+    return session_dir_path / f'{action_id}.{stream}'