Tooling for converting coverage data into a SQL DB
Go to file
Flavio Percoco a379416145 Show team and repo badges on README
This patch adds the team's and repository's badges to the README file.
The motivation behind this is to communicate the project status and
features at first glance.

For more information about this effort, please read this email thread:

http://lists.openstack.org/pipermail/openstack-dev/2016-October/105562.html

To see an example of how this would look like check:

b'https://gist.github.com/0ada7a1c5aefeb90f0e3d8b13ec27ea6\n'

Change-Id: Ibbd442d76a5351c4d71d8e060e48c80668b65260
2016-11-25 13:46:01 +01:00
coverage2sql Merge "Add test_type option to shell cli" 2016-11-16 05:27:39 +00:00
doc/source Initial Cookiecutter Commit. 2016-04-19 12:24:29 +09:00
etc Add unit tests and remove oslo_db 2016-11-11 11:33:43 +09:00
releasenotes Add releasenote 2016-11-11 10:35:13 +09:00
.coveragerc Omit unit test files from coverage 2016-11-11 19:40:27 +09:00
.gitignore Add adding data feature 2016-04-21 16:40:45 +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
.testr.conf Initial Cookiecutter Commit. 2016-04-19 12:24:29 +09: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 Show team and repo badges on README 2016-11-25 13:46:01 +01:00
babel.cfg Initial Cookiecutter Commit. 2016-04-19 12:24:29 +09:00
requirements.txt Introduce pip-check-reqs task to tox 2016-11-18 15:43:04 +09:00
setup.cfg Add migration and shell 2016-04-19 19:00:55 +09:00
setup.py Initial Cookiecutter Commit. 2016-04-19 12:24:29 +09:00
test-requirements.txt Introduce pip-check-reqs task to tox 2016-11-18 15:43:04 +09:00
tox.ini Introduce pip-check-reqs task to tox 2016-11-18 15:43:04 +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 on the command or 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 the command:

coverage2sql-db-manage --database-connection mysql://coverage:pass@127.0.0.1/coverage upgrade head

or 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.

Features

  • TODO: .coverage file through stdin