meerschaum 2.3.0rc5__py3-none-any.whl → 2.3.1__py3-none-any.whl

meerschaum/__init__.py

@@ -24,7 +24,7 @@ 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, Executor, make_executor
+from meerschaum.jobs import Job, make_executor
 from meerschaum.connectors import get_connector, Connector, make_connector
 from meerschaum.utils import get_pipes
 from meerschaum.utils.formatting import pprint
@@ -45,13 +45,12 @@ __all__ = (
     "Venv",
     "Plugin",
     "Job",
-    "Executor",
-    "make_executor",
     "pprint",
     "attempt_import",
     "actions",
     "config",
     "connectors",
+    "jobs",
     "plugins",
     "utils",
     "SuccessTuple",

meerschaum/_internal/arguments/_parse_arguments.py

@@ -106,8 +106,8 @@ def parse_arguments(sysargs: List[str]) -> Dict[str, Any]:
     for i, word in enumerate(sysargs):
         is_sub_arg = False
         if not found_begin_decorator:
-            found_begin_decorator = word.startswith(begin_decorator)
-            found_end_decorator = word.endswith(end_decorator)
+            found_begin_decorator = str(word).startswith(begin_decorator)
+            found_end_decorator = str(word).endswith(end_decorator)
 
         if found_begin_decorator:
             ### check if sub arg is ever closed
@@ -117,15 +117,15 @@ def parse_arguments(sysargs: List[str]) -> Dict[str, Any]:
                     found_begin_decorator = False
         elif found_end_decorator:
             for a in sysargs[:i]:
-                if a.startswith(begin_decorator):
+                if str(a).startswith(begin_decorator):
                     is_sub_arg = True
                     found_begin_decorator = False
         if is_sub_arg:
             ### remove decorators
             sa = word
-            if sa.startswith(begin_decorator):
+            if str(sa).startswith(begin_decorator):
                 sa = sa[len(begin_decorator):]
-            if sa.endswith(end_decorator):
+            if str(sa).endswith(end_decorator):
                 sa = sa[:-1 * len(end_decorator)]
             sub_arguments.append(sa)
             ### remove sub-argument from action list
@@ -144,7 +144,7 @@ def parse_arguments(sysargs: List[str]) -> Dict[str, Any]:
     except Exception as e:
         _action = []
         for a in filtered_sysargs:
-            if a.startswith('-'):
+            if str(a).startswith('-'):
                 break
             _action.append(a)
         args_dict = {'action': _action, 'sysargs': sysargs}
@@ -267,7 +267,7 @@ def parse_dict_to_sysargs(
     action = args_dict.get('action', None)
     sysargs: List[str] = []
     sysargs.extend(action or [])
-    allow_none_args = {'location_keys'}
+    allow_none_args = {'location_keys', 'begin', 'end', 'executor_keys'}
 
     triggers = get_arguments_triggers()
 
@@ -278,12 +278,18 @@ def parse_dict_to_sysargs(
         ### Add boolean flags
         if isinstance(args_dict[a], bool):
             if args_dict[a] is True:
-                sysargs += [t[0]]
+                sysargs.extend([t[0]])
         else:
             ### Add list flags
             if isinstance(args_dict[a], (list, tuple)):
                 if len(args_dict[a]) > 0:
-                    sysargs += [t[0]] + list(args_dict[a])
+                    sysargs.extend(
+                        [t[0]]
+                        + [
+                            str(item)
+                            for item in args_dict[a]
+                        ]
+                    )
 
             ### Add dict flags
             elif isinstance(args_dict[a], dict):
@@ -292,7 +298,7 @@ def parse_dict_to_sysargs(
 
             ### Account for None and other values
             elif (args_dict[a] is not None) or (args_dict[a] is None and a in allow_none_args):
-                sysargs += [t[0], args_dict[a]]
+                sysargs += [t[0], str(args_dict[a])]
 
     return sysargs
 

meerschaum/_internal/arguments/_parser.py

@@ -125,7 +125,7 @@ def parse_version(sysargs: List[str]):
     return print(doc)
 
 
-def parse_name(name_str: str) -> str:
+def parse_name(name_str: str) -> Union[str, None]:
     """
     Ensure that `--name` is not an empty string.
     """

meerschaum/_internal/docs/index.py

@@ -36,8 +36,9 @@ For your convenience, the following classes and functions may be imported from t
 <li><code>meerschaum.Connector</code></li>
 <li><code>meerschaum.Pipe</code></li>
 <li><code>meerschaum.Plugin</code></li>
-<li><code>meerschaum.SuccessTuple</code></li>
+<li><code>meerschaum.Job</code></li>
 <li><code>meerschaum.Venv</code></li>
+<li><code>meerschaum.SuccessTuple</code></li>
 </ul>
 
 </div>
@@ -54,6 +55,7 @@ For your convenience, the following classes and functions may be imported from t
 <li><code>meerschaum.make_connector()</code></li>
 <li><code>meerschaum.pprint()</code></li>
 <li><code>meerschaum.attempt_import()</code></li>
+<li><code>meerschaum.entry()</code></li>
 </ul>
 
 </div>
@@ -61,7 +63,10 @@ For your convenience, the following classes and functions may be imported from t
 
 ### Examples
 
-#### Build a Connector
+<details>
+    <summary><b>Build a Connector</b></summary>
+
+Get existing connectors or build a new one in-memory with the `meerschaum.get_connector()` factory function:
 
 ```python
 import meerschaum as mrsm
@@ -80,9 +85,14 @@ sql_conn.to_sql(df, 'foo')
 print(sql_conn.read('foo'))
 #    foo
 # 0    1
+
 ```
+</details>
+
+<details>
+    <summary><b>Create a Custom Connector Class</b></summary>
 
-#### Create a Custom Connector Class
+Decorate your connector classes with `meerschaum.make_connector()` to designate it as a custom connector:
 
 ```python
 from datetime import datetime, timezone
@@ -113,8 +123,12 @@ foo_conn = mrsm.get_connector(
 )
 docs = foo_conn.fetch()
 ```
+</details>
 
-#### Build a Pipe
+<details>
+    <summary><b>Build a Pipe</b></summary>
+
+Build a `meerschaum.Pipe` in-memory:
 
 ```python
 from datetime import datetime
@@ -135,7 +149,23 @@ print(df)
 # 2 2024-01-01   3  96
 ```
 
-#### Get Registered Pipes
+Add `temporary=True` to skip registering the pipe in the pipes table.
+
+</details>
+
+<details>
+    <summary><b>Get Registered Pipes</b></summary>
+
+The `meerschaum.get_pipes()` function returns a dictionary hierarchy of pipes by connector, metric, and location:
+
+```python
+import meerschaum as mrsm
+
+pipes = mrsm.get_pipes(instance='sql:temp')
+pipe = pipes['foo:bar']['demo'][None]
+```
+
+Add `as_list=True` to flatten the hierarchy:
 
 ```python
 import meerschaum as mrsm
@@ -148,8 +178,12 @@ pipes = mrsm.get_pipes(
 print(pipes)
 # [Pipe('foo:bar', 'demo', instance='sql:temp')]
 ```
+</details>
 
-#### Access a Plugin's Module
+<details>
+    <summary><b>Import Plugins</b></summary>
+
+You can import a plugin's module through `meerschaum.Plugin.module`:
 
 ```python
 import meerschaum as mrsm
@@ -157,10 +191,211 @@ import meerschaum as mrsm
 plugin = mrsm.Plugin('noaa')
 with mrsm.Venv(plugin):
     noaa = plugin.module
-    print(noaa.get_station_info('KGMU'))
-# {'name': 'Greenville Downtown Airport', 'geometry': {'type': 'Point', 'coordinates': [-82.35004, 34.84873]}}
 ```
 
+If your plugin has submodules, use `meerschaum.plugins.from_plugin_import`:
+
+```python
+from meerschaum.plugins import from_plugin_import
+get_defined_pipes = from_plugin_import('compose.utils.pipes', 'get_defined_pipes')
+```
+
+Import multiple plugins with `meerschaum.plugins.import_plugins`:
+
+```python
+from meerschaum.plugins import import_plugins
+noaa, compose = import_plugins('noaa', 'compose')
+```
+
+</details>
+
+<details>
+    <summary><b>Create a Job</b></summary>
+
+Create a `meerschaum.Job` with `name` and `sysargs`:
+
+```python
+import meerschaum as mrsm
+
+job = mrsm.Job('syncing-engine', 'sync pipes --loop')
+success, msg = job.start()
+```
+
+Pass `executor_keys` as the connectors keys of an API instance to create a remote job:
+
+```python
+import meerschaum as mrsm
+
+job = mrsm.Job(
+    'foo',
+    'sync pipes -s daily',
+    executor_keys='api:main',
+)
+```
+
+</details>
+
+<details>
+    <summary><b>Import from a Virtual Environment</b></summary>
+Use the `meerschaum.Venv` context manager to activate a virtual environment:
+```python
+import meerschaum as mrsm
+
+with mrsm.Venv('noaa'):
+    import requests
+
+print(requests.__file__)
+# /home/bmeares/.config/meerschaum/venvs/noaa/lib/python3.12/site-packages/requests/__init__.py
+```
+
+To import packages which may not be installed, use `meerschaum.attempt_import()`:
+
+```python
+import meerschaum as mrsm
+
+requests = mrsm.attempt_import('requests', venv='noaa')
+print(requests.__file__)
+# /home/bmeares/.config/meerschaum/venvs/noaa/lib/python3.12/site-packages/requests/__init__.py
+```
+
+</details>
+
+<details>
+    <summary><b>Run Actions</b></summary>
+
+Run `sysargs` with `meerschaum.entry()`:
+
+```python
+import meerschaum as mrsm
+
+success, msg = mrsm.entry('show pipes + show version : x2')
+```
+
+Use `meerschaum.actions.get_action()` to access an action function directly:
+
+```python
+from meerschaum.actions import get_action
+
+show_pipes = get_action(['show', 'pipes'])
+success, msg = show_pipes(connector_keys=['plugin:noaa'])
+```
+
+Get a dictionary of available subactions with `meerschaum.actions.get_subactions()`:
+
+```python
+from meerschaum.actions import get_subactions
+
+subactions = get_subactions('show')
+success, msg = subactions['pipes']()
+```
+
+</details>
+
+<details>
+    <summary><b>Create a Plugin</b></summary>
+
+Run `bootstrap plugin` to create a new plugin:
+
+```
+mrsm bootstrap plugin example
+```
+
+This will create `example.py` in your plugins directory (default `~/.config/meerschaum/plugins/`, Windows: `%APPDATA%\Meerschaum\plugins`). You may paste the example code from the "Create a Custom Action" example below.
+
+Open your plugin with `edit plugin`:
+
+```
+mrsm edit plugin example
+```
+
+*Run `edit plugin` and paste the example code below to try out the features.*
+
+See the [writing plugins guide](https://meerschaum.io/reference/plugins/writing-plugins/) for more in-depth documentation.
+
+</details>
+
+<details>
+    <summary><b>Create a Custom Action</b></summary>
+
+Decorate a function with `meerschaum.actions.make_action` to designate it as an action. Subactions will be automatically detected if not decorated:
+
+```python
+from meerschaum.actions import make_action
+
+@make_action
+def sing():
+    print('What would you like me to sing?')
+    return True, "Success"
+
+def sing_tune():
+    return False, "I don't know that song!"
+
+def sing_song():
+    print('Hello, World!')
+    return True, "Success"
+
+```
+
+Use `meerschaum.plugins.add_plugin_argument()` to create new parameters for your action:
+
+```python
+from meerschaum.plugins import make_action, add_plugin_argument
+
+add_plugin_argument(
+    '--song', type=str, help='What song to sing.',
+)
+
+@make_action
+def sing_melody(action=None, song=None):
+    to_sing = action[0] if action else song
+    if not to_sing:
+        return False, "Please tell me what to sing!"
+
+    return True, f'~I am singing {to_sing}~'
+```
+
+```
+mrsm sing melody lalala
+
+mrsm sing melody --song do-re-mi
+```
+
+</details>
+
+<details>
+    <summary><b>Add a Page to the Web Dashboard</b></summary>
+    Use the decorators `meerschaum.plugins.dash_plugin()` and `meerschaum.plugins.web_page()` to add new pages to the web dashboard:
+
+```python
+from meerschaum.plugins import dash_plugin, web_page
+
+@dash_plugin
+def init_dash(dash_app):
+
+    import dash.html as html
+    import dash_bootstrap_components as dbc
+    from dash import Input, Output, no_update
+
+    ### Routes to '/dash/my-page'
+    @web_page('/my-page', login_required=False)
+    def my_page():
+        return dbc.Container([
+            html.H1("Hello, World!"),
+            dbc.Button("Click me", id='my-button'),
+            html.Div(id="my-output-div"),
+        ])
+
+    @dash_app.callback(
+        Output('my-output-div', 'children'),
+        Input('my-button', 'n_clicks'),
+    )
+    def my_button_click(n_clicks):
+        if not n_clicks:
+            return no_update
+        return html.P(f'You clicked {n_clicks} times!')
+```
+</details>
+
 ## Submodules
 
 <details>
@@ -206,6 +441,28 @@ with mrsm.Venv(plugin):
 
 </details>
 
+<details>
+    <summary>
+    `meerschaum.jobs`<br>
+    Start background jobs.
+    </summary>
+
+  - `meerschaum.jobs.Job`
+  - `meerschaum.jobs.Executor`
+  - `meerschaum.jobs.systemd.SystemdExecutor`
+  - `meerschaum.jobs.get_jobs()`
+  - `meerschaum.jobs.get_filtered_jobs()`
+  - `meerschaum.jobs.get_running_jobs()`
+  - `meerschaum.jobs.get_stopped_jobs()`
+  - `meerschaum.jobs.get_paused_jobs()`
+  - `meerschaum.jobs.get_restart_jobs()`
+  - `meerschaum.jobs.make_executor()`
+  - `meerschaum.jobs.check_restart_jobs()`
+  - `meerschaum.jobs.start_check_jobs_thread()`
+  - `meerschaum.jobs.stop_check_jobs_thread()`
+
+</details>
+
 <details>
   <summary>
   `meerschaum.plugins`<br>

meerschaum/actions/__init__.py

@@ -11,6 +11,16 @@ from meerschaum.utils.typing import Callable, Any, Optional, Union, List, Dict,
 from meerschaum.utils.packages import get_modules_from_package
 _custom_actions = []
 
+__all__ = (
+    'get_action',
+    'get_subactions',
+    'make_action',
+    'pre_sync_hook',
+    'post_sync_hook',
+    'get_main_action_name',
+    'get_completer',
+)
+
 def get_subactions(
     action: Union[str, List[str]],
     _actions: Optional[Dict[str, Callable[[Any], Any]]] = None,
@@ -101,9 +111,9 @@ def get_action(
 
 
 def get_main_action_name(
-        action: Union[List[str], str],
-        _actions: Optional[Dict[str, Callable[[Any], SuccessTuple]]] = None,
-    ) -> Union[str, None]:
+    action: Union[List[str], str],
+    _actions: Optional[Dict[str, Callable[[Any], SuccessTuple]]] = None,
+) -> Union[str, None]:
     """
     Given an action list, return the name of the main function.
     For subactions, this will return the root function.
@@ -140,9 +150,9 @@ def get_main_action_name(
 
 
 def get_completer(
-        action: Union[List[str], str],
-        _actions: Optional[Dict[str, Callable[[Any], SuccessTuple]]] = None,
-    ) -> Union[
+    action: Union[List[str], str],
+    _actions: Optional[Dict[str, Callable[[Any], SuccessTuple]]] = None,
+) -> Union[
         Callable[['meerschaum._internal.shell.Shell', str, str, int, int], List[str]], None
     ]:
     """Search for a custom completer function for an action."""
@@ -179,10 +189,10 @@ def get_completer(
 
 
 def choose_subaction(
-        action: Optional[List[str]] = None,
-        options: Optional[Dict[str, Any]] = None,
-        **kw
-    ) -> SuccessTuple:
+    action: Optional[List[str]] = None,
+    options: Optional[Dict[str, Any]] = None,
+    **kw
+) -> SuccessTuple:
     """
     Given a dictionary of options and the standard Meerschaum actions list,
     check if choice is valid and execute chosen function, else show available
@@ -247,7 +257,7 @@ def _get_subaction_names(action: str, globs: dict = None) -> List[str]:
     return subactions
 
 
-def choices_docstring(action: str, globs : Optional[Dict[str, Any]] = None) -> str:
+def choices_docstring(action: str, globs: Optional[Dict[str, Any]] = None) -> str:
     """
     Append the an action's available options to the module docstring.
     This function is to be placed at the bottom of each action module.

meerschaum/config/_version.py

@@ -2,4 +2,4 @@
 Specify the Meerschaum release version.
 """
 
-__version__ = "2.3.0rc5"
+__version__ = "2.3.1"

meerschaum/connectors/__init__.py

@@ -377,5 +377,4 @@ def _load_builtin_custom_connectors():
     """
     Import custom connectors decorated with `@make_connector` or `@make_executor`.
     """
-    import meerschaum.jobs._SystemdExecutor
-    #  import meerschaum.jobs._LocalExecutor
+    import meerschaum.jobs.systemd

meerschaum/jobs/__init__.py

@@ -16,6 +16,7 @@ from meerschaum.jobs._Executor import Executor
 
 __all__ = (
     'Job',
+    'systemd',
     'get_jobs',
     'get_filtered_jobs',
     'get_restart_jobs',
@@ -23,8 +24,8 @@ __all__ = (
     'get_stopped_jobs',
     'get_paused_jobs',
     'get_restart_jobs',
-    'Executor',
     'make_executor',
+    'Executor',
     'check_restart_jobs',
     'start_check_jobs_thread',
     'stop_check_jobs_thread',

meerschaum/plugins/_Plugin.py

@@ -654,7 +654,7 @@ class Plugin:
             import ast, re
             ### NOTE: This technically would break 
             ### if `required` was the very first line of the file.
-            req_start_match = re.search(r'required(:\s*)?.*=', text)
+            req_start_match = re.search(r'\nrequired(:\s*)?.*=', text)
             if not req_start_match:
                 return []
             req_start = req_start_match.start()

meerschaum/plugins/__init__.py

@@ -28,7 +28,8 @@ _locks = {
     'PLUGINS_INTERNAL_LOCK_PATH': RLock(),
 }
 __all__ = (
-    "Plugin", "make_action", "api_plugin", "dash_plugin", "import_plugins",
+    "Plugin", "make_action", "api_plugin", "dash_plugin", "web_page",
+    "import_plugins", "from_plugin_import",
     "reload_plugins", "get_plugins", "get_data_plugins", "add_plugin_argument",
     "pre_sync_hook", "post_sync_hook",
 )

{meerschaum-2.3.0rc5.dist-info → meerschaum-2.3.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: meerschaum
-Version: 2.3.0rc5
+Version: 2.3.1
 Summary: Sync Time-Series Pipes with Meerschaum
 Home-page: https://meerschaum.io
 Author: Bennett Meares

{meerschaum-2.3.0rc5.dist-info → meerschaum-2.3.1.dist-info}/RECORD

@@ -1,12 +1,12 @@
-meerschaum/__init__.py,sha256=rzLJwaiLJvc_VAOjUM6pzKlm-w8NhHrOCH99Ob1vrjY,1736
+meerschaum/__init__.py,sha256=6bn5zz7VInDP4fE_FGBMzJYrM6rQhBMJNQqsf1pU7eI,1701
 meerschaum/__main__.py,sha256=r5UjYxH1WA6dGG9YGBPul5xOdgF3Iwl0X4dWDtXU-30,2646
 meerschaum/_internal/__init__.py,sha256=ilC7utfKtin7GAvuN34fKyUQYfPyqH0Mm3MJF5iyEf4,169
 meerschaum/_internal/entry.py,sha256=psQ6zltjBk-9663jT_JiYq34qr6Izk7oLoLCBayYjK8,10125
 meerschaum/_internal/arguments/__init__.py,sha256=CbNgnlH6fqNI5n7EuQC6m3Do6ckXDqw4Vuc4T_qPJGQ,566
-meerschaum/_internal/arguments/_parse_arguments.py,sha256=WJ_sNgv2gQXBnMkAwIeyGM8c_2KX6G2OGgTMJw0FPzg,12736
-meerschaum/_internal/arguments/_parser.py,sha256=k3r_f7S8-Czyi-MmxoGLGqNti7sXGVJUxHm9Rfhmq5A,14904
+meerschaum/_internal/arguments/_parse_arguments.py,sha256=6Tf9xTXZA-wH51Ep_iuG5JFLzD2rYevuA8n69FTi6Mk,12984
+meerschaum/_internal/arguments/_parser.py,sha256=LfiVDTr1akj5D31qpJAAXKxMcnLQiD3jRpZtvvHWrAo,14917
 meerschaum/_internal/docs/__init__.py,sha256=ZQYHWo6n0kfLLkyG36YXqTYvv2Pc7it5HZHMylT6cBA,126
-meerschaum/_internal/docs/index.py,sha256=Qovl1fI-KqCz7KtxCIWklqUGUcJ8Sbx4UKAEarrUn_A,18056
+meerschaum/_internal/docs/index.py,sha256=LwpPMX5ODsv-CSLOmwKhJpYdEK4LBrZ260yJhYwN0L8,24389
 meerschaum/_internal/gui/__init__.py,sha256=KF6Opae0aBOjIndMZ2txoPs7ozCXRlR-lcTsicLO7fc,1313
 meerschaum/_internal/gui/app/__init__.py,sha256=rKUa8hHk6Fai-PDF61tQcpT1myxKcfmvEMDHxThNp7o,1565
 meerschaum/_internal/gui/app/_windows.py,sha256=-VHdjTzA3V596fVqnbmTxemONSp_80-sTNJ0CTB8FwU,2632
@@ -21,7 +21,7 @@ meerschaum/_internal/shell/resources/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeu
 meerschaum/_internal/term/TermPageHandler.py,sha256=Rt5S47Pr_3HLJc8xIXpZUczYE_Dw2qT8qwf1jZFtUHQ,520
 meerschaum/_internal/term/__init__.py,sha256=eXjfRzpnASWomB4xpY2AfzC_CLenkInNnVWSLZEexlg,1638
 meerschaum/_internal/term/tools.py,sha256=dXVAimKD-Yv2fg2WOTr0YGBY7XDKjQqw-RizcS65YVI,727
-meerschaum/actions/__init__.py,sha256=A-xwztWrq9xL_FbiBcoNB9-WKfwzYlFerh4XFl-Ao5c,11515
+meerschaum/actions/__init__.py,sha256=MHPs8aRBhbZQXnqd_6tVtisTrNCgPAPgnNcXYbn0zP8,11640
 meerschaum/actions/api.py,sha256=8wjREHNRkl8WBgtz1KfWmAVjeFR_J2j7ghXjSyYUW3g,12603
 meerschaum/actions/attach.py,sha256=UV19d9W_2WYcrf7BRz7k3mriDoX1V4rA4AKvbLdor0o,3106
 meerschaum/actions/bootstrap.py,sha256=9D3cBHzgZbZyWy-Y7iQgk9bpTbKEhumFKbIIThZgPXI,14058
@@ -140,7 +140,7 @@ meerschaum/config/_preprocess.py,sha256=-AEA8m_--KivZwTQ1sWN6LTn5sio_fUr2XZ51BO6
 meerschaum/config/_read_config.py,sha256=WFZKIXZMDe_ca0ES7ivgM_mnwShvFxLdoeisT_X5-h0,14720
 meerschaum/config/_shell.py,sha256=46_m49Txc5q1rGfCgO49ca48BODx45DQJi8D0zz1R18,4245
 meerschaum/config/_sync.py,sha256=oK2ZujO2T1he08BXCFyiniBUevNGWSQKXLcS_jRv_7Y,4155
-meerschaum/config/_version.py,sha256=vbuOXg7cu08l1X04IxH-oKG_9tc2_ZMV5OZnH2nmCsk,74
+meerschaum/config/_version.py,sha256=-OEPUq6iLmMIziBtPRXIipuwI18bZwaz6HdVj8fnB3s,71
 meerschaum/config/paths.py,sha256=JjibeGN3YAdSNceRwsd42aNmeUrIgM6ndzC8qZAmNI0,621
 meerschaum/config/resources/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 meerschaum/config/stack/__init__.py,sha256=Yt7GNzC_hz7iUDZ4gVho_lugJO2DnXgnMtsMG_ReoRg,9114
@@ -150,7 +150,7 @@ meerschaum/config/stack/mosquitto/resources/__init__.py,sha256=47DEQpj8HBSa-_TIm
 meerschaum/config/stack/resources/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 meerschaum/config/static/__init__.py,sha256=bSugcNkYKnApqUxT0LcpqE_3-2tyJfTu2fDmzbB4fVM,5127
 meerschaum/connectors/Connector.py,sha256=utNV3Fy5DhUVbQE-vtm7enH5rH2gxQERmgmP7PUzH30,6682
-meerschaum/connectors/__init__.py,sha256=b1RdpMUNWtA5Q4KbymeUt9HtEiMWUHf0BBXzcl4itkc,12557
+meerschaum/connectors/__init__.py,sha256=fLoatCZV2hsDffYEg2aBzqPLzM_2o1_Z3X2iZvLwoqA,12503
 meerschaum/connectors/parse.py,sha256=sDeI2OIS9Inwhbn9jkFAXxOPnmmAHqsuHiiHfWjVnSA,4307
 meerschaum/connectors/poll.py,sha256=gIY9TvFBqMvMNQvR0O2No7koLLz2PjfExBr_Dsosgpg,7363
 meerschaum/connectors/api/APIConnector.py,sha256=MPYeImCBAeSpueYis5CxkfT7kkV82MnGKDLoNE8uOVw,5017
@@ -202,11 +202,10 @@ meerschaum/core/User/_User.py,sha256=CApB7Y0QJL6S9QOCCfrG4SbPuPXJ9AsAYQ5pASMP_Aw
 meerschaum/core/User/__init__.py,sha256=lJ7beIZTG9sO4dAi3367fFBl17dXYEWHKi7HoaPlDyk,193
 meerschaum/jobs/_Executor.py,sha256=ZUsQl0hgU0HW_F9bQCfm8KwrdyTBLCrfxsSnbJOwtWI,1575
 meerschaum/jobs/_Job.py,sha256=KpNIy71twW6kU6EEMv9Hc7E_-5ELX1m3rUjR4fQvTE4,30114
-meerschaum/jobs/_LocalExecutor.py,sha256=v_zvU1vgJDy-iiztXS5gnMayJ0UZnW48qJj3OSB6o-k,2195
-meerschaum/jobs/_SystemdExecutor.py,sha256=UqxAvUra4fxNruy2OZlBVFKIidWVPCAKsOKDdGSrMwk,23225
-meerschaum/jobs/__init__.py,sha256=NnzkkvCMAmXvMhzpFtj163K7cgzcQupDjf1ErBTfn3s,10838
-meerschaum/plugins/_Plugin.py,sha256=q1B4gVAO2BGA-PIR0HI3-O9q1n8BaT7tSANIyW7gUPg,34084
-meerschaum/plugins/__init__.py,sha256=3Hg9yyfkN0TxPPTnlt6pi53znjRIAR92WpG3zEKYm10,26152
+meerschaum/jobs/__init__.py,sha256=q8SzxwfOzt-rZVpJPqOGHonYzEw0KJOz3uneb6zozDE,10853
+meerschaum/jobs/systemd.py,sha256=UqxAvUra4fxNruy2OZlBVFKIidWVPCAKsOKDdGSrMwk,23225
+meerschaum/plugins/_Plugin.py,sha256=p6j39tm-xrZENBq-eGtixBuXxLLddtEKWRCRFNqpRu0,34086
+meerschaum/plugins/__init__.py,sha256=trMQ53qgP7ikJhhV_uXzqJw6X1NDz2rPOGXFk40bb1Y,26190
 meerschaum/plugins/bootstrap.py,sha256=qg9MQ1YAU8ShwGqWDl38WjiXLIxDPl95pSIGDLN9rOw,11423
 meerschaum/utils/__init__.py,sha256=QrK1K9hIbPCRCM5k2nZGFqGnrqhA0Eh-iSmCU7FG6Cs,612
 meerschaum/utils/_get_pipes.py,sha256=dlPckpYYyM0IwRZ2VL0u9DiEeYhr5Ho9gkzvWxzNVwI,11460
@@ -242,11 +241,11 @@ meerschaum/utils/packages/_packages.py,sha256=GzbJ0kxW_EQogXmY4vguRkUyad42cshFs7
 meerschaum/utils/packages/lazy_loader.py,sha256=VHnph3VozH29R4JnSSBfwtA5WKZYZQFT_GeQSShCnuc,2540
 meerschaum/utils/venv/_Venv.py,sha256=sBnlmxHdAh2bx8btfVoD79-H9-cYsv5lP02IIXkyECs,3553
 meerschaum/utils/venv/__init__.py,sha256=bLAWnllKDuE_z6bLk7gLh4mI3Sp1j5hsboTqPKOQq84,24361
-meerschaum-2.3.0rc5.dist-info/LICENSE,sha256=jG2zQEdRNt88EgHUWPpXVWmOrOduUQRx7MnYV9YIPaw,11359
-meerschaum-2.3.0rc5.dist-info/METADATA,sha256=wPTucHTNGE47jFVclb44Q3LNaEAlNevWqZqadBld-aQ,24009
-meerschaum-2.3.0rc5.dist-info/NOTICE,sha256=OTA9Fcthjf5BRvWDDIcBC_xfLpeDV-RPZh3M-HQBRtQ,114
-meerschaum-2.3.0rc5.dist-info/WHEEL,sha256=R0nc6qTxuoLk7ShA2_Y-UWkN8ZdfDBG2B6Eqpz2WXbs,91
-meerschaum-2.3.0rc5.dist-info/entry_points.txt,sha256=5YBVzibw-0rNA_1VjB16z5GABsOGf-CDhW4yqH8C7Gc,88
-meerschaum-2.3.0rc5.dist-info/top_level.txt,sha256=bNoSiDj0El6buocix-FRoAtJOeq1qOF5rRm2u9i7Q6A,11
-meerschaum-2.3.0rc5.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
-meerschaum-2.3.0rc5.dist-info/RECORD,,
+meerschaum-2.3.1.dist-info/LICENSE,sha256=jG2zQEdRNt88EgHUWPpXVWmOrOduUQRx7MnYV9YIPaw,11359
+meerschaum-2.3.1.dist-info/METADATA,sha256=Lti-2o_--dQLu348PyBKyfN4Yi3k_SgQaVMV2JuK2BY,24006
+meerschaum-2.3.1.dist-info/NOTICE,sha256=OTA9Fcthjf5BRvWDDIcBC_xfLpeDV-RPZh3M-HQBRtQ,114
+meerschaum-2.3.1.dist-info/WHEEL,sha256=R0nc6qTxuoLk7ShA2_Y-UWkN8ZdfDBG2B6Eqpz2WXbs,91
+meerschaum-2.3.1.dist-info/entry_points.txt,sha256=5YBVzibw-0rNA_1VjB16z5GABsOGf-CDhW4yqH8C7Gc,88
+meerschaum-2.3.1.dist-info/top_level.txt,sha256=bNoSiDj0El6buocix-FRoAtJOeq1qOF5rRm2u9i7Q6A,11
+meerschaum-2.3.1.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+meerschaum-2.3.1.dist-info/RECORD,,

meerschaum/jobs/_LocalExecutor.py

@@ -1,88 +0,0 @@
-#! /usr/bin/env python3
-# vim:fenc=utf-8
-
-"""
-Run jobs locally.
-"""
-
-from meerschaum.utils.typing import Dict, Any, List, SuccessTuple, Union
-from meerschaum.jobs import Job, Executor, make_executor
-from meerschaum.utils.daemon import Daemon, get_daemons
-from meerschaum._internal.entry import entry
-
-
-@make_executor
-class LocalExecutor(Executor):
-    """
-    Run jobs locally as Unix daemons.
-    """
-
-    def get_job_daemon(
-        self,
-        name: str,
-        #  sysargs: Opt
-        debug: bool = False,
-    ) -> Union[Daemon, None]:
-        """
-        Return a job's daemon if it exists.
-        """
-        try:
-            daemon = Daemon(name)
-        except Exception:
-            daemon = None
-
-        return daemon
-    
-    def get_daemon_syargs(self, name: str, debug: bool = False) -> Union[List[str], None]:
-        """
-        Return the list of sysargs from the job's daemon.
-        """
-        daemon = self.get_job_daemon(name, debug=debug)
-
-        if daemon is None:
-            return None
-
-        return daemon.properties.get('target', {}).get('args', [None])[0]
-
-    def get_job_exists(self, name: str, debug: bool = False) -> bool:
-        """
-        Return whether a job exists.
-        """
-        daemon = self.get_job_daemon(name, debug=debug)
-        if daemon is None:
-            return False
-    
-    def get_jobs(self) -> Dict[str, Job]:
-        """
-        Return a dictionary of names -> Jobs.
-        """
-
-    def create_job(self, name: str, sysargs: List[str], debug: bool = False) -> SuccessTuple:
-        """
-        Create a new job.
-        """
-
-    def start_job(self, name: str, debug: bool = False) -> SuccessTuple:
-        """
-        Start a job.
-        """
-
-    def stop_job(self, name: str, debug: bool = False) -> SuccessTuple:
-        """
-        Stop a job.
-        """
-
-    def pause_job(self, name: str, debug: bool = False) -> SuccessTuple:
-        """
-        Pause a job.
-        """
-
-    def delete_job(self, name: str, debug: bool = False) -> SuccessTuple:
-        """
-        Delete a job.
-        """
-
-    def get_logs(self, name: str, debug: bool = False) -> str:
-        """
-        Return a job's log output.
-        """