plugin-package-template 0.1.415625538

Plugin template project used to quick start development of a new Versatile Data Kit SDK plugin.

This directory outlines a template which specifies the implementation of all vdk-core plugins. It includes a setup.py file, a /src/ directory containing all the plugin hooks and additional implementation files, a /tests/ directory containing all plugin-specific tests, and a .plugin-ci.yml file which specifies the CI/CD relevant to the plugins.

The CI/CD is separated in two stages, a build stage and a release stage. The build stage is made up of three jobs, all which inherit from the same job configuration and only differ in the Python version they use (3.7, 3.8, 3.9 and 3.10). They run according to three rules, which are ordered in a way such that changes to a plugin's directory or the main directory triggers them, but changes to a different plugin do not.

In order to add a new plugin , copy the plugin-template directory and follow the instructions in the files Generally those are

• Update the setup.py file with correct name of the plugin;
• Update .plugin-ci.yml file with name of the plugin - make sure to follow comments;
• Include your implementation files inside the src folder;
• Include any tests inside the tests so they can be ran by CI framework automatically.

In order to build and test a plugin go to the plugin directory and use ../build-plugin.sh script to build it