meerschaum 2.2.7__py3-none-any.whl → 2.3.0.dev1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (50) hide show
  1. meerschaum/__init__.py +4 -1
  2. meerschaum/_internal/arguments/_parser.py +44 -15
  3. meerschaum/_internal/entry.py +22 -1
  4. meerschaum/_internal/shell/Shell.py +129 -31
  5. meerschaum/actions/api.py +12 -12
  6. meerschaum/actions/attach.py +95 -0
  7. meerschaum/actions/delete.py +35 -26
  8. meerschaum/actions/show.py +119 -148
  9. meerschaum/actions/start.py +85 -75
  10. meerschaum/actions/stop.py +68 -39
  11. meerschaum/api/_events.py +18 -1
  12. meerschaum/api/_oauth2.py +2 -0
  13. meerschaum/api/_websockets.py +2 -2
  14. meerschaum/api/dash/jobs.py +5 -2
  15. meerschaum/api/routes/__init__.py +1 -0
  16. meerschaum/api/routes/_actions.py +122 -44
  17. meerschaum/api/routes/_jobs.py +340 -0
  18. meerschaum/api/routes/_pipes.py +5 -5
  19. meerschaum/config/_default.py +1 -0
  20. meerschaum/config/_paths.py +1 -0
  21. meerschaum/config/_shell.py +8 -3
  22. meerschaum/config/_version.py +1 -1
  23. meerschaum/config/static/__init__.py +8 -0
  24. meerschaum/connectors/__init__.py +9 -11
  25. meerschaum/connectors/api/APIConnector.py +18 -1
  26. meerschaum/connectors/api/_actions.py +60 -71
  27. meerschaum/connectors/api/_jobs.py +260 -0
  28. meerschaum/connectors/parse.py +23 -7
  29. meerschaum/plugins/__init__.py +89 -5
  30. meerschaum/utils/daemon/Daemon.py +255 -30
  31. meerschaum/utils/daemon/FileDescriptorInterceptor.py +5 -5
  32. meerschaum/utils/daemon/RotatingFile.py +10 -6
  33. meerschaum/utils/daemon/StdinFile.py +110 -0
  34. meerschaum/utils/daemon/__init__.py +13 -7
  35. meerschaum/utils/formatting/__init__.py +2 -1
  36. meerschaum/utils/formatting/_jobs.py +83 -54
  37. meerschaum/utils/formatting/_shell.py +6 -0
  38. meerschaum/utils/jobs/_Job.py +684 -0
  39. meerschaum/utils/jobs/__init__.py +245 -0
  40. meerschaum/utils/misc.py +18 -17
  41. meerschaum/utils/packages/_packages.py +2 -2
  42. meerschaum/utils/prompt.py +16 -8
  43. {meerschaum-2.2.7.dist-info → meerschaum-2.3.0.dev1.dist-info}/METADATA +9 -9
  44. {meerschaum-2.2.7.dist-info → meerschaum-2.3.0.dev1.dist-info}/RECORD +50 -44
  45. {meerschaum-2.2.7.dist-info → meerschaum-2.3.0.dev1.dist-info}/WHEEL +1 -1
  46. {meerschaum-2.2.7.dist-info → meerschaum-2.3.0.dev1.dist-info}/LICENSE +0 -0
  47. {meerschaum-2.2.7.dist-info → meerschaum-2.3.0.dev1.dist-info}/NOTICE +0 -0
  48. {meerschaum-2.2.7.dist-info → meerschaum-2.3.0.dev1.dist-info}/entry_points.txt +0 -0
  49. {meerschaum-2.2.7.dist-info → meerschaum-2.3.0.dev1.dist-info}/top_level.txt +0 -0
  50. {meerschaum-2.2.7.dist-info → meerschaum-2.3.0.dev1.dist-info}/zip-safe +0 -0
@@ -33,7 +33,7 @@ class APIConnector(Connector):
33
33
  delete,
34
34
  wget,
35
35
  )
36
- from ._actions import get_actions, do_action
36
+ from ._actions import get_actions, do_action, do_action_async
37
37
  from ._misc import get_mrsm_version, get_chaining_status
38
38
  from ._pipes import (
39
39
  register_pipe,
@@ -72,6 +72,23 @@ class APIConnector(Connector):
72
72
  get_user_attributes,
73
73
  )
74
74
  from ._uri import from_uri
