Create a third-party plugin for Watcher

Watcher provides a plugin architecture which allows anyone to extend the existing functionalities by implementing third-party plugins. This process can be cumbersome so this documentation is there to help you get going as quickly as possible.


We assume that you have set up a working Watcher development environment. So if this not already the case, you can check out our documentation which explains how to set up a development environment.

Third party project scaffolding

First off, we need to create the project structure. To do so, we can use cookiecutter and the OpenStack cookiecutter project scaffolder to generate the skeleton of our project:

$ virtualenv thirdparty
$ . thirdparty/bin/activate
$ pip install cookiecutter
$ cookiecutter

The last command will ask you for many information, and If you set module_name and repo_name as thirdparty, you should end up with a structure that looks like this:

$ cd thirdparty
$ tree .
├── babel.cfg
├── doc
│   └── source
│       ├──
│       ├── contributing.rst
│       ├── index.rst
│       ├── installation.rst
│       ├── readme.rst
│       └── usage.rst
├── HACKING.rst
├── README.rst
├── requirements.txt
├── setup.cfg
├── test-requirements.txt
├── thirdparty
│   ├──
│   └── tests
│       ├──
│       ├──
│       └──
└── tox.ini

Note: You should add python-watcher as a dependency in the requirements.txt file:

# Watcher-specific requirements

Implementing a plugin for Watcher

Now that the project skeleton has been created, you can start the implementation of your plugin. As of now, you can implement the following plugins for Watcher:

If you want to learn more on how to implement them, you can refer to their dedicated documentation.