meerschaum 2.1.4__py3-none-any.whl → 2.1.6__py3-none-any.whl

meerschaum/utils/{get_pipes.py → _get_pipes.py}

@@ -8,6 +8,7 @@ Return a dictionary (or list) of pipe objects. See documentation below for more
 
 from __future__ import annotations
 
+import meerschaum as mrsm
 from meerschaum.utils.typing import (
     Sequence, Optional, Union, Mapping, Any, InstanceConnector, PipesDict, List, Dict, Tuple
 )
@@ -27,7 +28,7 @@ def get_pipes(
         wait: bool = False,
         debug: bool = False,
         **kw: Any
-    ) -> Union[PipesDict, List['meerschaum.Pipe']]:
+    ) -> Union[PipesDict, List[mrsm.Pipe]]:
     """
     Return a dictionary or list of `meerschaum.Pipe` objects.
 
@@ -182,8 +183,8 @@ def get_pipes(
 
         pipes[ck][mk][lk] = Pipe(
             ck, mk, lk,
-            mrsm_instance=connector,
-            debug=debug,
+            mrsm_instance = connector,
+            debug = debug,
             **filter_keywords(Pipe, **kw)
         )
 
@@ -278,6 +279,7 @@ def fetch_pipes_keys(
             metric_keys: Optional[List[str]] = None,
             location_keys: Optional[List[str]] = None,
             params: Optional[Dict[str, Any]] = None,
+            tags: Optional[List[str]] = None,
             debug: bool = False,
             **kw
         ) -> List[Tuple[str, str, str]]:
@@ -321,22 +323,9 @@ def fetch_pipes_keys(
                     result.append((ck, mk, lk))
         return result
 
-    def _all(**kw):
-        """
-        Fetch all available metrics and locations and create every combination.
-        Connector keys are required.
-        **NOTE**: Not implemented!
-        """
-        error(
-            "Need to implement metrics and locations logic in SQL and API.",
-            NotImplementedError
-        )
-
     _method_functions = {
         'registered' : _registered,
         'explicit'   : _explicit,
-        'all'        : _all,
-        ### TODO implement 'all'
     }
     if method not in _method_functions:
         error(f"Method '{method}' is not supported!", NotImplementedError)

meerschaum/utils/daemon/Daemon.py

@@ -15,7 +15,7 @@ import signal
 import sys
 import time
 import traceback
-from datetime import datetime
+from datetime import datetime, timezone
 from meerschaum.utils.typing import Optional, Dict, Any, SuccessTuple, Callable, List, Union
 from meerschaum.config import get_config
 from meerschaum.config._paths import DAEMON_RESOURCES_PATH, LOGS_RESOURCES_PATH
@@ -209,7 +209,9 @@ class Daemon:
         if process_key not in ('began', 'ended', 'paused'):
             raise ValueError(f"Invalid key '{process_key}'.")
 
-        self.properties['process'][process_key] = datetime.utcnow().isoformat()
+        self.properties['process'][process_key] = (
+            datetime.now(timezone.utc).replace(tzinfo=None).isoformat()
+        )
         if write_properties:
             self.write_properties()
 

meerschaum/utils/dataframe.py

@@ -9,7 +9,7 @@ Utility functions for working with DataFrames.
 from __future__ import annotations
 from meerschaum.utils.typing import (
     Optional, Dict, Any, List, Hashable, Generator,
-    Iterator, Iterable,
+    Iterator, Iterable, Union,
 )
 
 
@@ -840,8 +840,8 @@ def df_from_literal(
             )
             val = literal
 
-    import datetime
-    now = datetime.datetime.utcnow()
+    from datetime import datetime, timezone
+    now = datetime.now(timezone.utc).replace(tzinfo=None)
 
     pd = import_pandas()
     return pd.DataFrame({dt_name: [now], val_name: [val]})

meerschaum/utils/interactive.py

@@ -13,24 +13,10 @@ def select_pipes(
         force: bool = False,
         debug: bool = False,
     ) -> List[Pipe]:
-    """Prompt the user for the keys to identify a list of pipes.
-
-    Parameters
-    ----------
-    yes: bool :
-         (Default value = False)
-    force: bool :
-         (Default value = False)
-    debug: bool :
-         (Default value = False)
-
-    Returns
-    -------
-
-    """
+    """Prompt the user for the keys to identify a list of pipes."""
     from meerschaum.utils.misc import get_connector_labels
     from meerschaum.utils.prompt import prompt, choose, yes_no
-    from meerschaum.utils.get_pipes import get_pipes
+    from meerschaum.utils import get_pipes
     from meerschaum.utils.formatting._shell import clear_screen
     from meerschaum.utils.formatting import pprint_pipes
     from meerschaum.config import get_config

meerschaum/utils/misc.py

@@ -6,7 +6,7 @@ Miscellaneous functions go here
 """
 
 from __future__ import annotations