75
+ from ._jobs import (
76
+ get_jobs,
77
+ get_job,
78
+ get_job_metadata,
79
+ get_job_properties,
80
+ get_job_exists,
81
+ delete_job,
82
+ start_job,
83
+ create_job,
84
+ stop_job,
85
+ pause_job,
86
+ get_logs,
87
+ get_job_stop_time,
88
+ monitor_logs,
89
+ monitor_logs_async,
90
+ get_job_is_blocking_on_stdin,
91
+ )
75
92
 
76
93
  def __init__(
77
94
  self,
@@ -7,81 +7,70 @@ Functions to interact with /mrsm/actions
7
7
  """
8
8
 
9
9
  from __future__ import annotations
10
- from meerschaum.utils.typing import SuccessTuple, Optional, List
11
10
 
12
- def get_actions(self) -> list:
11
+ import json
12
+ import asyncio
13
+ from functools import partial
14
+
15
+ import meerschaum as mrsm
16
+ from meerschaum.utils.typing import SuccessTuple, List, Callable
17
+ from meerschaum.config.static import STATIC_CONFIG
18
+
19
+ ACTIONS_ENDPOINT: str = STATIC_CONFIG['api']['endpoints']['actions']
20
+
21
+
22
+ def get_actions(self):
13
23
  """Get available actions from the API instance."""
14
- from meerschaum.config.static import STATIC_CONFIG
15
- return self.get(STATIC_CONFIG['api']['endpoints']['actions'])
24
+ return self.get(ACTIONS_ENDPOINT)
25
+
26
+
27
+ def do_action(self, sysargs: List[str]) -> SuccessTuple:
28
+ """
29
+ Execute a Meerschaum action remotely.
30
+ """
31
+ return asyncio.run(self.do_action_async(sysargs))
16
32
 
17
33
 
18
- def do_action(
34
+ async def do_action_async(
19
35
  self,
20
- action: Optional[List[str]] = None,
21
- sysargs: Optional[List[str]] = None,
22
- debug: bool = False,
23
- **kw
36
+ sysargs: List[str],
37
+ callback_function: Callable[[str], None] = partial(print, end=''),
24
38
  ) -> SuccessTuple:
25
- """Execute a Meerschaum action remotely.
26
-
27
- If `sysargs` are provided, parse those instead.
28
- Otherwise infer everything from keyword arguments.
29
-
30
- Examples
31
- --------
32
- >>> conn = mrsm.get_connector('api:main')
33
- >>> conn.do_action(['show', 'pipes'])
34
- (True, "Success")
35
- >>> conn.do_action(['show', 'arguments'], name='test')
36
- (True, "Success")
37
39
  """
38
- import sys, json
39
- from meerschaum.utils.debug import dprint
40
- from meerschaum.config.static import STATIC_CONFIG
41
- from meerschaum.utils.misc import json_serialize_datetime
42
- if action is None:
43
- action = []
44
-
45
- if sysargs is not None and action and action[0] == '':
46
- from meerschaum._internal.arguments import parse_arguments
47
- if debug:
48
- dprint(f"Parsing sysargs:\n{sysargs}")
49
- json_dict = parse_arguments(sysargs)
50
- else:
51
- json_dict = kw
52
- json_dict['action'] = action
53
- if 'noask' not in kw:
54
- json_dict['noask'] = True
55
- if 'yes' not in kw:
56
- json_dict['yes'] = True
57
- if debug:
58
- json_dict['debug'] = debug
59
-
60
- root_action = json_dict['action'][0]
61
- del json_dict['action'][0]
62
- r_url = f"{STATIC_CONFIG['api']['endpoints']['actions']}/{root_action}"
63
-
64
- if debug:
65
- from meerschaum.utils.formatting import pprint
66
- dprint(f"Sending data to '{self.url + r_url}':")
67
- pprint(json_dict, stream=sys.stderr)
68
-
69
- response = self.post(
70
- r_url,
71
- data = json.dumps(json_dict, default=json_serialize_datetime),
72
- debug = debug,
73
- )
74
- try:
75
- response_list = json.loads(response.text)
76
- if isinstance(response_list, dict) and 'detail' in response_list:
77
- return False, response_list['detail']
78
- except Exception as e:
79
- print(f"Invalid response: {response}")
80
- print(e)
81
- return False, response.text
82
- if debug:
83
- dprint(response)
84
- try:
85
- return response_list[0], response_list[1]
86
- except Exception as e:
87
- return False, f"Failed to parse result from action '{root_action}'"
40
+ Monitor a job's log files and await a callback with the changes.
41
+ """
42
+ websockets, websockets_exceptions = mrsm.attempt_import('websockets', 'websockets.exceptions')
43
+ protocol = 'ws' if self.URI.startswith('http://') else 'wss'
44
+ port = self.port if 'port' in self.__dict__ else ''
45
+ uri = f"{protocol}://{self.host}:{port}{ACTIONS_ENDPOINT}/ws"
46
+ if sysargs and sysargs[0] == 'api' and len(sysargs) > 2:
47
+ sysargs = sysargs[2:]
48
+
49
+ sysargs_str = json.dumps(sysargs)
50
+
51
+ async with websockets.connect(uri) as websocket:
52
+ try:
53
+ await websocket.send(self.token or 'no-login')
54
+ response = await websocket.recv()
55
+ init_data = json.loads(response)
56
+ if not init_data.get('is_authenticated'):
57
+ return False, "Cannot authenticate with actions endpoint."
58
+
59
+ await websocket.send(sysargs_str)
60
+ except websockets_exceptions.ConnectionClosedOK:
61
+ return False, "Connection was closed."
62
+
63
+ while True:
64
+ try:
65
+ line = await websocket.recv()
66
+ if asyncio.iscoroutinefunction(callback_function):
67
+ await callback_function(line)
68
+ else:
69
+ callback_function(line)
70
+ except KeyboardInterrupt:
71
+ await websocket.close()
72
+ break
73
+ except websockets_exceptions.ConnectionClosedOK:
74
+ break
75
+
76
+ return True, "Success"
@@ -0,0 +1,260 @@
1
+ #! /usr/bin/env python3
2
+ # -*- coding: utf-8 -*-
3
+ # vim:fenc=utf-8
4
+
5
+ """
6
+ Manage jobs via the Meerschaum API.
7
+ """
8
+
9
+ import asyncio
10
+ from datetime import datetime
11
+
12
+ import meerschaum as mrsm
13
+ from meerschaum.utils.typing import Dict, Any, SuccessTuple, List, Union, Callable
14
+ from meerschaum.utils.jobs import Job
15
+ from meerschaum.config.static import STATIC_CONFIG
16
+ from meerschaum.utils.warnings import warn
17
+
18
+ JOBS_ENDPOINT: str = STATIC_CONFIG['api']['endpoints']['jobs']
19
+ LOGS_ENDPOINT: str = STATIC_CONFIG['api']['endpoints']['logs']
20
+ JOBS_STDIN_MESSAGE: str = STATIC_CONFIG['api']['jobs']['stdin_message']
21
+
22
+
23
+ def get_jobs(self, debug: bool = False) -> Dict[str, Job]:
24
+ """
25
+ Return a dictionary of remote jobs.
26
+ """
27
+ response = self.get(JOBS_ENDPOINT, debug=debug)
28
+ if not response:
29
+ warn(f"Failed to get remote jobs from {self}.")
30
+ return {}
31
+ return {
32
+ name: Job(
33
+ name,
34
+ job_meta['sysargs'],
35
+ executor_keys=str(self),
36
+ _properties=job_meta['daemon']['properties']
37
+ )
38
+ for name, job_meta in response.json().items()
39
+ }
40
+
41
+
42
+ def get_job(self, name: str, debug: bool = False) -> Job:
43
+ """
44
+ Return a single Job object.
45
+ """
46
+ metadata = self.get_job_metadata(name, debug=debug)
47
+ if not metadata:
48
+ raise ValueError(f"Job '{name}' does not exist.")
49
+
50
+ return Job(
51
+ name,
52
+ metadata['sysargs'],
53
+ executor_keys=str(self),
54
+ _properties=metadata['daemon']['properties'],
55
+ )
56
+
57
+
58
+ def get_job_metadata(self, name: str, debug: bool = False) -> Dict[str, Any]:
59
+ """
60
+ Return the metadata for a single job.
61
+ """
62
+ response = self.get(JOBS_ENDPOINT + f"/{name}", debug=debug)
63
+ if not response:
64
+ if debug:
65
+ msg = (
66
+ response.json()['detail']
67
+ if 'detail' in response.text
68
+ else response.text
69
+ )
70
+ warn(f"Failed to get metadata for job '{name}':\n{msg}")
71
+ return {}
72
+
73
+ return response.json()
74
+
75
+
76
+ def get_job_properties(self, name: str, debug: bool = False) -> Dict[str, Any]:
77
+ """
78
+ Return the daemon properties for a single job.
79
+ """
80
+ metadata = self.get_job_metadata(name, debug=debug)
81
+ return metadata.get('daemon', {}).get('properties', {})
82
+
83
+
84
+ def get_job_exists(self, name: str, debug: bool = False) -> bool:
85
+ """
86
+ Return whether a job exists.
87
+ """
88
+ response = self.get(JOBS_ENDPOINT + f'/{name}/exists', debug=debug)
89
+ if not response:
90
+ warn(f"Failed to determine whether job '{name}' exists.")
91
+ return False
92
+
93
+ return response.json()
94
+
95
+
96
+ def delete_job(self, name: str, debug: bool = False) -> SuccessTuple:
97
+ """
98
+ Delete a job.
99
+ """
100
+ response = self.delete(JOBS_ENDPOINT + f"/{name}", debug=debug)
101
+ if not response:
102
+ if 'detail' in response.text:
103
+ return False, response.json()['detail']
104
+
105
+ return False, response.text
106
+
107
+ return tuple(response.json())
108
+
109
+
110
+ def start_job(self, name: str, debug: bool = False) -> SuccessTuple:
111
+ """
112
+ Start a job.
113
+ """
114
+ response = self.post(JOBS_ENDPOINT + f"/{name}/start", debug=debug)
115
+ if not response:
116
+ if 'detail' in response.text:
117
+ return False, response.json()['detail']
118
+ return False, response.text
119
+
120
+ return tuple(response.json())
121
+
122
+
123
+ def create_job(self, name: str, sysargs: List[str], debug: bool = False) -> SuccessTuple:
124
+ """
125
+ Create a job.
126
+ """
127
+ response = self.post(JOBS_ENDPOINT + f"/{name}", json=sysargs, debug=debug)
128
+ if not response:
129
+ if 'detail' in response.text:
130
+ return False, response.json()['detail']
131
+ return False, response.text
132
+
133
+ return tuple(response.json())
134
+
135
+
136
+ def stop_job(self, name: str, debug: bool = False) -> SuccessTuple:
137
+ """
138
+ Stop a job.
139
+ """
140
+ response = self.post(JOBS_ENDPOINT + f"/{name}/stop", debug=debug)
141
+ if not response:
142
+ if 'detail' in response.text:
143
+ return False, response.json()['detail']
144
+ return False, response.text
145
+
146
+ return tuple(response.json())
147
+
148
+
149
+ def pause_job(self, name: str, debug: bool = False) -> SuccessTuple:
150
+ """
151
+ Pause a job.
152
+ """
153
+ response = self.post(JOBS_ENDPOINT + f"/{name}/pause", debug=debug)
154
+ if not response:
155
+ if 'detail' in response.text:
156
+ return False, response.json()['detail']
157
+ return False, response.text
158
+
159
+ return tuple(response.json())
160
+
161
+
162
+ def get_logs(self, name: str, debug: bool = False) -> str:
163
+ """
164
+ Return the logs for a job.
165
+ """
166
+ response = self.get(LOGS_ENDPOINT + f"/{name}")
167
+ if not response:
168
+ raise ValueError(f"Cannot fetch logs for job '{name}':\n{response.text}")
169
+
170
+ return response.json()
171
+
172
+
173
+ def get_job_stop_time(self, name: str, debug: bool = False) -> Union[datetime, None]:
174
+ """
175
+ Return the job's manual stop time.
176
+ """
177
+ response = self.get(JOBS_ENDPOINT + f"/{name}/stop_time")
178
+ if not response:
179
+ warn(f"Failed to get stop time for job '{name}':\n{response.text}")
180
+ return None
181
+
182
+ data = response.json()
183
+ if data is None:
184
+ return None
185
+
186
+ return datetime.fromisoformat(data)
187
+
188
+
189
+ async def monitor_logs_async(
190
+ self,
191
+ name: str,
192
+ callback_function: Callable[[Any], Any],
193
+ input_callback_function: Callable[[], str],
194
+ accept_input: bool = True,
195
+ debug: bool = False,
196
+ ):
197
+ """
198
+ Monitor a job's log files and await a callback with the changes.
199
+ """
200
+ websockets, websockets_exceptions = mrsm.attempt_import('websockets', 'websockets.exceptions')
201
+ protocol = 'ws' if self.URI.startswith('http://') else 'wss'
202
+ port = self.port if 'port' in self.__dict__ else ''
203
+ uri = f"{protocol}://{self.host}:{port}{LOGS_ENDPOINT}/{name}/ws"
204
+
205
+ async with websockets.connect(uri) as websocket:
206
+ try:
207
+ await websocket.send(self.token or 'no-login')
208
+ except websockets_exceptions.ConnectionClosedOK:
209
+ pass
210
+
211
+ while True:
212
+ try:
213
+ response = await websocket.recv()
214
+ if response == JOBS_STDIN_MESSAGE:
215
+ if asyncio.iscoroutinefunction(input_callback_function):
216
+ data = await input_callback_function()
217
+ else:
218
+ data = input_callback_function()
219
+
220
+ await websocket.send(data)
221
+ continue
222
+
223
+ if asyncio.iscoroutinefunction(callback_function):
224
+ await callback_function(response)
225
+ else:
226
+ callback_function(response)
227
+ except KeyboardInterrupt:
228
+ await websocket.close()
229
+ break
230
+
231
+ def monitor_logs(
232
+ self,
233
+ name: str,
234
+ callback_function: Callable[[Any], Any],
235
+ input_callback_function: Callable[[None], str],
236
+ accept_input: bool = True,
237
+ debug: bool = False,
238
+ ):
239
+ """
240
+ Monitor a job's log files and execute a callback with the changes.
241
+ """
242
+ return asyncio.run(
243
+ self.monitor_logs_async(
244
+ name,
245
+ callback_function,
246
+ input_callback_function=input_callback_function,
247
+ accept_input=accept_input,
248
+ debug=debug
249
+ )
250
+ )
251
+
252
+ def get_job_is_blocking_on_stdin(self, name: str, debug: bool = False) -> bool:
253
+ """
254
+ Return whether a remote job is blocking on stdin.
255
+ """
256
+ response = self.get(JOBS_ENDPOINT + f'/{name}/is_blocking_on_stdin', debug=debug)
257
+ if not response:
258
+ return False
259
+
260
+ return response.json()
@@ -10,11 +10,11 @@ from __future__ import annotations
10
10
  from meerschaum.utils.typing import Mapping, Any, SuccessTuple, Union, Optional, Dict, Tuple
11
11
 
12
12
  def parse_connector_keys(
13
- keys: str,
14
- construct: bool = True,
15
- as_tuple: bool = False,
16
- **kw: Any
17
- ) -> (
13
+ keys: str,
14
+ construct: bool = True,
15
+ as_tuple: bool = False,
16
+ **kw: Any
17
+ ) -> (
18
18
  Union[
19
19
  meerschaum.connectors.Connector,
20
20
  Dict[str, Any],
@@ -119,9 +119,25 @@ def parse_repo_keys(keys: Optional[str] = None, **kw):
119
119
  return parse_connector_keys(keys, **kw)
120
120
 
121
121
 
122
+ def parse_executor_keys(keys: Optional[str] = None, **kw):
123
+ """Parse the executor keys into an APIConnector or None."""
124
+ from meerschaum.config import get_config
125
+ if keys is None:
126
+ keys = get_config('meerschaum', 'default_executor')
127
+
128
+ if keys is None or keys == 'local':
129
+ return 'local'
130
+
131
+ keys = str(keys)
132
+ if ':' not in keys:
133
+ keys = 'api:' + keys
134
+
135
+ return parse_connector_keys(keys, **kw)
136
+
137
+
122
138
  def is_valid_connector_keys(
123
- keys: str
124
- ) -> bool:
139
+ keys: str
140
+ ) -> bool:
125
141
  """Verify a connector_keys string references a valid connector.
126
142
  """
127
143
  try:
@@ -8,6 +8,7 @@ Expose plugin management APIs from the `meerschaum.plugins` module.
8
8
 
9
9
  from __future__ import annotations
10
10
  import functools
11
+ import meerschaum as mrsm
11
12
  from meerschaum.utils.typing import Callable, Any, Union, Optional, Dict, List, Tuple
12
13
  from meerschaum.utils.threading import Lock, RLock
13
14
  from meerschaum.plugins._Plugin import Plugin
@@ -429,11 +430,11 @@ def sync_plugins_symlinks(debug: bool = False, warn: bool = True) -> None:
429
430
 
430
431
 
431
432
  def import_plugins(
432
- *plugins_to_import: Union[str, List[str], None],
433
- warn: bool = True,
434
- ) -> Union[
435
- 'ModuleType', Tuple['ModuleType', None]
436
- ]:
433
+ *plugins_to_import: Union[str, List[str], None],
434
+ warn: bool = True,
435
+ ) -> Union[
436
+ 'ModuleType', Tuple['ModuleType', None]
437
+ ]:
437
438
  """
438
439
  Import the Meerschaum plugins directory.
439
440
 
@@ -524,6 +525,89 @@ def import_plugins(
524
525
  return imported_plugins
525
526
 
526
527
 
528
+ def from_plugin_import(plugin_import_name: str, *attrs: str) -> Any:
529
+ """
530
+ Emulate the `from module import x` behavior.
531
+
532
+ Parameters
533
+ ----------
534
+ plugin_import_name: str
535
+ The import name of the plugin's module.
536
+ Separate submodules with '.' (e.g. 'compose.utils.pipes')
537
+
538
+ attrs: str
539
+ Names of the attributes to return.
540
+
541
+ Returns
542
+ -------
543
+ Objects from a plugin's submodule.
544
+ If multiple objects are provided, return a tuple.
545
+
546
+ Examples
547
+ --------
548
+ >>> init = from_plugin_import('compose.utils', 'init')
549
+ >>> with mrsm.Venv('compose'):
550
+ ... cf = init()
551
+ >>> build_parent_pipe, get_defined_pipes = from_plugin_import(
552
+ ... 'compose.utils.pipes',
553
+ ... 'build_parent_pipe',
554
+ ... 'get_defined_pipes',
555
+ ... )
556
+ >>> parent_pipe = build_parent_pipe(cf)
557
+ >>> defined_pipes = get_defined_pipes(cf)
558
+ """
559
+ import importlib
560
+ from meerschaum.config._paths import PLUGINS_RESOURCES_PATH
561
+ from meerschaum.utils.warnings import warn as _warn
562
+ if plugin_import_name.startswith('plugins.'):
563
+ plugin_import_name = plugin_import_name[len('plugins.'):]
564
+ plugin_import_parts = plugin_import_name.split('.')
565
+ plugin_root_name = plugin_import_parts[0]
566
+ plugin = mrsm.Plugin(plugin_root_name)
567
+
568
+ submodule_import_name = '.'.join(
569
+ [PLUGINS_RESOURCES_PATH.stem]
570
+ + plugin_import_parts
571
+ )
572
+ if len(attrs) == 0:
573
+ raise ValueError(f"Provide which attributes to return from '{submodule_import_name}'.")
574
+
575
+ attrs_to_return = []
576
+ with mrsm.Venv(plugin):
577
+ if plugin.module is None:
578
+ return None
579
+
580
+ try:
581
+ submodule = importlib.import_module(submodule_import_name)
582
+ except ImportError as e:
583
+ _warn(
584
+ f"Failed to import plugin '{submodule_import_name}':\n "
585
+ + f"{e}\n\nHere's a stacktrace:",
586
+ stack=False,
587
+ )
588
+ from meerschaum.utils.formatting import get_console
589
+ get_console().print_exception(
590
+ suppress=[
591
+ 'meerschaum/plugins/__init__.py',
592
+ importlib,
593
+ importlib._bootstrap,
594
+ ]
595
+ )
596
+ return None
597
+
598
+ for attr in attrs:
599
+ try:
600
+ attrs_to_return.append(getattr(submodule, attr))
601
+ except Exception:
602
+ _warn(f"Failed to access '{attr}' from '{submodule_import_name}'.")
603
+ attrs_to_return.append(None)
604
+
605
+ if len(attrs) == 1:
606
+ return attrs_to_return[0]
607
+
608
+ return tuple(attrs_to_return)
609
+
610
+
527
611
  def load_plugins(debug: bool = False, shell: bool = False) -> None:
528
612
  """
529
613
  Import Meerschaum plugins and update the actions dictionary.