| CARVIEW |
Select Language
HTTP/2 200
date: Sun, 27 Jul 2025 02:36:43 GMT
content-type: text/html; charset=utf-8
vary: X-PJAX, X-PJAX-Container, Turbo-Visit, Turbo-Frame, X-Requested-With,Accept-Encoding, Accept, X-Requested-With
x-robots-tag: none
etag: W/"b451af5cf501dfaf6f899b6503c8421e"
cache-control: max-age=0, private, must-revalidate
strict-transport-security: max-age=31536000; includeSubdomains; preload
x-frame-options: deny
x-content-type-options: nosniff
x-xss-protection: 0
referrer-policy: no-referrer-when-downgrade
content-security-policy: default-src 'none'; base-uri 'self'; child-src github.githubassets.com github.com/assets-cdn/worker/ github.com/assets/ gist.github.com/assets-cdn/worker/; connect-src 'self' uploads.github.com www.githubstatus.com collector.github.com raw.githubusercontent.com api.github.com github-cloud.s3.amazonaws.com github-production-repository-file-5c1aeb.s3.amazonaws.com github-production-upload-manifest-file-7fdce7.s3.amazonaws.com github-production-user-asset-6210df.s3.amazonaws.com *.rel.tunnels.api.visualstudio.com wss://*.rel.tunnels.api.visualstudio.com objects-origin.githubusercontent.com copilot-proxy.githubusercontent.com proxy.individual.githubcopilot.com proxy.business.githubcopilot.com proxy.enterprise.githubcopilot.com *.actions.githubusercontent.com wss://*.actions.githubusercontent.com productionresultssa0.blob.core.windows.net/ productionresultssa1.blob.core.windows.net/ productionresultssa2.blob.core.windows.net/ productionresultssa3.blob.core.windows.net/ productionresultssa4.blob.core.windows.net/ productionresultssa5.blob.core.windows.net/ productionresultssa6.blob.core.windows.net/ productionresultssa7.blob.core.windows.net/ productionresultssa8.blob.core.windows.net/ productionresultssa9.blob.core.windows.net/ productionresultssa10.blob.core.windows.net/ productionresultssa11.blob.core.windows.net/ productionresultssa12.blob.core.windows.net/ productionresultssa13.blob.core.windows.net/ productionresultssa14.blob.core.windows.net/ productionresultssa15.blob.core.windows.net/ productionresultssa16.blob.core.windows.net/ productionresultssa17.blob.core.windows.net/ productionresultssa18.blob.core.windows.net/ productionresultssa19.blob.core.windows.net/ github-production-repository-image-32fea6.s3.amazonaws.com github-production-release-asset-2e65be.s3.amazonaws.com insights.github.com wss://alive.github.com api.githubcopilot.com api.individual.githubcopilot.com api.business.githubcopilot.com api.enterprise.githubcopilot.com; font-src github.githubassets.com; form-action 'self' github.com gist.github.com copilot-workspace.githubnext.com objects-origin.githubusercontent.com; frame-ancestors 'none'; frame-src viewscreen.githubusercontent.com notebooks.githubusercontent.com; img-src 'self' data: blob: github.githubassets.com media.githubusercontent.com camo.githubusercontent.com identicons.github.com avatars.githubusercontent.com private-avatars.githubusercontent.com github-cloud.s3.amazonaws.com objects.githubusercontent.com release-assets.githubusercontent.com secured-user-images.githubusercontent.com/ user-images.githubusercontent.com/ private-user-images.githubusercontent.com opengraph.githubassets.com copilotprodattachments.blob.core.windows.net/github-production-copilot-attachments/ github-production-user-asset-6210df.s3.amazonaws.com customer-stories-feed.github.com spotlights-feed.github.com objects-origin.githubusercontent.com *.githubusercontent.com; manifest-src 'self'; media-src github.com user-images.githubusercontent.com/ secured-user-images.githubusercontent.com/ private-user-images.githubusercontent.com github-production-user-asset-6210df.s3.amazonaws.com gist.github.com; script-src github.githubassets.com; style-src 'unsafe-inline' github.githubassets.com; upgrade-insecure-requests; worker-src github.githubassets.com github.com/assets-cdn/worker/ github.com/assets/ gist.github.com/assets-cdn/worker/
server: github.com
content-encoding: gzip
accept-ranges: bytes
set-cookie: _gh_sess=p%2FLscIMdyivbyVX8S488LS4mlKc4Kg8dCc0%2BS7kwhv1dbD6mguZ%2BGoV1gnVxFKfSFPjHReggpSc7adMAfvVgujLnLj7eZF%2BaqGGiEAk1QGPt79LM46v5rVB57VVykkAsWwI87t7sbNjD6FdqqRa7mA4U%2BG8GFke1KMZ8TC%2FDO%2FcT%2B9lisCdzy1iD6YL0GUrpUBM3M8QZpLXKXQa9AmYEtMsxCscFozdbOFW3E2ZISCa2NCQbEkgDh7Mg1ygx7DICcFECfa%2FuhFPIsdBZ85roLg%3D%3D--549KMy1KMMC2pgeV--DhjJMEp9plhu9bT8SsXaMQ%3D%3D; Path=/; HttpOnly; Secure; SameSite=Lax
set-cookie: _octo=GH1.1.1476612928.1753583803; Path=/; Domain=github.com; Expires=Mon, 27 Jul 2026 02:36:43 GMT; Secure; SameSite=Lax
set-cookie: logged_in=no; Path=/; Domain=github.com; Expires=Mon, 27 Jul 2026 02:36:43 GMT; HttpOnly; Secure; SameSite=Lax
x-github-request-id: BD02:E3CB6:51F866:6EBF71:688590BB
Command Line Reference · cobertura/cobertura Wiki · GitHub
Skip to content
Navigation Menu
{{ message }}
forked from christ66/cobertura
-
Notifications
You must be signed in to change notification settings - Fork 277
Command Line Reference
Steven Christou edited this page Jul 26, 2013
·
2 revisions
Cobertura can be used either from the command line or via ant tasks. You can even mix and match the command line and ant tasks. This document describes how to use Cobertura from the command line.
cobertura-instrument.bat [--basedir dir] [--datafile file] [--auxClasspath classPath] [--destination dir] [--ignore regex] classes [...]Note: Classes may be specified individually, or as a directory tree containing multiple classes.
| Parameter | Required? | Description | Default Value |
|---|---|---|---|
| --basedir | No | Specify the base directory containing the classes you want to instrument. This command line parameter should appear before any classes. If you are instrumenting classes in different directories, you should specify multiple basedirs. | No default value. |
| --datafile | No | Specify the name of the file to use for storing the metadata about your classes. This is a single file containing serialized Java classes. It contains information about the names of classes in your project, their method names, line numbers, etc. It will be updated as your tests are run, and will be referenced by the Cobertura reporting command. | "cobertura.ser" in the current directory |
| --destination | No | Specify the output directory for the instrumented classes. | If no destination directory is specified, then the uninstrumented classes will be overwritten with their instrumented counterparts. |
| --ignore | No | Specify a regular expression to filter out certain lines of your source code. This is useful for ignoring logging statements, for example. You can have as many statements as you want. | No files are ignored. |
| --auxClasspath | No | Add any classes/jars that cobertura is unable to find during instrumentation. | No default value. |
Example:
cobertura-instrument.bat --destination C:\MyProject\build\instrumented C:\MyProject\build\classes
You can basically run your tests the same way you always do. The only changes you need to make are to your classpath:
- Include cobertura.jar
- Add the directory containing the instrumented classes BEFORE the directory containing the uninstrumented classes. The order is very important. Your tests do not have to be JUnit tests. They don't even have to be automated. If your application is a program with a GUI, you could fire it up, perform a few actions, then exit. Cobertura updates its data file whenever your instrumented classes are accessed.
Example:
java -cp C:\cobertura\lib\cobertura.jar;C:\MyProject\build\instrumented;C:\MyProject\build\classes;C:\MyProject\build\test-classes -Dnet.sourceforge.cobertura.datafile=C:\MyProject\build\cobertura.ser ASimpleTestCase
cobertura-report.bat [--datafile file] [--destination dir] [--format (html|xml)] [--encoding encoding] source code directory [...] [--basedir dir file underneath basedir ...]| Parameter | Required? | Description | Default Value |
|---|---|---|---|
| --basedir | No | Specify a directory containing source code. All files listed after this are assumed to be underneath this directory. This should only be used if you want to include only a few specific files underneath a source tree and exclude all other files. | No default value. |
| --datafile | No | Specify the name of the file containing metadata about your classes. | "cobertura.ser" in the current directory |
| --destination | Yes | Specify the output directory for the report. | No default value. |
| --format | No | The type of report you want to generate. | html |
| --encoding | No | Specify the encoding used to read the source. See javadocs for java.nio.charset.Charset for more details. Since 1.9.1. | The default encoding. |
The source code directories are used to calculate the cyclomatic code complexity of each class. The HTML reports are also made of annotated versions of each source file, showing which lines of code were exercised.
Example:
cobertura-report.bat --format html --datafile C:\MyProject\build\cobertura.ser --destination C:\MyProject\reports\coverage C:\MyProject\src
cobertura-check.bat [--datafile file] [--branch 0..100] [--line 0..100] [--totalbranch 0..100] [--totalline 0..100] [--regex regex:branchrate:linerate]This can be run after your JUnit tests to show which classes do not have adequate test coverage. Note: If no parameters are specified then all values will be set to 50%
| Parameter | Required? | Description | Default Value |
|---|---|---|---|
| --branch | No | Specify the minimum acceptable branch coverage rate needed by each class. This should be an integer value between 0 and 100. | 0 |
| --datafile | No | Specify the name of the file containing metadata about your classes. | "cobertura.ser" in the current directory |
| --line | No | Specify the minimum acceptable line coverage rate needed by each class. This should be an integer value between 0 and 100. | 0 |
| --regex | No | For finer grained control, you can optionally specify minimum branch and line coverage rates for individual classes using any number of regular expressions. | None. |
| --packagebranch | No | Specify the minimum acceptable average branch coverage rate needed by each package. This should be an integer value between 0 and 100. | 0 |
| --packageline | No | Specify the minimum acceptable average line coverage rate needed by each package. This should be an integer value between 0 and 100. | 0 |
| --totalbranch | No | Specify the minimum acceptable average branch coverage rate needed by the project as a whole. This should be an integer value between 0 and 100. | 0 |
| --totalline | No | Specify the minimum acceptable average line coverage rate needed by the project as a whole. This should be an integer value between 0 and 100. | 0 |
Example:
cobertura-check.bat --datafile C:\MyProject\build\cobertura.ser --branch 50 --totalline 70 --regex com.example.rabidsquirrel.*:65:65
The above example specifies that each class must have a branch coverage rate of 50 or higher, the average line coverage rate for the entire project must be 70 or higher, and any classes in the package com.example.rabidsquirrel must have a line coverage and a branch coverage of 65 or greater.
cobertura-merge.bat [--datafile file] datafile [...]This can be run after your JUnit tests to merge multiple data files into a single data file.
| Parameter | Required? | Description | Default Value |
|---|---|---|---|
| --datafile | No | Specify the name of the file containing metadata about your classes. This is the "destination" file into which the contents of the other data files will be merged. | "cobertura.ser" in the current directory |
Example:
cobertura-merge.bat --datafile C:\MyProject\build\cobertura.ser C:\MyProject\testrundir\server\cobertura.ser C:\MyProject\testrundir\client\cobertura.ser
The above example merges a 'cobertura.ser' file from a server process and from a client process into one combined file in the build directory. You can then use cobertura-report to create a report based on this new data file.
You can’t perform that action at this time.