-from datetime import timedelta
+from datetime import timedelta, datetime, timezone
 from meerschaum.utils.typing import (
     Union,
     Any,
@@ -386,10 +386,10 @@ def flatten_pipes_dict(pipes_dict: PipesDict) -> List[Pipe]:
 
 
 def round_time(
-        dt: Optional['datetime.datetime'] = None,
-        date_delta: Optional['datetime.timedelta'] = None,
+        dt: Optional[datetime] = None,
+        date_delta: Optional[timedelta] = None,
         to: 'str' = 'down'
-    ) -> 'datetime.datetime':
+    ) -> datetime:
     """
     Round a datetime object to a multiple of a timedelta.
     http://stackoverflow.com/questions/3463930/how-to-round-the-minute-of-a-datetime-object-python
@@ -398,10 +398,10 @@ def round_time(
 
     Parameters
     ----------
-    dt: 'datetime.datetime', default None
+    dt: Optional[datetime], default None
         If `None`, grab the current UTC datetime.
 
-    date_delta: 'datetime.timedelta', default None
+    date_delta: Optional[timedelta], default None
         If `None`, use a delta of 1 minute.
 
     to: 'str', default 'down'
@@ -409,36 +409,35 @@ def round_time(
 
     Returns
     -------
-    A rounded `datetime.datetime` object.
+    A rounded `datetime` object.
 
     Examples
     --------
-    >>> round_time(datetime.datetime(2022, 1, 1, 12, 15, 57, 200))
+    >>> round_time(datetime(2022, 1, 1, 12, 15, 57, 200))
     datetime.datetime(2022, 1, 1, 12, 15)
-    >>> round_time(datetime.datetime(2022, 1, 1, 12, 15, 57, 200), to='up')
+    >>> round_time(datetime(2022, 1, 1, 12, 15, 57, 200), to='up')
     datetime.datetime(2022, 1, 1, 12, 16)
-    >>> round_time(datetime.datetime(2022, 1, 1, 12, 15, 57, 200), datetime.timedelta(hours=1))
+    >>> round_time(datetime(2022, 1, 1, 12, 15, 57, 200), timedelta(hours=1))
     datetime.datetime(2022, 1, 1, 12, 0)
     >>> round_time(
-    ...   datetime.datetime(2022, 1, 1, 12, 15, 57, 200),
-    ...   datetime.timedelta(hours=1),
-    ...   to='closest'
+    ...   datetime(2022, 1, 1, 12, 15, 57, 200),
+    ...   timedelta(hours=1),
+    ...   to = 'closest'
     ... )
     datetime.datetime(2022, 1, 1, 12, 0)
     >>> round_time(
-    ...   datetime.datetime(2022, 1, 1, 12, 45, 57, 200),
+    ...   datetime(2022, 1, 1, 12, 45, 57, 200),
     ...   datetime.timedelta(hours=1),
-    ...   to='closest'
+    ...   to = 'closest'
     ... )
     datetime.datetime(2022, 1, 1, 13, 0)
 
     """
-    import datetime
     if date_delta is None:
-        date_delta = datetime.timedelta(minutes=1)
+        date_delta = timedelta(minutes=1)
     round_to = date_delta.total_seconds()
     if dt is None:
-        dt = datetime.datetime.utcnow()
+        dt = datetime.now(timezone.utc).replace(tzinfo=None)
     seconds = (dt.replace(tzinfo=None) - dt.min.replace(tzinfo=None)).seconds
 
     if seconds % round_to == 0 and dt.microsecond == 0:
