Getting started with plugin development
Tests
To run the tests use the following command:
Install and use in pipelines
Warning
This method will add the development version of the plugin to your Nextflow plugins
Take care when using this method and make sure that you are never using a
development version to run real pipelines.
You can delete all nf-schema
versions using this command:
- Install the current version of the plugin in your
.nextflow/plugins
folder
- Update or add the nf-schema plugin with the installed version in your test pipeline
Change and preview the docs
The docs are generated using Material for MkDocs. You can install the required packages as follows:
To change the docs, edit the files in the docs/ folder and run the following command to generate the docs:
To preview the docs, open the URL provided by mkdocs in your browser.
Release and publish the plugin
- In
build.gradle
make sure that: version
matches the desired release version,github.repository
matches the repository of the plugin,github.indexUrl
points to your fork of the plugins index repository.- Create a file named
$HOME/.gradle/gradle.properties
, where$HOME
is your home directory. Add the following properties: github_username
: The GitHub username granting access to the plugin repository.github_access_token
: The GitHub access token required to upload and commit changes to the plugin repository.github_commit_email
: The email address associated with your GitHub account.- Update the changelog.
- Build and publish the plugin to your GitHub repository:
- Create a pull request against the nextflow-io/plugins repository to make the plugin publicly accessible.