Tooling for converting coverage data into a SQL DB
Go to file
Doug Hellmann f51f4da5b1 import zuul job settings from project-config
This is a mechanically generated patch to complete step 1 of moving
the zuul job settings out of project-config and into each project
repository.

Because there will be a separate patch on each branch, the branch
specifiers for branch-specific jobs have been removed.

Because this patch is generated by a script, there may be some
cosmetic changes to the layout of the YAML file(s) as the contents are
normalized.

See the python3-first goal document for details:
https://governance.openstack.org/tc/goals/stein/python3-first.html

Change-Id: Ie230833a7a49ccd49c67a3969adb0a0ff7b798b7
Story: #2002586
Task: #24327
2018-09-08 22:49:41 -04:00
coverage2sql Add files table 2017-03-08 18:39:32 +09:00
doc/source Update links in README 2018-06-12 15:22:40 +08:00
etc Add unit tests and remove oslo_db 2016-11-11 11:33:43 +09:00
releasenotes Remove setting of version/release from releasenotes 2017-11-16 22:08:23 +01:00
tools Prepare for using standard python tests 2017-02-02 12:11:19 +00:00
.coveragerc Omit unit test files from coverage 2016-11-11 19:40:27 +09:00
.gitignore Switch to use stestr instead of os-testr 2017-12-16 17:45:42 +09:00
.gitreview Initial Cookiecutter Commit. 2016-04-19 12:24:29 +09:00
.mailmap Initial Cookiecutter Commit. 2016-04-19 12:24:29 +09:00
.stestr.conf Switch to use stestr instead of os-testr 2017-12-16 17:45:42 +09:00
.zuul.yaml import zuul job settings from project-config 2018-09-08 22:49:41 -04:00
CONTRIBUTING.rst Initial Cookiecutter Commit. 2016-04-19 12:24:29 +09:00
HACKING.rst Initial Cookiecutter Commit. 2016-04-19 12:24:29 +09:00
LICENSE Initial Cookiecutter Commit. 2016-04-19 12:24:29 +09:00
MANIFEST.in Add unit tests and remove oslo_db 2016-11-11 11:33:43 +09:00
README.rst Add release note link in README 2018-07-05 23:56:08 +08:00
babel.cfg Initial Cookiecutter Commit. 2016-04-19 12:24:29 +09:00
requirements.txt Update requirements 2017-04-27 16:53:43 +09:00
setup.cfg turn on warning-is-error in documentation build 2017-06-27 08:46:34 +00:00
setup.py Update requirements 2017-04-27 16:53:43 +09:00
test-requirements.txt Switch to use stestr instead of os-testr 2017-12-16 17:45:42 +09:00
tox.ini Switch to use stestr instead of os-testr 2017-12-16 17:45:42 +09:00

README.rst

Team and repository tags

image

coverage2sql README

Command to Read a coverage file and put the data in a SQL database

coverage2sql is a tool for storing data of test coverage into a SQL database. With using this tool, you can store time series coverage data and analyze it if your coverage rate is down.

Usage

DB Setup

The usage of coverage2sql is split into 2 stages. First you need to prepare a database with the proper schema; coverage2sql-db-manage should be used to do this. The utility requires db connection info which can be specified with a config file. Obviously the sql connector type, user, password, address, and database name should be specific to your environment. coverage2sql-db-manage will use alembic to setup the db schema. You can run the db migrations with a config file:

coverage2sql-db-manage --config-file etc/coverage2sql.conf upgrade head

This will bring the DB schema up to the latest version for coverage2sql.

coverage2sql

Once you have a database setup with the proper database schema you can then use the coverage2sql command to populate the database with data from your test coverage file. coverage2sql takes in a .coverage file through by passing it file paths as positional arguments to the script at this moment.

There are several options for running coverage2sql, they can be listed with:

coverage2sql --help

The only required option is --database-connection. The options can either be used on the CLI, or put in a config file. If a config file is used you need to specify the location on the CLI.

TODO

To see the TODO, go to the launchpad site:

ChangeLog

To see the release notes go here: https://docs.openstack.org/releasenotes/coverage2sql/