@@ -451,7 +450,7 @@ def round_time(
         else:
             rounding = (seconds + round_to / 2) // round_to * round_to
 
-    return dt + datetime.timedelta(0, rounding - seconds, - dt.microsecond)
+    return dt + timedelta(0, rounding - seconds, - dt.microsecond)
 
 
 def timed_input(
@@ -857,22 +856,22 @@ def get_connector_labels(
     return sorted(possibilities)
 
 
-def json_serialize_datetime(dt: 'datetime.datetime') -> Union[str, None]:
+def json_serialize_datetime(dt: datetime) -> Union[str, None]:
     """
-    Serialize a datetime.datetime object into JSON (ISO format string).
+    Serialize a datetime object into JSON (ISO format string).
     
     Examples
     --------
-    >>> import json, datetime
-    >>> json.dumps({'a': datetime.datetime(2022, 1, 1)}, default=json_serialize_datetime)
+    >>> import json
+    >>> from datetime import datetime
+    >>> json.dumps({'a': datetime(2022, 1, 1)}, default=json_serialize_datetime)
     '{"a": "2022-01-01T00:00:00Z"}'
 
     """
-    import datetime
-
-    if isinstance(dt, datetime.datetime):
-        return dt.isoformat() + 'Z'
-    return None
+    if not isinstance(dt, datetime):
+        return None
+    tz_suffix = 'Z' if dt.tzinfo is None else ''
+    return dt.isoformat() + tz_suffix
 
 
 def wget(

meerschaum/utils/packages/__init__.py

@@ -1544,7 +1544,13 @@ def reload_meerschaum(debug: bool = False) -> SuccessTuple:
     """
     Reload the currently loaded Meercshaum modules, refreshing plugins and shell configuration.
     """
-    reload_package('meerschaum', skip_submodules=['meerschaum._internal.shell'])
+    reload_package(
+        'meerschaum',
+        skip_submodules = [
+            'meerschaum._internal.shell',
+            'meerschaum.utils.pool',
+        ]
+    )
 
     from meerschaum.plugins import reload_plugins
     from meerschaum._internal.shell.Shell import _insert_shell_actions

meerschaum/utils/packages/_packages.py

@@ -89,7 +89,6 @@ packages: Dict[str, Dict[str, str]] = {
         'pytest'                     : 'pytest>=6.2.2',
         'pytest_xdist'               : 'pytest-xdist>=3.2.1',
         'heartrate'                  : 'heartrate>=0.2.1',
-        'pyheat'                     : 'py-heat>=0.0.6',
     },
     'setup': {
     },

meerschaum/utils/pool.py

@@ -11,7 +11,7 @@ from meerschaum.utils.typing import Optional, Callable, List, Any
 from meerschaum.utils.threading import Lock, RLock
 import signal
 
-pools = None
+pools = {}
 _locks = {
     'pools': Lock(),
 }
@@ -28,10 +28,10 @@ def get_pool(
     ):
     """If the requested pool does not exist, instantiate it here.
     Pools are joined and closed on exit."""
-    global pools
-    with _locks['pools']:
-        if pools is None:
-            pools = {}
+    from multiprocessing import cpu_count
+    if workers is None:
+        workers = cpu_count()
+    pool_key = pool_class_name + f'-{workers}'
 
     def build_pool(workers):
         from meerschaum.utils.warnings import warn
@@ -49,9 +49,6 @@ def get_pool(
                 'ThreadPool'
             )
 
-        if workers is None:
-            from multiprocessing import cpu_count
-            workers = cpu_count()
         try:
             pool = Pool(workers, initializer=initializer, initargs=initargs)
         except Exception as e:
@@ -59,23 +56,24 @@ def get_pool(
             pool = None
 
         with _locks['pools']:
-            pools[pool_class_name] = pool       
+            pools[pool_key] = pool
 
-    if pool_class_name not in pools or pools.get(pool_class_name, None) is None:
+    if pools.get(pool_key, None) is None:
         build_pool(workers)
 
     if (
-        pools[pool_class_name] is not None
-        and pools[pool_class_name]._state not in ('RUN', 0)
+        pools[pool_key] is not None
+        and pools[pool_key]._state not in ('RUN', 0)
     ):
         try:
-            pools[pool_class_name].close()
+            pools[pool_key].close()
+            pools[pool_key].terminate()
         except Exception as e:
             pass
-        del pools[pool_class_name]
+        del pools[pool_key]
         build_pool(workers)
 
-    return pools[pool_class_name]
+    return pools[pool_key]
 
 
 def get_pools():
@@ -94,7 +92,6 @@ def get_pool_executor(workers: Optional[int] = None):
         from concurrent.futures import ThreadPoolExecutor
         workers = cpu_count() if workers is None else workers
     except Exception as e:
-        ThreadPoolExecutor = None
+        return None
 
     return ThreadPoolExecutor(max_workers=workers) if ThreadPoolExecutor is not None else None
-

meerschaum/utils/sql.py

@@ -7,6 +7,7 @@ Flavor-specific SQL tools.
 """
 
 from __future__ import annotations
+from datetime import datetime, timezone, timedelta
 import meerschaum as mrsm
 from meerschaum.utils.typing import Optional, Dict, Any, Union, List, Iterable, Tuple
 ### Preserve legacy imports.
@@ -37,6 +38,7 @@ version_queries = {
     'oracle': "SELECT version from PRODUCT_COMPONENT_VERSION WHERE rownum = 1",
 }
 SKIP_IF_EXISTS_FLAVORS = {'mssql', 'oracle'}
+COALESCE_UNIQUE_INDEX_FLAVORS = {'timescaledb', 'postgresql', 'citus'}
 update_queries = {
     'default': """
         UPDATE {target_table_name} AS f
@@ -52,25 +54,25 @@ update_queries = {
         INSERT INTO {target_table_name} ({patch_cols_str})
         SELECT {patch_cols_str}
         FROM {patch_table_name}
-        ON CONFLICT ({join_cols_str}) DO UPDATE {sets_subquery_none_excluded}
+        ON CONFLICT ({join_cols_str}) DO {update_or_nothing} {sets_subquery_none_excluded}
     """,
     'postgresql-upsert': """
         INSERT INTO {target_table_name} ({patch_cols_str})
         SELECT {patch_cols_str}
         FROM {patch_table_name}
-        ON CONFLICT ({join_cols_str}) DO UPDATE {sets_subquery_none_excluded}
+        ON CONFLICT ({join_cols_str}) DO {update_or_nothing} {sets_subquery_none_excluded}
     """,
     'citus-upsert': """
         INSERT INTO {target_table_name} ({patch_cols_str})
         SELECT {patch_cols_str}
         FROM {patch_table_name}
-        ON CONFLICT ({join_cols_str}) DO UPDATE {sets_subquery_none_excluded}
+        ON CONFLICT ({join_cols_str}) DO {update_or_nothing} {sets_subquery_none_excluded}
     """,
     'cockroachdb-upsert': """
         INSERT INTO {target_table_name} ({patch_cols_str})
         SELECT {patch_cols_str}
         FROM {patch_table_name}
-        ON CONFLICT ({join_cols_str}) DO UPDATE {sets_subquery_none_excluded}
+        ON CONFLICT ({join_cols_str}) DO {update_or_nothing} {sets_subquery_none_excluded}
     """,
     'mysql': """
         UPDATE {target_table_name} AS f
@@ -121,7 +123,7 @@ update_queries = {
         SELECT {patch_cols_str}
         FROM {patch_table_name}
         WHERE true
-        ON CONFLICT ({join_cols_str}) DO UPDATE {sets_subquery_none_excluded}
+        ON CONFLICT ({join_cols_str}) DO {update_or_nothing} {sets_subquery_none_excluded}
     """,
     'sqlite_delete_insert': [
         """
@@ -274,7 +276,7 @@ def dateadd_str(
         flavor: str = 'postgresql',
         datepart: str = 'day',
         number: Union[int, float] = 0,
-        begin: Union[str, datetime.datetime, int] = 'now'
+        begin: Union[str, datetime, int] = 'now'
     ) -> str:
     """
     Generate a `DATEADD` clause depending on database flavor.
@@ -310,7 +312,7 @@ def dateadd_str(
     number: Union[int, float], default `0`
         How many units to add to the date part.
 
-    begin: Union[str, datetime.datetime], default `'now'`
+    begin: Union[str, datetime], default `'now'`
         Base datetime to which to add dateparts.
 
     Returns
@@ -321,13 +323,13 @@ def dateadd_str(
     --------
     >>> dateadd_str(
     ...     flavor = 'mssql',
-    ...     begin = datetime.datetime(2022, 1, 1, 0, 0),
+    ...     begin = datetime(2022, 1, 1, 0, 0),
     ...     number = 1,
     ... )
     "DATEADD(day, 1, CAST('2022-01-01 00:00:00' AS DATETIME))"
     >>> dateadd_str(
     ...     flavor = 'postgresql',
-    ...     begin = datetime.datetime(2022, 1, 1, 0, 0),
+    ...     begin = datetime(2022, 1, 1, 0, 0),
     ...     number = 1,
     ... )
     "CAST('2022-01-01 00:00:00' AS TIMESTAMP) + INTERVAL '1 day'"
@@ -336,7 +338,6 @@ def dateadd_str(
     from meerschaum.utils.debug import dprint
     from meerschaum.utils.packages import attempt_import
     from meerschaum.utils.warnings import error
-    import datetime
     dateutil_parser = attempt_import('dateutil.parser')
     if 'int' in str(type(begin)).lower():
         return str(begin)
@@ -346,7 +347,7 @@ def dateadd_str(
     _original_begin = begin
     begin_time = None
     ### Sanity check: make sure `begin` is a valid datetime before we inject anything.
-    if not isinstance(begin, datetime.datetime):
+    if not isinstance(begin, datetime):
         try:
             begin_time = dateutil_parser.parse(begin)
         except Exception:
@@ -360,7 +361,13 @@ def dateadd_str(
         clean(str(begin))
     ### If begin is a valid datetime, wrap it in quotes.
     else:
-        begin = f"'{begin}'"
+        if isinstance(begin, datetime) and begin.tzinfo is not None:
+            begin = begin.astimezone(timezone.utc)
+        begin = (
+            f"'{begin.replace(tzinfo=None)}'"
+            if isinstance(begin, datetime)
+            else f"'{begin}'"
+        )
 
     da = ""
     if flavor in ('postgresql', 'timescaledb', 'cockroachdb', 'citus'):
@@ -390,7 +397,7 @@ def dateadd_str(
     elif flavor == 'oracle':
         if begin == 'now':
             begin = str(
-                datetime.datetime.utcnow().strftime('%Y:%m:%d %M:%S.%f')
+                datetime.now(timezone.utc).replace(tzinfo=None).strftime('%Y:%m:%d %M:%S.%f')
             )
         elif begin_time:
             begin = str(begin_time.strftime('%Y-%m-%d %H:%M:%S.%f'))
@@ -956,10 +963,6 @@ def get_table_cols_types(
                 )
             )
         ]
-        if debug:
-            dprint(f"schema={schema}, database={database}")
-            for doc in cols_types_docs:
-                print(doc)
 
         ### NOTE: This may return incorrect columns if the schema is not explicitly stated.
         if cols_types_docs and not cols_types_docs_filtered:
@@ -1082,7 +1085,7 @@ def get_update_queries(
             for col in patch_table_columns
         ]
     )
-    join_cols_str = ','.join(
+    join_cols_str = ', '.join(
         [
             sql_item_name(col, flavor)
             for col in join_cols
@@ -1107,10 +1110,27 @@ def get_update_queries(
     if debug:
         dprint(f"value_cols: {value_cols}")
 
-    if not value_cols or not join_cols_types:
+    if not join_cols_types:
+        return []
+    if not value_cols and not upsert:
         return []
 
+    coalesce_join_cols_str = ', '.join(
+        [
+            'COALESCE('
+            + sql_item_name(c_name, flavor)
+            + ', '
+            + get_null_replacement(c_type, flavor)
+            + ')'
+            for c_name, c_type in join_cols_types
+        ]
+    )
+
+    update_or_nothing = ('UPDATE' if value_cols else 'NOTHING')
+
     def sets_subquery(l_prefix: str, r_prefix: str):
+        if not value_cols:
+            return ''
         return 'SET ' + ',\n'.join([
             (
                 l_prefix + sql_item_name(c_name, flavor, None)
@@ -1167,6 +1187,8 @@ def get_update_queries(
             patch_cols_str = patch_cols_str,
             date_bounds_subquery = date_bounds_subquery,
             join_cols_str = join_cols_str,
+            coalesce_join_cols_str = coalesce_join_cols_str,
+            update_or_nothing = update_or_nothing,
         )
         for base_query in base_queries
     ]

meerschaum/utils/typing.py

@@ -87,3 +87,14 @@ PipesDict = Dict[
     ]
 ]
 WebState = Dict[str, str]
+
+def is_success_tuple(x: Any) -> bool:
+    """
+    Determine whether an object is a `SuccessTuple`.
+    """
+    return (
+        isinstance(x, tuple)
+        and len(x) == 2
+        and isinstance(x[0], bool)
+        and isinstance(x[1], str)
+    )

meerschaum/utils/venv/__init__.py

@@ -368,10 +368,11 @@ def init_venv(
     docker_home_venv_path = pathlib.Path('/home/meerschaum/venvs/mrsm')
 
     runtime_env_var = STATIC_CONFIG['environment']['runtime']
+    work_dir_env_var = STATIC_CONFIG['environment']['work_dir']
     if (
         not force
         and venv == 'mrsm'
-        and os.environ.get(runtime_env_var, None) == 'docker'
+        and os.environ.get(work_dir_env_var, None) is not None
         and docker_home_venv_path.exists()
     ):
         shutil.move(docker_home_venv_path, venv_path)

{meerschaum-2.1.4.dist-info → meerschaum-2.1.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: meerschaum
-Version: 2.1.4
+Version: 2.1.6
 Summary: Sync Time-Series Pipes with Meerschaum
 Home-page: https://meerschaum.io
 Author: Bennett Meares
@@ -149,7 +149,6 @@ Requires-Dist: mypy >=0.812.0 ; extra == 'dev-tools'
 Requires-Dist: pytest >=6.2.2 ; extra == 'dev-tools'
 Requires-Dist: pytest-xdist >=3.2.1 ; extra == 'dev-tools'
 Requires-Dist: heartrate >=0.2.1 ; extra == 'dev-tools'
-Requires-Dist: py-heat >=0.0.6 ; extra == 'dev-tools'
 Provides-Extra: docs
 Requires-Dist: mkdocs >=1.1.2 ; extra == 'docs'
 Requires-Dist: mkdocs-material >=6.2.5 ; extra == 'docs'
@@ -307,7 +306,7 @@ Requires-Dist: docker-compose >=1.27.4 ; extra == 'stack'
 | PyPI | GitHub | Info | Stats |
 |---|---|---|---|
 | ![PyPI]( https://img.shields.io/pypi/v/meerschaum?color=%2300cc66&label=Version ) | ![GitHub Repo stars](https://img.shields.io/github/stars/bmeares/Meerschaum?style=social) | ![License](https://img.shields.io/github/license/bmeares/Meerschaum?label=License) | ![Number of plugins]( https://img.shields.io/badge/dynamic/json?color=3098c1&label=Public%20Plugins&query=num_plugins&url=https%3A%2F%2Fapi.mrsm.io%2Finfo ) |
-| ![PyPI - Python Version]( https://img.shields.io/pypi/pyversions/meerschaum?label=Python&logo=python&logoColor=%23ffffff ) | ![GitHub Sponsors](https://img.shields.io/github/sponsors/bmeares?color=eadf15&label=Sponsors) | [![meerschaum Tutorials](https://badges.openbase.com/python/tutorials/meerschaum.svg?token=2Yi8Oav9UZYWocO1ncwnIOnpUN5dTnUMWai7lAKTB+k=)](https://openbase.com/python/meerschaum?utm_source=embedded&utm_medium=badge&utm_campaign=rate-badge) | ![Number of registered users]( https://img.shields.io/badge/dynamic/json?color=3098c1&label=Registered%20Users&query=num_users&url=https%3A%2F%2Fapi.mrsm.io%2Finfo ) |
+| ![PyPI - Python Version]( https://img.shields.io/pypi/pyversions/meerschaum?label=Python&logo=python&logoColor=%23ffffff ) | ![GitHub Sponsors](https://img.shields.io/github/sponsors/bmeares?color=eadf15&label=Sponsors) | [![Artifact Hub](https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/meerschaum)](https://artifacthub.io/packages/search?repo=meerschaum) | ![Number of registered users]( https://img.shields.io/badge/dynamic/json?color=3098c1&label=Registered%20Users&query=num_users&url=https%3A%2F%2Fapi.mrsm.io%2Finfo ) |
 
 <p align="center">
 <img src="https://meerschaum.io/files/images/demo.gif" alt="Meerschaum demo" height="450px">