Provider Definition Files are how Plainbox learns about providers.
Warning
Normally provider definition files are generated automatically by manage.py. They are generated both by manage.py install and manage.py develop. It should not be necessary to create such a file by hand.
Plainbox discovers and loads providers based on ‘.provider’ files placed in one of the following three directories:
Each provider file has similar structure based on the well-known .ini file syntax. Square braces denote sections, each of which contains arbitrary key-value entries.
Currently only one section is used, Plainbox Provider.
The following keys may be defined in this section:
Absolute pathname to a base directory that can be used to derive all of the other directories. If defined, any of the dir variables mentioned above gets an implicit default values:
Variable | Default Value |
---|---|
jobs_dir | $location/jobs |
whitelists_dir | $location/whitelists |
bin_dir | $location/bin |
data_dir | $location/data |
locale_dir | $location/locale |
locale_dir (alt) | $location/build/mo |
An example provider definition file looks like this:
[Plainbox Provider]
name = 2013.com.canonical:myprovider
version = 1.0
description = My Plainbox test provider
location = /opt/2013.com.canonical.myprovider/