/pybuilder-anybadge

A pybuilder plugin that generates badges for your pyb project.

Primary LanguagePythonApache License 2.0Apache-2.0

pybuilder-anybadge

GitHub Workflow Status PyPI version python

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')

Pybuilder anybadge properties

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 coverage plugin. 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:

coverage complexity vulnerabilities python

However, setting anybadge_use_shields to False will render the badges using anybadge and save them as svg files in the docs\images folder:

coverage complexity vulnerabilities python

Development

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 \
bash

Execute the build:

pyb -X