logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

cobertura-instrument — add coverage instrumentation to existing classes

Author

       This manual page was written by Miguel Landaeta <miguel@miguel.cc> for the Debian system (but may be used
       by others).  Permission is granted to copy, distribute and/or modify this document under the terms of the
       terms  of  GNU  General  Public  License,  Version  2 or any later version published by the Free Software
       Foundation.

       On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-
       licenses/GPL.

                                                                                         COBERTURA-INSTRUMENT(1)

Description

cobertura-instrument inserts instrumentation instructions directly into your compiled Java classes.  When
       these  instructions  are  encountered  by  the Java Virtual Machine, the inserted code increments various
       counters so that it is possible to tell which instructions have been encountered and which have not.

Name

       cobertura-instrument — add coverage instrumentation to existing classes

Options

       Classes may be specified individually, or as a directory tree containing multiple classes.

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

       --datafilefile
                 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. Default value:
                 "./cobertura.ser".

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

       --ignoreregex
                 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 <ignore/> statements as you
                 want. By default no files are ignored.

       --auxClasspath
                 Add any classes/jars that cobertura is unable to find during instrumentation.

See Also

junit(1), cobertura-check(1), cobertura-report(1), cobertura-merge(1).

Synopsis

cobertura-instrument  [--basedirdir]  [--datafilefile]  [--destinationdir]  [--ignoreregex]  classes
       [...]

See Also