Skip to content

Installation and Usage of Python Plugins¤

Plugins are a released as parts of Python packages. They can but do not need to be open-source and published on pypi.org (a widely used Python Package Index). One package can contain of multiple plugins.

Installation¤

If you want to install a python plugin package, you need to use cmemc’s admin workspace python command group.

The following shell commands demonstrate the basic workflow:

Install a plugin package from pypi.org:
$ cmemc admin workspace python install cmem-plugin-graphql
Install package cmem-plugin-graphql ... done
List installed plugins:
$ cmemc admin workspace python list-plugins
ID                                 Type            Label
---------------------------------  --------------  -------------
cmem_plugin_graphql-GraphQLPlugin  WorkflowPlugin  GraphQL query

You can get a list of all installed python packages: (1)

  1. This list contains all installed packages in the python environment, not just your plugin packages.
List all installed python packages:
$ cmemc admin workspace python list
Name                Version
------------------  -----------
certifi             2022.5.18.1
charset-normalizer  2.0.12
cmem-cmempy         22.1.1
cmem-plugin-base    1.2.0
idna                3.3
isodate             0.6.1
jep                 4.0.2
pip                 20.3.4
pyparsing           3.0.9
rdflib              6.1.1
requests            2.27.1
requests-toolbelt   0.9.1
setuptools          52.0.0
six                 1.16.0
urllib3             1.26.9
wheel               0.34.2

You also can (un-)install packages in a specific version or from a source distribution file. Please have a look at the admin workspace python command group for a complete documentation of the package / plugin commands.

Usage¤

Depending on the plugin type, an installed plugin can appear in different parts of the Build workbench:

Example: Searching for the Kafka Plugins

Workflow Plugins are listed in the Create new item dialog in the Task category. From there, you can create a task in your project and use it in a workflow.

Example: Searching for the Lifetime Plugin

Transform Plugins are listed in the sidebar of the Value formula editor and the Linking editor in the Transform tab. Drag and drop it on the canvas, and connect it with ingoing and / or outgoing links to other elements.

Comments