meerschaum 2.1.4__tar.gz → 2.1.6__tar.gz

meerschaum-2.1.6/PKG-INFO

@@ -0,0 +1,499 @@
+Metadata-Version: 2.1
+Name: meerschaum
+Version: 2.1.6
+Summary: Sync Time-Series Pipes with Meerschaum
+Home-page: https://meerschaum.io
+Author: Bennett Meares
+Author-email: bennett.meares@gmail.com
+Maintainer-email: bennett.meares@gmail.com
+License: Apache Software License 2.0
+Project-URL: Documentation, https://docs.meerschaum.io
+Project-URL: Changelog, https://meerschaum.io/news/changelog
+Project-URL: GitHub, https://github.com/bmeares/Meerschaum
+Project-URL: Homepage, https://meerschaum.io
+Project-URL: Donate, https://github.com/sponsors/bmeares
+Project-URL: Discord, https://discord.gg/8U8qMUjvcc
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: SQL
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Database
+Classifier: Natural Language :: English
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+Provides-Extra: required
+Provides-Extra: minimal
+Provides-Extra: formatting
+Requires-Dist: pprintpp>=0.4.0; extra == "formatting"
+Requires-Dist: asciitree>=0.3.3; extra == "formatting"
+Requires-Dist: typing-extensions>=4.7.1; extra == "formatting"
+Requires-Dist: pygments>=2.7.2; extra == "formatting"
+Requires-Dist: colorama>=0.4.3; extra == "formatting"
+Requires-Dist: rich>=13.4.2; extra == "formatting"
+Requires-Dist: more-termcolor>=1.1.3; extra == "formatting"
+Requires-Dist: humanfriendly>=10.0.0; extra == "formatting"
+Provides-Extra: required
+Requires-Dist: wheel>=0.34.2; extra == "required"
+Requires-Dist: setuptools>=63.3.0; extra == "required"
+Requires-Dist: PyYAML>=5.3.1; extra == "required"
+Requires-Dist: pip>=22.0.4; extra == "required"
+Requires-Dist: update-checker>=0.18.0; extra == "required"
+Requires-Dist: semver>=3.0.0; extra == "required"
+Requires-Dist: pathspec>=0.9.0; extra == "required"
+Requires-Dist: python-dateutil>=2.7.5; extra == "required"
+Requires-Dist: requests>=2.23.0; extra == "required"
+Requires-Dist: binaryornot>=0.4.4; extra == "required"
+Requires-Dist: pyvim>=3.0.2; extra == "required"
+Requires-Dist: aiofiles>=0.6.0; extra == "required"
+Requires-Dist: packaging>=21.3.0; extra == "required"
+Requires-Dist: prompt-toolkit>=3.0.39; extra == "required"
+Requires-Dist: more-itertools>=8.7.0; extra == "required"
+Requires-Dist: python-daemon>=0.2.3; extra == "required"
+Requires-Dist: fasteners>=0.18.0; extra == "required"
+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"
+Provides-Extra: drivers
+Requires-Dist: cryptography>=38.0.1; extra == "drivers"
+Requires-Dist: psycopg2-binary>=2.8.6; extra == "drivers"
+Requires-Dist: PyMySQL>=0.9.0; extra == "drivers"
+Requires-Dist: aiomysql>=0.0.21; extra == "drivers"
+Requires-Dist: sqlalchemy-cockroachdb>=2.0.0; extra == "drivers"
+Requires-Dist: duckdb>=0.9.0; extra == "drivers"
+Requires-Dist: duckdb-engine>=0.9.2; extra == "drivers"
+Provides-Extra: drivers
+Requires-Dist: pyodbc>=4.0.30; extra == "drivers"
+Requires-Dist: cx_Oracle>=8.3.0; extra == "drivers"
+Provides-Extra: cli
+Requires-Dist: pgcli>=3.1.0; extra == "cli"
+Requires-Dist: mycli>=1.23.2; extra == "cli"
+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"
+Provides-Extra: build
+Requires-Dist: cx_Freeze>=6.5.1; extra == "build"
+Requires-Dist: pyinstaller>=5.0.0-dev0; extra == "build"
+Provides-Extra: dev-tools
+Requires-Dist: twine>=3.2.0; extra == "dev-tools"
+Requires-Dist: tuna>=0.5.3; extra == "dev-tools"
+Requires-Dist: snakeviz>=2.1.0; extra == "dev-tools"
+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"
+Provides-Extra: setup
+Provides-Extra: docs
+Requires-Dist: mkdocs>=1.1.2; extra == "docs"
+Requires-Dist: mkdocs-material>=6.2.5; extra == "docs"
+Requires-Dist: mkdocs-material-extensions>=1.0.3; extra == "docs"
+Requires-Dist: mkdocs-autolinks-plugin>=0.2.0; extra == "docs"
+Requires-Dist: mkdocs-awesome-pages-plugin>=2.5.0; extra == "docs"
+Requires-Dist: mkdocs-section-index>=0.3.3; extra == "docs"
+Requires-Dist: mkdocs-linkcheck>=1.0.6; extra == "docs"
+Requires-Dist: mkdocs-redirects>=1.0.4; extra == "docs"
+Requires-Dist: jinja2==3.0.3; extra == "docs"
+Provides-Extra: gui
+Requires-Dist: toga>=0.3.0-dev29; extra == "gui"
+Requires-Dist: pywebview>=3.6.3; extra == "gui"
+Requires-Dist: pycparser>=2.21.0; extra == "gui"
+Provides-Extra: extras
+Requires-Dist: cmd2>=1.4.0; extra == "extras"
+Requires-Dist: ruamel.yaml>=0.16.12; extra == "extras"
+Requires-Dist: modin[ray]>=0.8.3; extra == "extras"
+Requires-Dist: nanoid>=2.0.0; extra == "extras"
+Requires-Dist: importlib-metadata>=4.12.0; extra == "extras"
+Provides-Extra: sql
+Requires-Dist: numpy>=1.18.5; extra == "sql"
+Requires-Dist: pandas[parquet]>=2.0.1; extra == "sql"
+Requires-Dist: pyarrow>=7.0.0; extra == "sql"
+Requires-Dist: dask>=2023.5.0; extra == "sql"
+Requires-Dist: pytz; extra == "sql"
+Requires-Dist: joblib>=0.17.0; extra == "sql"
+Requires-Dist: SQLAlchemy>=2.0.5; extra == "sql"
+Requires-Dist: databases>=0.4.0; extra == "sql"
+Requires-Dist: aiosqlite>=0.16.0; extra == "sql"
+Requires-Dist: asyncpg>=0.21.0; extra == "sql"
+Requires-Dist: cryptography>=38.0.1; extra == "sql"
+Requires-Dist: psycopg2-binary>=2.8.6; extra == "sql"
+Requires-Dist: PyMySQL>=0.9.0; extra == "sql"
+Requires-Dist: aiomysql>=0.0.21; extra == "sql"
+Requires-Dist: sqlalchemy-cockroachdb>=2.0.0; extra == "sql"
+Requires-Dist: duckdb>=0.9.0; extra == "sql"
+Requires-Dist: duckdb-engine>=0.9.2; extra == "sql"
+Requires-Dist: wheel>=0.34.2; extra == "sql"
+Requires-Dist: setuptools>=63.3.0; extra == "sql"
+Requires-Dist: PyYAML>=5.3.1; extra == "sql"
+Requires-Dist: pip>=22.0.4; extra == "sql"
+Requires-Dist: update-checker>=0.18.0; extra == "sql"
+Requires-Dist: semver>=3.0.0; extra == "sql"
+Requires-Dist: pathspec>=0.9.0; extra == "sql"
+Requires-Dist: python-dateutil>=2.7.5; extra == "sql"
+Requires-Dist: requests>=2.23.0; extra == "sql"
+Requires-Dist: binaryornot>=0.4.4; extra == "sql"
+Requires-Dist: pyvim>=3.0.2; extra == "sql"
+Requires-Dist: aiofiles>=0.6.0; extra == "sql"
+Requires-Dist: packaging>=21.3.0; extra == "sql"
+Requires-Dist: prompt-toolkit>=3.0.39; extra == "sql"
+Requires-Dist: more-itertools>=8.7.0; extra == "sql"
+Requires-Dist: python-daemon>=0.2.3; extra == "sql"
+Requires-Dist: fasteners>=0.18.0; extra == "sql"
+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"
+Provides-Extra: dash
+Requires-Dist: Flask-Compress>=1.10.1; extra == "dash"
+Requires-Dist: dash>=2.6.2; extra == "dash"
+Requires-Dist: dash-bootstrap-components>=1.2.1; extra == "dash"
+Requires-Dist: dash-ace>=0.2.1; extra == "dash"
+Requires-Dist: dash-extensions>=1.0.4; extra == "dash"
+Requires-Dist: dash-daq>=0.5.0; extra == "dash"
+Requires-Dist: terminado>=0.12.1; extra == "dash"
+Requires-Dist: tornado>=6.1.0; extra == "dash"
+Provides-Extra: api
+Requires-Dist: uvicorn[standard]>=0.22.0; extra == "api"
+Requires-Dist: gunicorn>=20.1.0; extra == "api"
+Requires-Dist: python-dotenv>=0.20.0; extra == "api"
+Requires-Dist: websockets>=11.0.3; extra == "api"
+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"
+Requires-Dist: pyarrow>=7.0.0; extra == "api"
+Requires-Dist: dask>=2023.5.0; extra == "api"
+Requires-Dist: pytz; extra == "api"
+Requires-Dist: joblib>=0.17.0; extra == "api"
+Requires-Dist: SQLAlchemy>=2.0.5; extra == "api"
+Requires-Dist: databases>=0.4.0; extra == "api"
+Requires-Dist: aiosqlite>=0.16.0; extra == "api"
+Requires-Dist: asyncpg>=0.21.0; extra == "api"
+Requires-Dist: cryptography>=38.0.1; extra == "api"
+Requires-Dist: psycopg2-binary>=2.8.6; extra == "api"
+Requires-Dist: PyMySQL>=0.9.0; extra == "api"
+Requires-Dist: aiomysql>=0.0.21; extra == "api"
+Requires-Dist: sqlalchemy-cockroachdb>=2.0.0; extra == "api"
+Requires-Dist: duckdb>=0.9.0; extra == "api"
+Requires-Dist: duckdb-engine>=0.9.2; extra == "api"
+Requires-Dist: wheel>=0.34.2; extra == "api"
+Requires-Dist: setuptools>=63.3.0; extra == "api"
+Requires-Dist: PyYAML>=5.3.1; extra == "api"
+Requires-Dist: pip>=22.0.4; extra == "api"
+Requires-Dist: update-checker>=0.18.0; extra == "api"
+Requires-Dist: semver>=3.0.0; extra == "api"
+Requires-Dist: pathspec>=0.9.0; extra == "api"
+Requires-Dist: python-dateutil>=2.7.5; extra == "api"
+Requires-Dist: requests>=2.23.0; extra == "api"
+Requires-Dist: binaryornot>=0.4.4; extra == "api"
+Requires-Dist: pyvim>=3.0.2; extra == "api"
+Requires-Dist: aiofiles>=0.6.0; extra == "api"
+Requires-Dist: packaging>=21.3.0; extra == "api"
+Requires-Dist: prompt-toolkit>=3.0.39; extra == "api"
+Requires-Dist: more-itertools>=8.7.0; extra == "api"
+Requires-Dist: python-daemon>=0.2.3; extra == "api"
+Requires-Dist: fasteners>=0.18.0; extra == "api"
+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: pprintpp>=0.4.0; extra == "api"
+Requires-Dist: asciitree>=0.3.3; extra == "api"
+Requires-Dist: typing-extensions>=4.7.1; extra == "api"
+Requires-Dist: pygments>=2.7.2; extra == "api"
+Requires-Dist: colorama>=0.4.3; extra == "api"
+Requires-Dist: rich>=13.4.2; extra == "api"
+Requires-Dist: more-termcolor>=1.1.3; extra == "api"
+Requires-Dist: humanfriendly>=10.0.0; extra == "api"
+Requires-Dist: Flask-Compress>=1.10.1; extra == "api"
+Requires-Dist: dash>=2.6.2; extra == "api"
+Requires-Dist: dash-bootstrap-components>=1.2.1; extra == "api"
+Requires-Dist: dash-ace>=0.2.1; extra == "api"
+Requires-Dist: dash-extensions>=1.0.4; extra == "api"
+Requires-Dist: dash-daq>=0.5.0; extra == "api"
+Requires-Dist: terminado>=0.12.1; extra == "api"
+Requires-Dist: tornado>=6.1.0; extra == "api"
+Provides-Extra: full
+Requires-Dist: pprintpp>=0.4.0; extra == "full"
+Requires-Dist: asciitree>=0.3.3; extra == "full"
+Requires-Dist: typing-extensions>=4.7.1; extra == "full"
+Requires-Dist: pygments>=2.7.2; extra == "full"
+Requires-Dist: colorama>=0.4.3; extra == "full"
+Requires-Dist: rich>=13.4.2; extra == "full"
+Requires-Dist: more-termcolor>=1.1.3; extra == "full"
+Requires-Dist: humanfriendly>=10.0.0; extra == "full"
+Requires-Dist: wheel>=0.34.2; extra == "full"
+Requires-Dist: setuptools>=63.3.0; extra == "full"
+Requires-Dist: PyYAML>=5.3.1; extra == "full"
+Requires-Dist: pip>=22.0.4; extra == "full"
+Requires-Dist: update-checker>=0.18.0; extra == "full"
+Requires-Dist: semver>=3.0.0; extra == "full"
+Requires-Dist: pathspec>=0.9.0; extra == "full"
+Requires-Dist: python-dateutil>=2.7.5; extra == "full"
+Requires-Dist: requests>=2.23.0; extra == "full"
+Requires-Dist: binaryornot>=0.4.4; extra == "full"
+Requires-Dist: pyvim>=3.0.2; extra == "full"
+Requires-Dist: aiofiles>=0.6.0; extra == "full"
+Requires-Dist: packaging>=21.3.0; extra == "full"
+Requires-Dist: prompt-toolkit>=3.0.39; extra == "full"
+Requires-Dist: more-itertools>=8.7.0; extra == "full"
+Requires-Dist: python-daemon>=0.2.3; extra == "full"
+Requires-Dist: fasteners>=0.18.0; extra == "full"
+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: cryptography>=38.0.1; extra == "full"
+Requires-Dist: psycopg2-binary>=2.8.6; extra == "full"
+Requires-Dist: PyMySQL>=0.9.0; extra == "full"
+Requires-Dist: aiomysql>=0.0.21; extra == "full"
+Requires-Dist: sqlalchemy-cockroachdb>=2.0.0; extra == "full"
+Requires-Dist: duckdb>=0.9.0; extra == "full"
+Requires-Dist: duckdb-engine>=0.9.2; extra == "full"
+Requires-Dist: toga>=0.3.0-dev29; extra == "full"
+Requires-Dist: pywebview>=3.6.3; extra == "full"
+Requires-Dist: pycparser>=2.21.0; extra == "full"
+Requires-Dist: numpy>=1.18.5; extra == "full"
+Requires-Dist: pandas[parquet]>=2.0.1; extra == "full"
+Requires-Dist: pyarrow>=7.0.0; extra == "full"
+Requires-Dist: dask>=2023.5.0; extra == "full"
+Requires-Dist: pytz; extra == "full"
+Requires-Dist: joblib>=0.17.0; extra == "full"
+Requires-Dist: SQLAlchemy>=2.0.5; extra == "full"
+Requires-Dist: databases>=0.4.0; extra == "full"
+Requires-Dist: aiosqlite>=0.16.0; extra == "full"
+Requires-Dist: asyncpg>=0.21.0; extra == "full"
+Requires-Dist: Flask-Compress>=1.10.1; extra == "full"
+Requires-Dist: dash>=2.6.2; extra == "full"
+Requires-Dist: dash-bootstrap-components>=1.2.1; extra == "full"
+Requires-Dist: dash-ace>=0.2.1; extra == "full"
+Requires-Dist: dash-extensions>=1.0.4; extra == "full"
+Requires-Dist: dash-daq>=0.5.0; extra == "full"
+Requires-Dist: terminado>=0.12.1; extra == "full"
+Requires-Dist: tornado>=6.1.0; extra == "full"
+Requires-Dist: uvicorn[standard]>=0.22.0; extra == "full"
+Requires-Dist: gunicorn>=20.1.0; extra == "full"
+Requires-Dist: python-dotenv>=0.20.0; extra == "full"
+Requires-Dist: websockets>=11.0.3; extra == "full"
+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%"/>
+
+| 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) | [![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">
+</p>
+
+## What is Meerschaum?
+Meerschaum is a tool for quickly synchronizing time-series data streams called **pipes**. With Meerschaum, you can have a data visualization stack running in minutes.
+
+<p align="center">
+<img src="https://meerschaum.io/assets/screenshots/weather_pipes.png"/>
+</p>
+
+## Why Meerschaum?
+
+Two words: *incremental updates*. Fetch the data you need, and Meerschaum will handle the rest.
+
+If you've worked with time-series data, you know the headaches that come with ETL.
+Data engineering often gets in analysts' way, and when work needs to get done, every minute spent on pipelining is time taken away from real analysis.
+
+Rather than copy / pasting your ETL scripts, simply build pipes with Meerschaum! [Meerschaum gives you the tools to design your data streams how you like](https://towardsdatascience.com/easy-time-series-etl-for-data-scientists-with-meerschaum-5aade339b398) ― and don't worry — you can always incorporate Meerschaum into your existing systems!
+
+### Want to Learn More?
+
+You can find a wealth of information at [meerschaum.io](https://meerschaum.io)!
+
+Additionally, below are several articles published about Meerschaum:
+
+- Interview featured in [*Console 100 - The Open Source Newsletter*](https://console.substack.com/p/console-100)
+- [*A Data Scientist's Guide to Fetching COVID-19 Data in 2022*](https://towardsdatascience.com/a-data-scientists-guide-to-fetching-covid-19-data-in-2022-d952b4697) (Towards Data Science)
+- [*Time-Series ETL with Meerschaum*](https://towardsdatascience.com/easy-time-series-etl-for-data-scientists-with-meerschaum-5aade339b398) (Towards Data Science)
+- [*How I automatically extract my M1 Finance transactions*](https://bmeares.medium.com/how-i-automatically-extract-my-m1-finance-transactions-b43cef857bc7)
+
+## Installation
+
+For a more thorough setup guide, visit the [Getting Started](https://meerschaum.io/get-started/) page at [meerschaum.io](https://meerschaum.io).
+
+### TL;DR
+
+```bash
+pip install -U --user meerschaum
+mrsm stack up -d db grafana
+mrsm bootstrap pipes
+```
+
+## Usage
+
+Please visit [meerschaum.io](https://meerschaum.io) for setup, usage, and troubleshooting information. You can find technical documentation at [docs.meerschaum.io](https://docs.meerschaum.io), and here is a complete list of the [Meerschaum actions](https://meerschaum.io/reference/actions/).
+
+### CLI
+```bash
+### Install the NOAA weather plugin.
+mrsm install plugin noaa
+
+### Register a new pipe to the built-in SQLite DB.
+### You can instead run `bootstrap pipe` for a wizard.
+### Enter 'KATL' for Atlanta when prompted.
+mrsm register pipe -c plugin:noaa -m weather -l atl -i sql:local
+
+### Pull data and create the table "plugin_noaa_weather_atl".
+mrsm sync pipes -l atl -i sql:local
+```
+
+### Python API
+
+```python
+import meerschaum as mrsm
+pipe = mrsm.Pipe(
+    'foo', 'bar',              ### Connector and metric labels.
+    target   = 'MyTableName!', ### Table name. Defaults to 'foo_bar'.
+    instance = 'sql:local',    ### Built-in SQLite DB. Defaults to 'sql:main'.
+    columns  = {
+        'datetime': 'dt',      ### Column for the datetime index.
+        'id'      : 'id',      ### Column for the ID index (optional).
+    },
+)
+### Pass a DataFrame to create the table and indices.
+pipe.sync([{'dt': '2022-07-01', 'id': 1, 'val': 10}])
+
+### Duplicate rows are ignored.
+pipe.sync([{'dt': '2022-07-01', 'id': 1, 'val': 10}])
+assert len(pipe.get_data()) == 1
+
+### Rows with existing keys (datetime and/or id) are updated.
+pipe.sync([{'dt': '2022-07-01', 'id': 1, 'val': 100}])
+assert len(pipe.get_data()) == 1
+
+### Translates to this query for SQLite:
+###
+### SELECT *
+### FROM "MyTableName!"
+### WHERE "dt" >= datetime('2022-01-01', '0 minute')
+###   AND "dt" <  datetime('2023-01-01', '0 minute')
+###   AND "id" IN ('1')
+df = pipe.get_data(
+    begin  = '2022-01-01',
+    end    = '2023-01-01',
+    params = {'id': [1]},
+)
+
+### Shape of the DataFrame:
+###           dt  id  val
+### 0 2022-07-01   1  100
+
+### Drop the table and remove the pipe's metadata.
+pipe.delete()
+```
+
+### Simple Plugin
+
+```python
+# ~/.config/plugins/example.py
+
+__version__ = '1.0.0'
+required = ['requests']
+
+def register(pipe, **kw):
+    return {
+        'columns': {
+            'datetime': 'dt',
+            'id'      : 'id',
+        },
+    }
+
+def fetch(pipe, **kw):
+    import requests, datetime, random
+    response = requests.get('http://date.jsontest.com/')
+
+    ### The fetched JSON has the following shape:
+    ### {
+    ###     "date": "07-01-2022",
+    ###     "milliseconds_since_epoch": 1656718801566,
+    ###     "time": "11:40:01 PM"
+    ### }
+    data = response.json()
+    timestamp = datetime.datetime.fromtimestamp(
+        int(str(data['milliseconds_since_epoch'])[:-3])
+    )
+
+    ### You may also return a Pandas DataFrame.
+    return [{
+        "dt"   : timestamp,
+        "id"   : random.randint(1, 4),
+        "value": random.uniform(1, 100),
+    }]
+```
+
+## Features
+
+- 📊 **Built for Data Scientists and Analysts**  
+  - Integrate with Pandas, Grafana and other popular [data analysis tools](https://meerschaum.io/reference/data-analysis-tools/).
+  - Persist your dataframes and always get the latest data.
+- ⚡️ **Production-Ready, Batteries Included**  
+  - [Synchronization engine](https://meerschaum.io/reference/pipes/syncing/) concurrently updates many time-series data streams.
+  - One-click deploy a [TimescaleDB and Grafana stack](https://meerschaum.io/reference/stack/) for prototyping.
+  - Serve data to your entire organization through the power of `uvicorn`, `gunicorn`, and `FastAPI`.
+- 🔌 **Easily Expandable**  
+  -  Ingest any data source with a simple [plugin](https://meerschaum.io/reference/plugins/writing-plugins/). Just return a DataFrame, and Meerschaum handles the rest.
+  - [Add any function as a command](https://meerschaum.io/reference/plugins/types-of-plugins/#action-plugins) to the Meerschaum system.
+  - Include Meerschaum in your projects with its [easy-to-use Python API](https://docs.meerschaum.io).
+- ✨ **Tailored for Your Experience**  
+  - Rich CLI makes managing your data streams surprisingly enjoyable!
+  - Web dashboard for those who prefer a more graphical experience.
+  - Manage your database connections with [Meerschaum connectors](https://meerschaum.io/reference/connectors/).
+  - Utility commands with sensible syntax let you control many pipes with grace.
+- 💼 **Portable from the Start**  
+  - The environment variable `$MRSM_ROOT_DIR` lets you emulate multiple installations and group together your [instances](https://meerschaum.io/reference/connectors/#instances-and-repositories).
+  - No dependencies required; anything needed will be installed into a virtual environment.
+  - [Specify required packages for your plugins](https://meerschaum.io/reference/plugins/writing-plugins/), and users will get those packages in a virtual environment.
+
+## Support Meerschaum's Development
+
+For consulting services and to support Meerschaum's development, please considering sponsoring me on [GitHub sponsors](https://github.com/sponsors/bmeares).
+
+Additionally, you can always [buy me a coffee☕](https://www.buymeacoffee.com/bmeares)!
+
+### License
+
+Copyright 2021 Bennett Meares
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

{meerschaum-2.1.4 → meerschaum-2.1.6}/README.md

@@ -3,7 +3,7 @@
 | 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">

{meerschaum-2.1.4 → meerschaum-2.1.6}/meerschaum/__main__.py

@@ -76,7 +76,7 @@ def _close_pools():
     """Close multiprocessing pools before exiting."""
     ### Final step: close global pools.
     from meerschaum.utils.pool import get_pools
-    for class_name, pool in get_pools().items():
+    for pool in get_pools().values():
         try:
             pool.close()
             pool.terminate()

{meerschaum-2.1.4 → meerschaum-2.1.6}/meerschaum/_internal/arguments/_parser.py

@@ -8,7 +8,9 @@ This module creates the argparse Parser.
 
 from __future__ import annotations
 import sys
-import argparse, json
+import argparse
+import json
+from datetime import datetime, timedelta, timezone
 from meerschaum.utils.typing import Union, Dict, List, Any, Tuple, Callable
 from meerschaum.utils.misc import string_to_dict
 from meerschaum.utils.warnings import error
@@ -35,19 +37,18 @@ class ArgumentParser(argparse.ArgumentParser):
         return result
 
 
-def parse_datetime(dt_str: str) -> datetime.datetime:
+def parse_datetime(dt_str: str) -> datetime:
     """Parse a string into a datetime."""
     from meerschaum.utils.misc import is_int
     if is_int(dt_str):
         return int(dt_str)
 
     from meerschaum.utils.packages import attempt_import
-    import datetime
     dateutil_parser = attempt_import('dateutil.parser')
 
     try:
         if dt_str.lower() == 'now':
-            dt = datetime.datetime.utcnow()
+            dt = datetime.now(timezone.utc).replace(tzinfo=None)
         else:
             dt = dateutil_parser.parse(dt_str)
     except Exception as e:

{meerschaum-2.1.4 → meerschaum-2.1.6}/meerschaum/_internal/docs/index.py

@@ -11,14 +11,14 @@
 | ![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 ) |
 
 <p align="center">
-<img src="https://meerschaum.io/files/images/demo.gif" alt="Meerschaum demo" height="450px">
+<img src="https://meerschaum.io/files/images/demo.gif" alt="Meerschaum demo" style="width: 100%;">
 </p>
 
 ## What is Meerschaum?
 Meerschaum is a tool for quickly synchronizing time-series data streams called **pipes**. With Meerschaum, you can have a data visualization stack running in minutes.
 
 <p align="center">
-<img src="https://meerschaum.io/assets/screenshots/weather_pipes.png"/>
+<img src="https://meerschaum.io/assets/screenshots/weather_pipes.png" style="width: 100%;"/>
 </p>
 
 ## Why Meerschaum?

{meerschaum-2.1.4 → meerschaum-2.1.6}/meerschaum/_internal/term/TermPageHandler.py

@@ -8,9 +8,9 @@ Define the terminal page handler class.
 
 from __future__ import annotations
 from meerschaum.utils.packages import attempt_import
-tornado = attempt_import('tornado', lazy=False)
+tornado_web = attempt_import('tornado.web', lazy=False)
 
-class TermPageHandler(tornado.web.RequestHandler):
+class TermPageHandler(tornado_web.RequestHandler):
     def get(self):
         from meerschaum.api import endpoints
         return self.render(

{meerschaum-2.1.4 → meerschaum-2.1.6}/meerschaum/actions/register.py

@@ -7,7 +7,7 @@ Register new Pipes. Requires the API to be running.
 """
 
 from __future__ import annotations
-from meerschaum.utils.typing import SuccessTuple, Any, List, Optional
+from meerschaum.utils.typing import SuccessTuple, Any, List, Optional, Dict
 
 def register(
         action: Optional[List[str]] = None,
@@ -55,6 +55,7 @@ def _register_pipes(
         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: Any
     ) -> SuccessTuple:
@@ -79,6 +80,8 @@ def _register_pipes(
         location_keys = []
     if params is None:
         params = {}
+    if tags:
+        params['tags'] = tags
 
     if (
         len(connector_keys) == 0 or
@@ -96,6 +99,7 @@ def _register_pipes(
         metric_keys = metric_keys,
         location_keys = location_keys,
         params = params,
+        tags = tags,
         as_list = True,
         method = 'explicit',
         debug = debug,

{meerschaum-2.1.4 → meerschaum-2.1.6}/meerschaum/actions/show.py

@@ -738,6 +738,7 @@ def _show_environment(
 
 
 def _show_tags(
+        action: Optional[List[str]] = None,
         tags: Optional[List[str]] = None,
         workers: Optional[int] = None,
         nopretty: bool = False,
@@ -757,7 +758,12 @@ def _show_tags(
     )
     panel = rich_panel.Panel.fit('Tags')
     tree = rich_tree.Tree(panel)
-    pipes = mrsm.get_pipes(as_list=True, **kwargs)
+    action = action or []
+    tags = action + (tags or [])
+    pipes = mrsm.get_pipes(as_list=True, tags=tags, **kwargs)
+    if not pipes:
+        return False, f"No pipes were found with the given tags."
+
     pool = get_pool(workers=workers)
     tag_prefix = get_config('formatting', 'pipes', 'unicode', 'icons', 'tag') if UNICODE else ''
     tag_style = get_config('formatting', 'pipes', 'ansi', 'styles', 'tags') if ANSI else None
@@ -769,6 +775,8 @@ def _show_tags(
 
     for pipe, tags in pipes_tags.items():
         for tag in tags:
+            if action and tag not in action:
+                continue
             tags_pipes[tag].append(pipe)
 
     columns = []
@@ -790,6 +798,9 @@ def _show_tags(
         tag_panel = rich_panel.Panel(tag_group, title=tag_text, title_align='left')
         columns.append(tag_panel)
 
+    if len(columns) == 0:
+        return False, "No pipes have been tagged."
+
     if not nopretty:
         mrsm.pprint(
             rich_columns.Columns(