Skip to main content

A simple CLI for rendering Quality Views

Project description


A simple CLI for rendering Quality Views. Built on Graphviz.


pip install quality-viewer


To use, you need to create a series of JSON documents in a folder. These files define the components in your quality view and the individual scores for each attribute. Scores are out of 10, quality-viewer uses the mean to generate the colours in the PDF.

This is an example of the component definition:

    "component": "my-lovely-component",
    "depends_on": ["my-other-component"],
    "attributes": [
            "name": "code",
            "score": 5,
            "notes": "I wrote this in Uni"
            "name": "tests",
            "score": 2,
            "notes": "I wrote this in Uni"

Then you can run the CLI against your folder of component definitions which will generate a PDF in that folder named quality_view.gv.pdf:

quality-viewer ./my_components

If you run these regularly, you probably want to label each PDF. Customise the label on the graph with the --label argument:

quality-viewer --label "Quality Views - Christmas 2019" ./my_components

A fairly elaborate example, which uses dated quality views can be found at (other repo)[more work]. This is a good repo to get started from.


This repository is setup to validate your work easily, running tests is as simple as:

make test

And checking your coding style is:

make check

To automagically conform to the above, run:

make format

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

quality-viewer-0.0.3.tar.gz (3.6 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page