meerschaum 2.2.0.dev1__tar.gz → 2.2.0.dev2__tar.gz

{meerschaum-2.2.0.dev1/meerschaum.egg-info → meerschaum-2.2.0.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: meerschaum
-Version: 2.2.0.dev1
+Version: 2.2.0.dev2
 Summary: Sync Time-Series Pipes with Meerschaum
 Home-page: https://meerschaum.io
 Author: Bennett Meares
@@ -64,7 +64,7 @@ Requires-Dist: psutil>=5.8.0; extra == "required"
 Requires-Dist: watchgod>=0.7.0; extra == "required"
 Requires-Dist: dill>=0.3.3; extra == "required"
 Requires-Dist: virtualenv>=20.1.0; extra == "required"
-Requires-Dist: rocketry>=2.5.1; extra == "required"
+Requires-Dist: apscheduler>=4.0.0a4; extra == "required"
 Provides-Extra: drivers
 Requires-Dist: cryptography>=38.0.1; extra == "drivers"
 Requires-Dist: psycopg[binary]>=3.1.18; extra == "drivers"
@@ -83,10 +83,10 @@ Requires-Dist: litecli>=1.5.0; extra == "cli"
 Requires-Dist: mssql-cli>=1.0.0; extra == "cli"
 Requires-Dist: gadwall>=0.2.0; extra == "cli"
 Provides-Extra: stack
-Requires-Dist: docker-compose>=1.27.4; extra == "stack"
+Requires-Dist: docker-compose>=1.29.2; extra == "stack"
 Provides-Extra: build
-Requires-Dist: cx_Freeze>=6.5.1; extra == "build"
-Requires-Dist: pyinstaller>=5.0.0-dev0; extra == "build"
+Requires-Dist: cx_Freeze>=7.0.0; extra == "build"
+Requires-Dist: pyinstaller>6.6.0; extra == "build"
 Provides-Extra: dev-tools
 Requires-Dist: twine>=3.2.0; extra == "dev-tools"
 Requires-Dist: tuna>=0.5.3; extra == "dev-tools"
@@ -155,7 +155,7 @@ Requires-Dist: psutil>=5.8.0; extra == "sql"
 Requires-Dist: watchgod>=0.7.0; extra == "sql"
 Requires-Dist: dill>=0.3.3; extra == "sql"
 Requires-Dist: virtualenv>=20.1.0; extra == "sql"
-Requires-Dist: rocketry>=2.5.1; extra == "sql"
+Requires-Dist: apscheduler>=4.0.0a4; extra == "sql"
 Provides-Extra: dash
 Requires-Dist: Flask-Compress>=1.10.1; extra == "dash"
 Requires-Dist: dash>=2.6.2; extra == "dash"
@@ -174,7 +174,6 @@ Requires-Dist: fastapi>=0.100.0; extra == "api"
 Requires-Dist: passlib>=1.7.4; extra == "api"
 Requires-Dist: fastapi-login>=1.7.2; extra == "api"
 Requires-Dist: python-multipart>=0.0.5; extra == "api"
-Requires-Dist: pydantic<2.0.0; extra == "api"
 Requires-Dist: httpx>=0.24.1; extra == "api"
 Requires-Dist: numpy>=1.18.5; extra == "api"
 Requires-Dist: pandas[parquet]>=2.0.1; extra == "api"
@@ -214,7 +213,7 @@ Requires-Dist: psutil>=5.8.0; extra == "api"
 Requires-Dist: watchgod>=0.7.0; extra == "api"
 Requires-Dist: dill>=0.3.3; extra == "api"
 Requires-Dist: virtualenv>=20.1.0; extra == "api"
-Requires-Dist: rocketry>=2.5.1; extra == "api"
+Requires-Dist: apscheduler>=4.0.0a4; extra == "api"
 Requires-Dist: pprintpp>=0.4.0; extra == "api"
 Requires-Dist: asciitree>=0.3.3; extra == "api"
 Requires-Dist: typing-extensions>=4.7.1; extra == "api"
@@ -261,7 +260,7 @@ Requires-Dist: psutil>=5.8.0; extra == "full"
 Requires-Dist: watchgod>=0.7.0; extra == "full"
 Requires-Dist: dill>=0.3.3; extra == "full"
 Requires-Dist: virtualenv>=20.1.0; extra == "full"
-Requires-Dist: rocketry>=2.5.1; extra == "full"
+Requires-Dist: apscheduler>=4.0.0a4; extra == "full"
 Requires-Dist: cryptography>=38.0.1; extra == "full"
 Requires-Dist: psycopg[binary]>=3.1.18; extra == "full"
 Requires-Dist: PyMySQL>=0.9.0; extra == "full"
@@ -298,7 +297,6 @@ Requires-Dist: fastapi>=0.100.0; extra == "full"
 Requires-Dist: passlib>=1.7.4; extra == "full"
 Requires-Dist: fastapi-login>=1.7.2; extra == "full"
 Requires-Dist: python-multipart>=0.0.5; extra == "full"
-Requires-Dist: pydantic<2.0.0; extra == "full"
 Requires-Dist: httpx>=0.24.1; extra == "full"
 
 <img src="https://meerschaum.io/assets/banner_1920x320.png" alt="Meerschaum banner" style="width: 100%"/>

{meerschaum-2.2.0.dev1 → meerschaum-2.2.0.dev2}/meerschaum/api/dash/callbacks/dashboard.py

@@ -516,9 +516,9 @@ def update_keys_options(
     if location_keys:
         num_filter += 1
 
-    _ck_alone, _mk_alone, _lk_alone = False, False, False
-    _ck_filter, _mk_filter, _lk_filter = connector_keys, metric_keys, location_keys
-
+    _ck_filter = connector_keys
+    _mk_filter = metric_keys
+    _lk_filter = location_keys
     _ck_alone = (connector_keys and num_filter == 1) or instance_click
     _mk_alone = (metric_keys and num_filter == 1) or instance_click
     _lk_alone = (location_keys and num_filter == 1) or instance_click
@@ -528,8 +528,11 @@ def update_keys_options(
     try:
         _all_keys = fetch_pipes_keys('registered', get_web_connector(ctx.states))
         _keys = fetch_pipes_keys(
-            'registered', get_web_connector(ctx.states),
-            connector_keys=_ck_filter, metric_keys=_mk_filter, location_keys=_lk_filter
+            'registered',
+            get_web_connector(ctx.states),
+            connector_keys = _ck_filter,
+            metric_keys = _mk_filter,
+            location_keys = _lk_filter,
         )
     except Exception as e:
         instance_alerts += [alert_from_success_tuple((False, str(e)))]
@@ -551,30 +554,33 @@ def update_keys_options(
     add_options(_connectors_options, _all_keys if _ck_alone else _keys, 'ck')
     add_options(_metrics_options, _all_keys if _mk_alone else _keys, 'mk')
     add_options(_locations_options, _all_keys if _lk_alone else _keys, 'lk')
-    connector_keys = sorted([
+    _connectors_options.sort(key=lambda x: str(x).lower())
+    _metrics_options.sort(key=lambda x: str(x).lower())
+    _locations_options.sort(key=lambda x: str(x).lower())
+    connector_keys = [
         ck
-        for ck in connector_keys 
+        for ck in connector_keys
         if ck in [
             _ck['value']
             for _ck in _connectors_options
         ]
-    ])
-    metric_keys = sorted([
+    ]
+    metric_keys = [
         mk
         for mk in metric_keys
         if mk in [
             _mk['value']
             for _mk in _metrics_options
         ]
-    ])
-    location_keys = sorted([
+    ]
+    location_keys = [
         lk
         for lk in location_keys
         if lk in [
             _lk['value']
             for _lk in _locations_options
         ]
-    ])
+    ]
     _connectors_datalist = [html.Option(value=o['value']) for o in _connectors_options]
     _metrics_datalist = [html.Option(value=o['value']) for o in _metrics_options]
     _locations_datalist = [html.Option(value=o['value']) for o in _locations_options]

{meerschaum-2.2.0.dev1 → meerschaum-2.2.0.dev2}/meerschaum/api/dash/pipes.py

@@ -124,11 +124,11 @@ def get_pipes_cards(*keys, session_data: Optional[Dict[str, Any]] = None):
                             label = "Manage",
                             children = [
                                 dbc.DropdownMenuItem(
-                                    'Sync',
+                                    'Delete',
                                     id = {
                                         'type': 'manage-pipe-button',
                                         'index': meta_str,
-                                        'action': 'sync',
+                                        'action': 'delete',
                                     },
                                 ),
                                 dbc.DropdownMenuItem(
@@ -140,15 +140,31 @@ def get_pipes_cards(*keys, session_data: Optional[Dict[str, Any]] = None):
                                     },
                                 ),
                                 dbc.DropdownMenuItem(
-                                    'Delete',
+                                    'Clear',
                                     id = {
                                         'type': 'manage-pipe-button',
                                         'index': meta_str,
-                                        'action': 'delete',
+                                        'action': 'clear',
+                                    },
+                                ),
+                                dbc.DropdownMenuItem(
+                                    'Verify',
+                                    id = {
+                                        'type': 'manage-pipe-button',
+                                        'index': meta_str,
+                                        'action': 'verify',
+                                    },
+                                ),
+                                dbc.DropdownMenuItem(
+                                    'Sync',
+                                    id = {
+                                        'type': 'manage-pipe-button',
+                                        'index': meta_str,
+                                        'action': 'sync',
                                     },
                                 ),
                             ],
-                            direction = "end",
+                            direction = "up",
                             menu_variant = "dark",
                             size = 'sm',
                             color = 'secondary',
@@ -156,21 +172,10 @@ def get_pipes_cards(*keys, session_data: Optional[Dict[str, Any]] = None):
                     ) if authenticated else [],
                     width = 2,
                 ),
-                #  dbc.Col(
-                    #  (
-                        #  dbc.Button(
-                            #  'Sync',
-                            #  size = 'sm',
-                            #  style = {'width': '100%'},
-                            #  id = {'type': 'pipe-sync-button', 'index': meta_str},
-                        #  ) if authenticated else []
-                    #  ),
-                    #  width = 2,
-                #  ),
                 dbc.Col(width=6),
                 dbc.Col(
                     dbc.Button(
-                        'Download recent data',
+                        'Download CSV',
                         size = 'sm',
                         color = 'link',
                         style = {'float': 'right'},
@@ -244,14 +249,28 @@ def accordion_items_from_pipe(
         overview_header = [html.Thead(html.Tr([html.Th("Attribute"), html.Th("Value")]))]
         dt_name, id_name, val_name = pipe.get_columns('datetime', 'id', 'value', error=False)
         overview_rows = [
-            html.Tr([html.Td("Connector"), html.Td(f"{pipe.connector_keys}")]),
-            html.Tr([html.Td("Metric"), html.Td(f"{pipe.metric_key}")]),
-            html.Tr([html.Td("Location"), html.Td(f"{pipe.location_key}")]),
-            html.Tr([html.Td("Instance"), html.Td(f"{pipe.instance_keys}")]),
-            html.Tr([html.Td("Target Table"), html.Td(f"{pipe.target}")]),
+            html.Tr([html.Td("Connector"), html.Td(html.Pre(f"{pipe.connector_keys}"))]),
+            html.Tr([html.Td("Metric"), html.Td(html.Pre(f"{pipe.metric_key}"))]),
+            html.Tr([html.Td("Location"), html.Td(html.Pre(f"{pipe.location_key}"))]),
+            html.Tr([html.Td("Instance"), html.Td(html.Pre(f"{pipe.instance_keys}"))]),
+            html.Tr([html.Td("Target Table"), html.Td(html.Pre(f"{pipe.target}"))]),
         ]
-        for col_key, col in pipe.columns.items():
-            overview_rows.append(html.Tr([html.Td(f"'{col_key}' Index"), html.Td(col)]))
+        columns = pipe.columns.copy()
+        if columns:
+            datetime_index = columns.pop('datetime', None)
+            columns_items = []
+            if datetime_index:
+                columns_items.append(html.Li(f"{datetime_index} (datetime)"))
+            columns_items.extend([
+                html.Li(f"{col}")
+                for col_key, col in columns.items()
+            ])
+            overview_rows.append(
+                html.Tr([
+                    html.Td("Indices" if len(columns_items) != 1 else "Index"),
+                    html.Td(html.Pre(html.Ul(columns_items))),
+                ])
+            )
         tags = pipe.tags
         if tags:
             tags_items = html.Ul([
@@ -261,7 +280,7 @@ def accordion_items_from_pipe(
             overview_rows.append(
                 html.Tr([
                     html.Td("Tags"),
-                    html.Td(tags_items),
+                    html.Td(html.Pre(tags_items)),
                 ])
             )
 

{meerschaum-2.2.0.dev1 → meerschaum-2.2.0.dev2}/meerschaum/config/_version.py

@@ -2,4 +2,4 @@
 Specify the Meerschaum release version.
 """
 
-__version__ = "2.2.0.dev1"
+__version__ = "2.2.0.dev2"

{meerschaum-2.2.0.dev1 → meerschaum-2.2.0.dev2}/meerschaum/config/stack/__init__.py

@@ -97,7 +97,6 @@ compose_header = """
 
 
 default_docker_compose_config = {
-    'version': '3.9',
     'services': {
         'db': {
             'environment': {

{meerschaum-2.2.0.dev1 → meerschaum-2.2.0.dev2}/meerschaum/utils/packages/__init__.py

@@ -8,7 +8,7 @@ Functions for managing packages and virtual environments reside here.
 
 from __future__ import annotations
 
-import importlib.util, os, pathlib
+import importlib.util, os, pathlib, re
 from meerschaum.utils.typing import Any, List, SuccessTuple, Optional, Union, Tuple, Dict, Iterable
 from meerschaum.utils.threading import Lock, RLock
 from meerschaum.utils.packages._packages import packages, all_packages, get_install_names
@@ -640,6 +640,9 @@ def need_update(
 
     ### We might be depending on a prerelease.
     ### Sanity check that the required version is not greater than the installed version. 
+    if 'a' in required_version:
+        required_version = required_version.replace('a', '-dev')
+        version = version.replace('a', '-dev')
     try:
         return (
             (not semver.Version.parse(version).match(required_version))

{meerschaum-2.2.0.dev1 → meerschaum-2.2.0.dev2}/meerschaum/utils/packages/_packages.py

@@ -52,7 +52,7 @@ packages: Dict[str, Dict[str, str]] = {
         'watchgod'                   : 'watchgod>=0.7.0',
         'dill'                       : 'dill>=0.3.3',
         'virtualenv'                 : 'virtualenv>=20.1.0',
-        'rocketry'                   : 'rocketry>=2.5.1',
+        'apscheduler'                : 'apscheduler>=4.0.0a4',
     },
     'drivers': {
         'cryptography'               : 'cryptography>=38.0.1',
@@ -75,11 +75,11 @@ packages: Dict[str, Dict[str, str]] = {
         'gadwall'                    : 'gadwall>=0.2.0',
     },
     'stack': {
-        'compose'                    : 'docker-compose>=1.27.4',
+        'compose'                    : 'docker-compose>=1.29.2',
     },
     'build': {
-        'cx_Freeze'                  : 'cx_Freeze>=6.5.1',
-        'PyInstaller'                : 'pyinstaller>=5.0.0-dev0',
+        'cx_Freeze'                  : 'cx_Freeze>=7.0.0',
+        'PyInstaller'                : 'pyinstaller>6.6.0',
     },
     'dev-tools': {
         'twine'                      : 'twine>=3.2.0',
@@ -149,7 +149,7 @@ packages['api'] = {
     'passlib'                        : 'passlib>=1.7.4',
     'fastapi_login'                  : 'fastapi-login>=1.7.2',
     'multipart'                      : 'python-multipart>=0.0.5',
-    'pydantic'                       : 'pydantic<2.0.0',
+    #  'pydantic'                       : 'pydantic>2.0.0',
     'httpx'                          : 'httpx>=0.24.1',
     'websockets'                     : 'websockets>=11.0.3',
 }

meerschaum-2.2.0.dev2/meerschaum/utils/schedule.py

@@ -0,0 +1,304 @@
+#! /usr/bin/env python3
+# -*- coding: utf-8 -*-
+# vim:fenc=utf-8
+
+"""
+Schedule processes and threads.
+"""
+
+from __future__ import annotations
+import sys
+from datetime import datetime, timezone, timedelta, timedelta
+import meerschaum as mrsm
+from meerschaum.utils.typing import Callable, Any, Optional, List, Dict
+
+INTERVAL_UNITS: List[str] = ['months', 'weeks', 'days', 'hours', 'minutes', 'seconds']
+FREQUENCY_ALIASES: Dict[str, str] = {
+    'daily': 'every 1 day',
+    'hourly': 'every 1 hour',
+    'minutely': 'every 1 minute',
+    'weekly': 'every 1 week',
+    'monthly': 'every 1 month',
+    'secondly': 'every 1 second',
+}
+LOGIC_ALIASES: Dict[str, str] = {
+    'and': '&',
+    'or': '|',
+    ' through ': '-',
+    ' thru ': '-',
+    ' - ': '-',
+    'beginning': 'starting',
+}
+CRON_DAYS_OF_WEEK: List[str] = ['mon', 'tue', 'wed', 'thu', 'fri', 'sat', 'sun']
+CRON_DAYS_OF_WEEK_ALIASES: Dict[str, str] = {
+    'monday': 'mon',
+    'tuesday': 'tue',
+    'tues': 'tue',
+    'wednesday': 'wed',
+    'thursday': 'thu',
+    'thurs': 'thu',
+    'friday': 'fri',
+    'saturday': 'sat',
+    'sunday': 'sun',
+}
+CRON_MONTHS: List[str] = [
+    'jan', 'feb', 'mar', 'apr', 'may', 'jun',
+    'jul', 'aug', 'sep', 'oct', 'nov', 'dec',
+]
+CRON_MONTHS_ALIASES: Dict[str, str] = {
+    'january': 'jan',
+    'february': 'feb',
+    'march': 'mar',
+    'april': 'apr',
+    'may': 'may',
+    'june': 'jun',
+    'july': 'jul',
+    'august': 'aug',
+    'september': 'sep',
+    'october': 'oct',
+    'november': 'nov',
+    'december': 'dec',
+}
+SCHEDULE_ALIASES: Dict[str, str] = {
+    **FREQUENCY_ALIASES,
+    **LOGIC_ALIASES,
+    **CRON_DAYS_OF_WEEK_ALIASES,
+    **CRON_MONTHS_ALIASES,
+}
+STARTING_KEYWORD: str = 'starting'
+
+def schedule_function(
+        function: Callable[[Any], Any],
+        schedule: str,
+        *args,
+        debug: bool = False,
+        **kw
+    ) -> None:
+    """
+    Block the process and execute the function intermittently according to the frequency.
+    https://rocketry.readthedocs.io/en/stable/condition_syntax/index.html
+
+    Parameters
+    ----------
+    function: Callable[[Any], Any]
+        The function to execute.
+
+    schedule: str
+        The frequency schedule at which `function` should be executed (e.g. `'daily'`).
+
+    """
+    import warnings
+    from meerschaum.utils.warnings import warn
+    from meerschaum.utils.misc import filter_keywords, round_time
+    kw['debug'] = debug
+    kw = filter_keywords(function, **kw)
+
+    apscheduler = mrsm.attempt_import('apscheduler', lazy=False)
+    now = round_time(datetime.now(timezone.utc), timedelta(minutes=1))
+    trigger = parse_schedule(schedule, now=now)
+
+    with apscheduler.Scheduler() as scheduler:
+        job = scheduler.add_schedule(function, trigger, args=args, kwargs=kw)
+        try:
+            scheduler.run_until_stopped()
+        except KeyboardInterrupt as e:
+            scheduler.stop()
+            scheduler.wait_until_stopped()
+
+
+def parse_schedule(schedule: str, now: Optional[datetime] = None):
+    """
+    Parse a schedule string (e.g. 'daily') into a Trigger object.
+    """
+    from meerschaum.utils.warnings import error
+    from meerschaum.utils.misc import items_str, is_int
+    (
+        apscheduler_triggers_cron,
+        apscheduler_triggers_interval,
+        apscheduler_triggers_calendarinterval,
+        apscheduler_triggers_combining,
+    ) = (
+        mrsm.attempt_import(
+            'apscheduler.triggers.cron',
+            'apscheduler.triggers.interval',
+            'apscheduler.triggers.calendarinterval',
+            'apscheduler.triggers.combining',
+            lazy = False,
+        )
+    )
+
+    starting_ts = parse_start_time(schedule, now=now)
+    schedule = schedule.split(STARTING_KEYWORD)[0].strip()
+    for alias_keyword, true_keyword in SCHEDULE_ALIASES.items():
+        schedule = schedule.replace(alias_keyword, true_keyword)
+
+    ### TODO Allow for combining `and` + `or` logic.
+    if '&' in schedule and '|' in schedule:
+        error(f"Cannot accept both 'and' + 'or' logic in the schedule frequency.", ValueError)
+
+    join_str = '|' if '|' in schedule else '&'
+    join_trigger = (
+        apscheduler_triggers_combining.OrTrigger
+        if join_str == '|'
+        else apscheduler_triggers_combining.AndTrigger
+    )
+    join_kwargs = {
+        'max_iterations': 1_000_000,
+        'threshold': 0,
+    } if join_str == '&' else {}
+
+    schedule_parts = [part.strip() for part in schedule.split(join_str)]
+    triggers = []
+
+    has_seconds = 'second' in schedule
+    has_minutes = 'minute' in schedule
+    has_days = 'day' in schedule
+    has_weeks = 'week' in schedule
+    has_hours = 'hour' in schedule
+    num_hourly_intervals = schedule.count('hour')
+    divided_days = False
+    divided_hours = False
+
+    for schedule_part in schedule_parts:
+
+        ### Intervals must begin with 'every' (after alias substitution).
+        if schedule_part.lower().startswith('every '):
+            schedule_num_str, schedule_unit = (
+                schedule_part[len('every '):].split(' ', maxsplit=1)
+            )
+            schedule_unit = schedule_unit.rstrip('s') + 's'
+            if schedule_unit not in INTERVAL_UNITS:
+                error(
+                    f"Invalid interval '{schedule_unit}'.\n"
+                    + f"    Accepted values are {items_str(INTERVAL_UNITS)}.",
+                    ValueError,
+                )
+
+            schedule_num = (
+                int(schedule_num_str)
+                if is_int(schedule_num_str)
+                else float(schedule_num_str)
+            )
+
+            ### NOTE: When combining days or weeks with other schedules,
+            ### we must divide one of the day-schedules by 2.
+            ### TODO Remove this when APScheduler is patched.
+            if (
+                join_str == '&'
+                and (has_days or has_weeks)
+                and len(schedule_parts) > 1
+                and not divided_days
+            ):
+                schedule_num /= 2
+                divided_days = True
+
+            ### NOTE: When combining multiple hourly intervals,
+            ### one must be divided by 2.
+            if (
+                join_str == '&'
+                #  and num_hourly_intervals > 1
+                and len(schedule_parts) > 1
+                and not divided_hours
+            ):
+                print("divided hours")
+                schedule_num /= 2
+                #  divided_hours = True
+
+            trigger = (
+                apscheduler_triggers_interval.IntervalTrigger(
+                    **{
+                        schedule_unit: schedule_num,
+                        'start_time': starting_ts,
+                    }
+                )
+                if schedule_unit != 'months' else (
+                    apscheduler_triggers_calendarinterval.CalendarIntervalTrigger(
+                        **{
+                            schedule_unit: schedule_num,
+                            'start_date': starting_ts,
+                            #  'timezone': starting_ts.tzinfo, TODO Re-enable once APScheduler updates.
+                        }
+                    )
+                )
+            )
+
+        ### Determine whether this is a pure cron string or a cron subset (e.g. 'may-aug')_.
+        else:
+            first_three_prefix = schedule_part[:3] 
+            cron_kw = {}
+            if first_three_prefix in CRON_DAYS_OF_WEEK:
+                cron_kw['day_of_week'] = schedule_part
+            elif first_three_prefix in CRON_MONTHS:
+                cron_kw['month'] = schedule_part
+            trigger = (
+                apscheduler_triggers_cron.CronTrigger(
+                    **{
+                        **cron_kw,
+                        'hour': '*',
+                        'minute': '*' if has_minutes else starting_ts.minute,
+                        'second': '*' if has_seconds else starting_ts.second,
+                        'start_time': starting_ts,
+                        'timezone': starting_ts.tzinfo,
+                    }
+                )
+                if cron_kw
+                else apscheduler_triggers_cron.CronTrigger.from_crontab(
+                    schedule_part, 
+                    timezone = starting_ts.tzinfo,
+                )
+            )
+            ### Explicitly set the `start_time` after building with `from_crontab`.
+            if trigger.start_time != starting_ts:
+                trigger.start_time = starting_ts
+
+        triggers.append(trigger)
+
+    return (
+        join_trigger(triggers, **join_kwargs)
+        if len(triggers) != 1
+        else triggers[0]
+    )
+
+
+def parse_start_time(schedule: str, now: Optional[datetime] = None) -> datetime:
+    """
+    Return the datetime to use for the given schedule string.
+
+    Parameters
+    ----------
+    schedule: str
+        The schedule frequency to be parsed into a starting datetime.
+
+    now: Optional[datetime], default None
+        If provided, use this value as a default if no start time is explicitly stated.
+
+    Returns
+    -------
+    A `datetime` object, either `now` or the datetime embedded in the schedule string.
+
+    Examples
+    --------
+    >>> parse_start_time('daily starting 2024-01-01')
+    datetime.datetime(2024, 1, 1, 0, 0, tzinfo=datetime.timezone.utc)
+    >>> parse_start_time('monthly starting 1st')
+    datetime.datetime(2024, 5, 1, 0, 0, tzinfo=datetime.timezone.utc)
+    >>> parse_start_time('hourly starting 00:30')
+    datetime.datetime(2024, 5, 13, 0, 30, tzinfo=datetime.timezone.utc)
+    """
+    from meerschaum.utils.misc import round_time
+    from meerschaum.utils.warnings import error, warn
+    dateutil_parser = mrsm.attempt_import('dateutil.parser')
+    starting_parts = schedule.split(STARTING_KEYWORD)
+    starting_str = ('now' if len(starting_parts) == 1 else starting_parts[-1]).strip()
+    now = now or round_time(datetime.now(timezone.utc), timedelta(minutes=1))
+    try:
+        starting_ts = now if starting_str == 'now' else dateutil_parser.parse(starting_str)
+        schedule_parse_error = None
+    except Exception as e:
+        warn(f"Unable to parse starting time from '{starting_str}'.", stack=False)
+        schedule_parse_error = str(e)
+    if schedule_parse_error:
+        error(schedule_parse_error, ValueError, stack=False)
+    if not starting_ts.tzinfo:
+        starting_ts = starting_ts.replace(tzinfo=timezone.utc)
+    return starting_ts