Skip to main content

Generate continuous testing report

Project description

madge

Last version Build Status Python Version Coverage Downloads

conport

conport is an Python tool for generating continuous regression testing reports. It supports both HTML report and email report. In each report, testing build trend, testing build metrics and test case summary are demonstrated. Both English report and Chinese report are supported. Check the demo as an example.

公众号文章

How to install

Use pip to install:

pip install conport

You can also clone the repo, and inside the directory, run:

python setup.py develop

note: when install conport, all denpendent libs specified in requirements.txt will be automatically installed. Due to the requirement of dependency matplotlib, you may need to install Linux library python-tk if necessary. In ubuntu, you can run command apt install python-tk to install it.

How to use

After install conport successfully, shell command conport will be avaiable.

Check version of conport:

conport --version

Get help of conport:

comport -h

Available arguments can be found from help command output:

usage: conport [-h] [--job_url JOB_URL] [--report_title REPORT_TITLE]
               [--past_hours PAST_HOURS] [--send_email SEND_EMAIL]
               [--mail_host MAIL_HOST] [--mail_user MAIL_USER]
               [--mail_pwd MAIL_PWD] [--sender SENDER] [--receivers RECEIVERS]
               [--receivers_cc RECEIVERS_CC] [--pure_html PURE_HTML]
               [--version]

optional arguments:
  -h, --help            show this help message and exit
  --job_url JOB_URL     Jenkins job url
  --report_title REPORT_TITLE
                        continuous testing report title
  --past_hours PAST_HOURS
                        number of past hours to be monitored
  --send_email SEND_EMAIL
                        whether to send email or not
  --mail_host MAIL_HOST
                        email host
  --mail_user MAIL_USER
                        email user
  --mail_pwd MAIL_PWD   email password
  --sender SENDER       email sender
  --receivers RECEIVERS
                        email receivers, format is receiver1, receiver2, ...
  --receivers_cc RECEIVERS_CC
                        email receivers cc, format is receivercc1,
                        receivercc2, ...
  --pure_html PURE_HTML
                        pure html or not
  --report_lan REPORT_LAN
                        report langurage, english or chinese, default is
                        english
  --version             print version

The arguments, if not speficied, will be fetched from the default configuration file. Anyway, for your specific configuration, these arguments needs to be given.

note: parameter pure_html is needed because email cannot support HTML5 figure. In that case, conport create figure by using matplotlib and then embed that figure into email message with email.MIMEImage.

demo

The following demo picture is created from command:

conport --job_url http://test-jenkins:8080/job/demo-job-conport --past_hours 8 --report_title "Here is regression testing report for demo usage of conport" --pure_html false --send_email true

You can obtain some key information from the picture:

  • Tetsing build trend
  • Testing build metrics
  • Test case summary, with a focus on failed cases statistics

English demo

demo

Chinese demo(中文示例) demo

How to develop

First install tox with:

pip install tox

Run UT and coverage:

python -m pytest -vv -s --cov=conport --cov-report term --cov-report html

Run tox:

tox -e test

Local install and test:

python setup.py develop

Lisense

MIT

Maintenance

This tool is developed by slxiao. You are welcome to raise any issues about the tool.

Project details


Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

conport-1.1.8-py3-none-any.whl (13.7 kB view details)

Uploaded Python 3

conport-1.1.8-py2-none-any.whl (13.7 kB view details)

Uploaded Python 2

File details

Details for the file conport-1.1.8-py3-none-any.whl.

File metadata

  • Download URL: conport-1.1.8-py3-none-any.whl
  • Upload date:
  • Size: 13.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.4.2 requests/2.11.1 setuptools/41.0.1 requests-toolbelt/0.8.0 tqdm/4.26.0 CPython/2.7.12

File hashes

Hashes for conport-1.1.8-py3-none-any.whl
Algorithm Hash digest
SHA256 971f34d7e7f0f71f343b0a835e8d10e0ea9ef8e675089d623137693913128920
MD5 4854de966c6a3bd5fcd3e375c78b1421
BLAKE2b-256 0a6210567c52ecf049743515a8973856d1b65484098d7ee0988695ebf0fd508f

See more details on using hashes here.

File details

Details for the file conport-1.1.8-py2-none-any.whl.

File metadata

  • Download URL: conport-1.1.8-py2-none-any.whl
  • Upload date:
  • Size: 13.7 kB
  • Tags: Python 2
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.4.2 requests/2.11.1 setuptools/41.0.1 requests-toolbelt/0.8.0 tqdm/4.26.0 CPython/2.7.12

File hashes

Hashes for conport-1.1.8-py2-none-any.whl
Algorithm Hash digest
SHA256 39576ae8112c1e465394c24a53c52f08e64dee59e74284991bbcbdaeede5a810
MD5 3c59f4a9511f87ac328cf679a7c9bef1
BLAKE2b-256 694fb19d805a4176372e02922a21596cc6bdc095472ce21b3803bf016b5d5e60

See more details on using hashes here.

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