meerschaum 2.0.0rc6__py3-none-any.whl → 2.0.0rc8__py3-none-any.whl

meerschaum/_internal/arguments/_parse_arguments.py

@@ -8,6 +8,8 @@ This module contains functions for parsing arguments
 """
 
 from __future__ import annotations
+import json
+from datetime import timedelta
 from meerschaum.utils.typing import List, Dict, Any, Optional, Callable, SuccessTuple
 from meerschaum.utils.threading import RLock
 
@@ -178,6 +180,16 @@ def parse_synonyms(
         args_dict['check_existing'] = False
     if args_dict.get('venv', None) in ('None', '[None]'):
         args_dict['venv'] = None
+    chunk_minutes = args_dict.get('chunk_minutes', None)
+    chunk_hours = args_dict.get('chunk_hours', None)
+    chunk_days = args_dict.get('chunk_days', None)
+    if isinstance(chunk_minutes, int):
+        args_dict['chunk_interval'] = timedelta(minutes=chunk_minutes)
+    elif isinstance(chunk_hours, int):
+        args_dict['chunk_interval'] = timedelta(hours=chunk_hours)
+    elif isinstance(chunk_days, int):
+        args_dict['chunk_interval'] = timedelta(days=chunk_days)
+
     return args_dict
 
 
@@ -185,7 +197,6 @@ def parse_dict_to_sysargs(
         args_dict : Dict[str, Any]
     ) -> List[str]:
     """Revert an arguments dictionary back to a command line list."""
-    import json
     from meerschaum._internal.arguments._parser import get_arguments_triggers
     sysargs = []
     sysargs += args_dict.get('action', [])

meerschaum/_internal/arguments/_parser.py

@@ -227,7 +227,22 @@ groups['sync'].add_argument(
 )
 groups['sync'].add_argument(
     '--chunksize', type=int, help=(
-        "Specify the chunksize for syncing and retrieving data. Defaults to 900."
+        "Specify the database chunksize. Defaults to 10,000."
+    ),
+)
+groups['sync'].add_argument(
+    '--chunk-minutes', type=int, help=(
+        "Specify the chunk interval in minutes for verification syncs. Defaults to 1440."
+    ),
+)
+groups['sync'].add_argument(
+    '--chunk-hours', type=int, help=(
+        "Specify the chunk interval in days for verification syncs. See `--chunk-minutes`."
+    ),
+)
+groups['sync'].add_argument(
+    '--chunk-days', type=int, help=(
+        "Specify the chunk interval in days for verification syncs. See `--chunk-minutes`."
     ),
 )
 groups['sync'].add_argument(
@@ -237,6 +252,13 @@ groups['sync'].add_argument(
     '--deduplicate', '--dedup', action="store_true",
     help="Remove duplicate rows from a pipe's table.",
 )
+groups['sync'].add_argument(
+    '--bounded', '--bound', action="store_true",
+    help = (
+        "When verifying, do not sync outside "
+        + "the existing oldest and newest datetime bounds."
+    )
+)
 groups['sync'].add_argument(
     '--skip-check-existing', '--allow-duplicates', action='store_true',
     help = (

meerschaum/actions/__init__.py

@@ -11,51 +11,6 @@ from meerschaum.utils.typing import Callable, Any, Optional, Union, List, Dict,
 from meerschaum.utils.packages import get_modules_from_package
 _custom_actions = []
 
-### build __all__ from other .py files in this package
-import sys
-modules = get_modules_from_package(
-    sys.modules[__name__],
-    names = False,
-)
-__all__ = ['actions', 'get_subactions', 'get_action', 'get_main_action_name', 'get_completer']
-
-### Build the actions dictionary by importing all
-### functions that do not begin with '_' from all submodules.
-from inspect import getmembers, isfunction
-actions = {}
-"This docstring will be replaced in __pdoc__ at the end of this file."
-
-for module in modules:
-    ### A couple important things happening here:
-    ### 1. Find all functions in all modules in `actions` package
-    ###     (skip functions that begin with '_')
-    ### 2. Add them as members to the Shell class
-    ###     - Original definition : meerschaum._internal.shell.Shell
-    ###     - New definition      : meerschaum._internal.Shell
-    ### 3. Populate the actions dictionary with function names and functions
-    ###
-    ### UPDATE:
-    ### Shell modifications have been deferred to get_shell in order to improve lazy loading.
-
-    actions.update(
-        dict(
-            [
-                ### __name__ and new function pointer
-                (ob[0], ob[1])
-                    for ob in getmembers(module)
-                        if isfunction(ob[1])
-                            ### check that the function belongs to the module
-                            and ob[0] == module.__name__.replace('_', '').split('.')[-1]
-                            ### skip functions that start with '_'
-                            and ob[0][0] != '_'
-            ]
-        )
-    )
-
-original_actions = actions.copy()
-from meerschaum._internal.entry import entry
-
-
 def get_subactions(
         action: Union[str, List[str]],
         _actions: Optional[Dict[str, Callable[[Any], Any]]] = None,
@@ -273,14 +228,108 @@ def choose_subaction(
     return options[parsed_choice](**kw)
 
 
-from meerschaum._internal.entry import get_shell
+def _get_subaction_names(action: str, globs: dict = None) -> List[str]:
+    """Use `meerschaum.actions.get_subactions()` instead."""
+    if globs is None:
+        import importlib
+        module = importlib.import_module(f'meerschaum.actions.{action}')
+        globs = vars(module)
+    subactions = []
+    for item in globs:
+        if f'_{action}' in item and 'complete' not in item.lstrip('_'):
+            subactions.append(globs[item])
+    return subactions
+
+
+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.
+
+    Parameters
+    ----------
+    action: str
+        The name of the action module (e.g. 'install').
+        
+    globs: Optional[Dict[str, Any]], default None
+        An optional dictionary of global variables.
+
+    Returns
+    -------
+    The generated docstring for the module.
+
+    Examples
+    --------
+    >>> from meerschaum.utils.misc import choices_docstring as _choices_docstring
+    >>> install.__doc__ += _choices_docstring('install')
+
+    """
+    options_str = f"\n    Options:\n        `{action} "
+    subactions = _get_subaction_names(action, globs=globs)
+    options_str += "["
+    sa_names = []
+    for sa in subactions:
+        try:
+            sa_names.append(sa.__name__[len(f"_{action}") + 1:])
+        except Exception as e:
+            print(e)
+            return ""
+    for sa_name in sorted(sa_names):
+        options_str += f"{sa_name}, "
+    options_str = options_str[:-2] + "]`"
+    return options_str
+
+### build __all__ from other .py files in this package
+import sys
+modules = get_modules_from_package(
+    sys.modules[__name__],
+    names = False,
+)
+__all__ = ['actions', 'get_subactions', 'get_action', 'get_main_action_name', 'get_completer']
+
+### Build the actions dictionary by importing all
+### functions that do not begin with '_' from all submodules.
+from inspect import getmembers, isfunction
+actions = {}
+"This docstring will be replaced in __pdoc__ at the end of this file."
+
+for module in modules:
+    ### A couple important things happening here:
+    ### 1. Find all functions in all modules in `actions` package
+    ###     (skip functions that begin with '_')
+    ### 2. Add them as members to the Shell class
+    ###     - Original definition : meerschaum._internal.shell.Shell
+    ###     - New definition      : meerschaum._internal.Shell
+    ### 3. Populate the actions dictionary with function names and functions
+    ###
+    ### UPDATE:
+    ### Shell modifications have been deferred to get_shell in order to improve lazy loading.
+
+    actions.update(
+        dict(
+            [
+                ### __name__ and new function pointer
+                (ob[0], ob[1])
+                    for ob in getmembers(module)
+                        if isfunction(ob[1])
+                            ### check that the function belongs to the module
+                            and ob[0] == module.__name__.replace('_', '').split('.')[-1]
+                            ### skip functions that start with '_'
+                            and ob[0][0] != '_'
+            ]
+        )
+    )
+
+original_actions = actions.copy()
+from meerschaum._internal.entry import entry, get_shell
 import meerschaum.plugins
