A pybuilder plugin that generates badges for your project. The plugin will generate badges using shields.io. However it can also create badges using anybadge if configured to do so.
To add this plugin into your pybuilder project, add the following line near the top of your build.py:
use_plugin('pypi:pybuilder_anybadge')NOTE if you are using Pybuilder version v0.11.x, then specify the following version of the plugin:
use_plugin('pypi:pybuilder_anybadge', '~=0.1.6')The pybuilder task pyb anybadge will use anybadge to generate badges for your project by processing reports produced from various plugins; the badges that are currently supported are:
- complexity - requires the pybuilder_radon plugin. Generate badge using cyclomatic complexity score of your most complicated function.
- vulnerabilities - requires the pybuilder_bandit plugin. Generate badge using number of security vulnerabilities discovered by vulnerabilities.
- coverage - requires the
coverageplugin. Generate badge for overall unit test coverage. - python - Generate badge for version of Python being used
The plugin will write the respective badges to the docs/images folder. The following plugin properties are available to further configure badge generation.
| Name | Type | Default Value | Description |
|---|---|---|---|
| anybadge_exclude | str | '' | Comma delimited string of badges to exclude from processing, valid values are 'complexity', 'vulnerabilities', 'coverage' and 'python' |
| anybadge_complexity_use_average | bool | False | Use overall average complexity as score when generating complexity badge |
| anybadge_use_shields | bool | True | Will use img.shields.io to create the badges, if False will use anybadge |
Note the plugin will add the badge references but you must commit/push the changes (including svg files in the docs/images folder)
The plugin properties are set using project.set_property, the following is an example of how to set the properties:
project.set_property('anybadge_exclude', 'vulnerabilities,coverage')
project.set_property('anybadge_complexity_use_average', True)
project.set_property('anybadge_use_shields', True)By default the plugin will use shields.io to create the badges:
However, setting anybadge_use_shields to False will render the badges using anybadge and save them as svg files in the docs\images folder:
Clone the repository and ensure the latest version of Docker is installed on your development server.
Build the Docker image:
docker image build \
-t \
pybanybadge:latest .Run the Docker container:
docker container run \
--rm \
-it \
-v $PWD:/code \
pybanybadge:latest \
bashExecute the build:
pyb -X