β Plugins¶
Meerschaum plugins let you ingest any data source into pipes as well as defining custom actions, connectors, API endpoints, dash apps, and more.
Quickstart¶
Run bootstrap plugin to get started:
Rust plugins
Prefer Rust? Create a single-file plugin to add actions, data sources, and connectors. Python and Rust plugins can share the same plugins directory. The advanced Rust guide covers packaging and other native extensions.
What can I do with plugins?
Plugins are just Python modules, so the sky is the limit as to what's possible. The main idea behind plugins is to connect to any arbitrary data source: read more about the types of plugins to get into the specifics.
If plugins are just Python modules, why don't I just use a normal Python package?
Of course you can still use Meerschaum in typical Python packages. The plugins system provides these benefits for your convenience, however:
-
No boilerplate. You might only need to define a short
fetch()function. Skipsetup.py/pyproject.tomland write only what you need. -
Fearless refactoring. Plugins are self-contained and portable, which means you can safely refactor your plugins without worrying about breaking imports somewhere else in your codebase.
-
Get core functionality for free. Writing your module as a plugin unlocks access to the rest of the Meerschaum system, e.g. connector management, date-bounded syncing, integration with the Web Console and the Meerschaum Compose workflow.
Ok, I think I understand. How do I make my own plugins?
Here is the complete guide to writing your own plugins, but the TL;DR is this:
-
Create a new file
example.pyin~/.config/meerschaum/plugins/(Windows:%APPDATA%\Meerschaum\plugins\). -
Paste this starter code:
-
Create a new pipe with your plugin as the connector and sync data into it.