-#  meerschaum.plugins.load_plugins()
 make_action = meerschaum.plugins.make_action
 
 ### Instruct pdoc to skip the `meerschaum.actions.plugins` subdirectory.
 __pdoc__ = {
-    'plugins' : False, 'arguments': True, 'shell': False,
+    'plugins': False,
+    'arguments': True,
+    'shell': False,
     'actions': (
         "Access functions of the standard Meerschaum actions.\n\n"
         + "Visit the [actions reference page](https://meerschaum.io/reference/actions/) "

meerschaum/actions/bootstrap.py

@@ -416,5 +416,5 @@ def _bootstrap_config(
 ### NOTE: This must be the final statement of the module.
 ###       Any subactions added below these lines will not
 ###       be added to the `help` docstring.
-from meerschaum.utils.misc import choices_docstring as _choices_docstring
+from meerschaum.actions import choices_docstring as _choices_docstring
 bootstrap.__doc__ += _choices_docstring('bootstrap')

meerschaum/actions/clear.py

@@ -141,5 +141,5 @@ def _ask_with_rowcounts(
 ### NOTE: This must be the final statement of the module.
 ###       Any subactions added below these lines will not
 ###       be added to the `help` docstring.
-from meerschaum.utils.misc import choices_docstring as _choices_docstring
+from meerschaum.actions import choices_docstring as _choices_docstring
 clear.__doc__ += _choices_docstring('clear')

meerschaum/actions/deduplicate.py

@@ -38,5 +38,5 @@ def _deduplicate_pipes(**kwargs) -> SuccessTuple:
 ### NOTE: This must be the final statement of the module.
 ###       Any subactions added below these lines will not
 ###       be added to the `help` docstring.
-from meerschaum.utils.misc import choices_docstring as _choices_docstring
+from meerschaum.actions import choices_docstring as _choices_docstring
 deduplicate.__doc__ += _choices_docstring('deduplicate')

meerschaum/actions/delete.py

@@ -374,12 +374,12 @@ def _complete_delete_connectors(
     return get_connector_labels(*types, search_term=search_term)
 
 def _delete_jobs(
-        action : Optional[List[str]] = None,
-        noask : bool = False,
-        nopretty : bool = False,
-        force : bool = False,
-        yes : bool = False,
-        debug : bool = False,
+        action: Optional[List[str]] = None,
+        noask: bool = False,
+        nopretty: bool = False,
+        force: bool = False,
+        yes: bool = False,
+        debug: bool = False,
         **kw
     ) -> SuccessTuple:
     """
@@ -431,6 +431,7 @@ def _delete_jobs(
                 force = force,
                 noask = noask,
                 debug = debug,
+                **kw
             )
             ### Ensure the running jobs are dead.
             if get_running_daemons(daemons):
@@ -473,5 +474,5 @@ def _delete_jobs(
 ### NOTE: This must be the final statement of the module.
 ###       Any subactions added below these lines will not
 ###       be added to the `help` docstring.
-from meerschaum.utils.misc import choices_docstring as _choices_docstring
+from meerschaum.actions import choices_docstring as _choices_docstring
 delete.__doc__ += _choices_docstring('delete')

meerschaum/actions/drop.py

@@ -18,7 +18,6 @@ def drop(
     from meerschaum.actions import choose_subaction
     options = {
         'pipes'  : _drop_pipes,
-        'tables' : _drop_tables,
     }
     return choose_subaction(action, options, **kw)
 
@@ -79,17 +78,9 @@ def _drop_pipes(
     )
     return successes > 0, msg
 
-def _drop_tables(
-        action: Optional[List[str]] = None,
-        **kw: Any
-    ) -> SuccessTuple:
-    """
-    Drop SQL tables. WARNING: This is very dangerous!
-    """
-    return False, "Not implemented"
 
 ### NOTE: This must be the final statement of the module.
 ###       Any subactions added below these lines will not
 ###       be added to the `help` docstring.
-from meerschaum.utils.misc import choices_docstring as _choices_docstring
+from meerschaum.actions import choices_docstring as _choices_docstring
 drop.__doc__ += _choices_docstring('drop')

meerschaum/actions/edit.py

@@ -292,5 +292,5 @@ def _edit_users(
 ### NOTE: This must be the final statement of the module.
 ###       Any subactions added below these lines will not
 ###       be added to the `help` docstring.
-from meerschaum.utils.misc import choices_docstring as _choices_docstring
+from meerschaum.actions import choices_docstring as _choices_docstring
 edit.__doc__ += _choices_docstring('edit')

meerschaum/actions/install.py

@@ -236,5 +236,5 @@ def _complete_install_required(*args, **kw) -> List[str]:
 ### NOTE: This must be the final statement of the module.
 ###       Any subactions added below these lines will not
 ###       be added to the `help` docstring.
-from meerschaum.utils.misc import choices_docstring as _choices_docstring
+from meerschaum.actions import choices_docstring as _choices_docstring
 install.__doc__ += _choices_docstring('install')

meerschaum/actions/pause.py

@@ -124,5 +124,5 @@ def _pause_jobs(
 ### NOTE: This must be the final statement of the module.
 ###       Any subactions added below these lines will not
 ###       be added to the `help` docstring.
-from meerschaum.utils.misc import choices_docstring as _choices_docstring
+from meerschaum.actions import choices_docstring as _choices_docstring
 pause.__doc__ += _choices_docstring('pause')

meerschaum/actions/register.py

@@ -336,5 +336,5 @@ def _register_users(
 ### NOTE: This must be the final statement of the module.
 ###       Any subactions added below these lines will not
 ###       be added to the `help` docstring.
-from meerschaum.utils.misc import choices_docstring as _choices_docstring
+from meerschaum.actions import choices_docstring as _choices_docstring
 register.__doc__ += _choices_docstring('register')

meerschaum/actions/setup.py

@@ -108,5 +108,5 @@ def _complete_setup_plugins(*args, **kw) -> List[str]:
 ### NOTE: This must be the final statement of the module.
 ###       Any subactions added below these lines will not
 ###       be added to the `help` docstring.
-from meerschaum.utils.misc import choices_docstring as _choices_docstring
+from meerschaum.actions import choices_docstring as _choices_docstring
 setup.__doc__ += _choices_docstring('setup')

meerschaum/actions/show.py

@@ -733,5 +733,5 @@ def _show_environment(
 ### NOTE: This must be the final statement of the module.
 ###       Any subactions added below these lines will not
 ###       be added to the `help` docstring.
-from meerschaum.utils.misc import choices_docstring as _choices_docstring
+from meerschaum.actions import choices_docstring as _choices_docstring
 show.__doc__ += _choices_docstring('show')

meerschaum/actions/start.py

@@ -128,12 +128,16 @@ def _start_jobs(
     daemon_ids = get_daemon_ids()
 
     new_job = len(list(action)) > 0
-    _potential_jobs = {'known' : [], 'unknown' : []}
+    _potential_jobs = {'known': [], 'unknown': []}
 
     if action:
         for a in action:
-            _potential_jobs[('known' if a in daemon_ids else 'unknown')].append(a)
-        
+            _potential_jobs[(
+                'known'
+                if a in daemon_ids
+                else 'unknown'
+            )].append(a)
+
         ### Check if the job is named after an action.
         if (
             _potential_jobs['known']
@@ -144,7 +148,7 @@ def _start_jobs(
             _potential_jobs['unknown'].insert(0, _potential_jobs['known'][0])
             del _potential_jobs['known'][0]
 
-        ### Only spawn a new job if we don't don't find any jobs.
+        ### Only spawn a new job if we don't find any jobs.
         new_job = (len(_potential_jobs['known']) == 0)
         if not new_job and _potential_jobs['unknown']:
             if not kw.get('nopretty', False):
@@ -171,7 +175,7 @@ def _start_jobs(
             return False, msg
 
     ### No action provided but a --name was. Start job if possible.
-    ### E.g. `start job --myjob`
+    ### E.g. `start job --name myjob`
     elif name is not None:
         new_job = False
         names = [name]
@@ -215,7 +219,10 @@ def _start_jobs(
         try:
             _daemon_sysargs = daemon.properties['target']['args'][0]
         except KeyError:
-            return False, "Failed to get arguments for daemon '{dameon.daemon_id}'."
+            return (
+                (False, f"Failed to get arguments for daemon '{daemon.daemon_id}'."),
+                daemon.daemon_id
+            )
         _daemon_kw = parse_arguments(_daemon_sysargs)
         _daemon_kw['name'] = daemon.daemon_id
         _action_success_tuple = daemon_action(**_daemon_kw)
@@ -277,7 +284,11 @@ def _start_jobs(
 
     _successes, _failures = [], []
     for _name in names:
-        success_tuple, __name = _run_new_job(_name) if new_job else _run_existing_job(_name)
+        success_tuple, __name = (
+            _run_new_job(_name)
+            if new_job
+            else _run_existing_job(_name)
+        )
         if not kw.get('nopretty', False):
             print_tuple(success_tuple)
         _successes.append(_name) if success_tuple[0] else _failures.append(_name)

meerschaum/actions/stop.py

@@ -50,6 +50,7 @@ def _complete_stop(
 
 def _stop_jobs(
         action: Optional[List[str]] = None,
+        timeout_seconds: Optional[int] = None,
         noask: bool = False,
         force: bool = False,
         yes: bool = False,
@@ -93,18 +94,18 @@ def _stop_jobs(
 
     _quit_daemons, _kill_daemons = [], []
     for d in daemons_to_stop:
-        quit_success, quit_msg = d.quit()
+        quit_success, quit_msg = d.quit(timeout=timeout_seconds)
         if quit_success:
             _quit_daemons.append(d)
             continue
         else:
             warn(
-                f"Failed to gracefully quit job '{d.daemon_id}', attempting to terminate:\n"
+                f"Failed to gracefully quit job '{d.daemon_id}', attempting to terminate:\n   "
                 + f"{quit_msg}",
                 stack = False,
             )
 
-        kill_success, kill_msg = d.kill()
+        kill_success, kill_msg = d.kill(timeout=timeout_seconds)
         if kill_success:
             _kill_daemons.append(d)
             continue
@@ -126,5 +127,5 @@ def _stop_jobs(
 ### NOTE: This must be the final statement of the module.
 ###       Any subactions added below these lines will not
 ###       be added to the `help` docstring.
-from meerschaum.utils.misc import choices_docstring as _choices_docstring
+from meerschaum.actions import choices_docstring as _choices_docstring
 stop.__doc__ += _choices_docstring('stop')

meerschaum/actions/sync.py

@@ -9,7 +9,8 @@ NOTE: `sync` required a SQL connection and is not intended for client use
 """
 
 from __future__ import annotations
-from meerschaum.utils.typing import SuccessTuple, Any, List, Optional, Tuple
+from datetime import timedelta
+from meerschaum.utils.typing import SuccessTuple, Any, List, Optional, Tuple, Union
 
 def sync(
         action: Optional[List[str]] = None,
@@ -43,6 +44,8 @@ def _pipes_lap(
         min_seconds: int = 1,
         verify: bool = False,
         deduplicate: bool = False,
+        bounded: Optional[bool] = None,
+        chunk_interval: Union[timedelta, int, None] = None,
         mrsm_instance: Optional[str] = None,
         timeout_seconds: Optional[int] = None,
         nopretty: bool = False,
@@ -87,6 +90,8 @@ def _pipes_lap(
         'mrsm_instance': mrsm_instance,
         'verify': verify,
         'deduplicate': deduplicate,
+        'bounded': bounded,
+        'chunk_interval': chunk_interval,
     })
     locks = {'remaining_count': Lock(), 'results_dict': Lock(), 'pipes_threads': Lock(),}
     pipes = get_pipes(
@@ -149,6 +154,7 @@ def _pipes_lap(
                 ) + msg + '\n'
                 print_tuple(
                     (success, msg),
+                    calm = True,
                     _progress = _progress,
                 )
             _checkpoint(_progress=_progress, _task=_task)
@@ -238,6 +244,8 @@ def _sync_pipes(
         unblock: bool = False,
         verify: bool = False,
         deduplicate: bool = False,
+        bounded: Optional[bool] = None,
+        chunk_interval: Union[timedelta, int, None] = None,
         shell: bool = False,
         nopretty: bool = False,
         debug: bool = False,
@@ -280,12 +288,15 @@ def _sync_pipes(
         lap_begin = time.perf_counter()
 
         try:
+            results_dict = {}
             with cm:
                 results_dict = _pipes_lap(
                     min_seconds = min_seconds,
                     _progress = _progress,
                     verify = verify,
                     deduplicate = deduplicate,
+                    bounded = bounded,
+                    chunk_interval = chunk_interval,
                     unblock = unblock,
                     debug = debug,
                     nopretty = nopretty,
@@ -373,6 +384,8 @@ def _wrap_sync_pipe(
         workers = None,
         verify: bool = False,
         deduplicate: bool = False,
+        bounded: Optional[bool] = None,
+        chunk_interval: Union[timedelta, int, None] = None,
         **kw
     ):
     """
@@ -395,6 +408,8 @@ def _wrap_sync_pipe(
                 debug = debug,
                 min_seconds = min_seconds,
                 workers = workers,
+                bounded = bounded,
+                chunk_interval = chunk_interval,
                 **{k: v for k, v in kw.items() if k != 'blocking'}
             )
     except Exception as e:
@@ -410,5 +425,5 @@ def _wrap_sync_pipe(
 ### NOTE: This must be the final statement of the module.
 ###       Any subactions added below these lines will not
 ###       be added to the `help` docstring.
-from meerschaum.utils.misc import choices_docstring as _choices_docstring
+from meerschaum.actions import choices_docstring as _choices_docstring
 sync.__doc__ += _choices_docstring('sync')

meerschaum/actions/uninstall.py

@@ -192,5 +192,5 @@ def _uninstall_packages(
 ### NOTE: This must be the final statement of the module.
 ###       Any subactions added below these lines will not
 ###       be added to the `help` docstring.
-from meerschaum.utils.misc import choices_docstring as _choices_docstring
+from meerschaum.actions import choices_docstring as _choices_docstring
 uninstall.__doc__ += _choices_docstring('uninstall')

meerschaum/actions/upgrade.py

@@ -213,5 +213,5 @@ def _upgrade_plugins(
 ### NOTE: This must be the final statement of the module.
 ###       Any subactions added below these lines will not
 ###       be added to the `help` docstring.
-from meerschaum.utils.misc import choices_docstring as _choices_docstring
+from meerschaum.actions import choices_docstring as _choices_docstring
 upgrade.__doc__ += _choices_docstring('upgrade')

meerschaum/actions/verify.py

@@ -11,7 +11,7 @@ from meerschaum.utils.typing import Union, Any, Sequence, SuccessTuple, Optional
 
 def verify(
         action: Optional[List[str]] = None,
-        **kw
+        **kwargs: Any
     ) -> SuccessTuple:
     """
     Verify the states of pipes, packages, and more.
@@ -21,8 +21,9 @@ def verify(
         'pipes': _verify_pipes,
         'packages': _verify_packages,
         'venvs': _verify_venvs,
+        'plugins': _verify_plugins,
     }
-    return choose_subaction(action, options, **kw)
+    return choose_subaction(action, options, **kwargs)
 
 
 def _verify_pipes(**kwargs) -> SuccessTuple:
@@ -92,8 +93,58 @@ def _verify_venvs(
     return True, "Success"
 
 
+def _verify_plugins(
+        action: Optional[List[str]] = None,
+        **kwargs: Any
+    ) -> SuccessTuple:
+    """
+    Verify that all of the available plugins are able to be imported as expected.
+    """
+    from meerschaum.utils.formatting import print_options, UNICODE, print_tuple
+    from meerschaum.plugins import import_plugins, get_plugins_names, Plugin
+    from meerschaum.config import get_config
+    from meerschaum.utils.misc import items_str
+
+    plugins_names_to_verify = action or get_plugins_names()
+    if not plugins_names_to_verify:
+        if not action:
+            return True, "There are no installed plugins; nothing to do."
+        return False, f"Unable to verify plugins {items_str(action)}."
+
+    header = f"Verifying {len(plugins_names_to_verify)} plugins"
+    print_options(
+        plugins_names_to_verify,
+        header = header,
+    )
+
+    failed_to_import = []
+    for plugin_name in plugins_names_to_verify:
+        plugin = Plugin(plugin_name)
+        plugin_success = plugin.module is not None
+        if not plugin_success:
+            failed_to_import.append(plugin)
+        plugin_msg = (
+            (f"Imported plugin '{plugin}'.")
+            if plugin_success
+            else (f"Failed to import plugin '{plugin}'.")
+        )
+        print_tuple((plugin_success, plugin_msg), calm=True)
+
+    success = len(failed_to_import) == 0
+    message = (
+        f"Successfully imported {len(plugins_names_to_verify)} plugins."
+        if success
+        else (
+            f"Failed to import plugin"
+            + ('s' if len(failed_to_import) != 1 else '')
+            + f" {items_str(failed_to_import)}."
+        )
+    )
+    return success, message
+
+
 ### NOTE: This must be the final statement of the module.
 ###       Any subactions added below these lines will not
 ###       be added to the `help` docstring.
-from meerschaum.utils.misc import choices_docstring as _choices_docstring
+from meerschaum.actions import choices_docstring as _choices_docstring
 verify.__doc__ += _choices_docstring('verify')