| Index: third_party/coverage-3.6/doc/source.rst
|
| diff --git a/third_party/coverage-3.6/doc/source.rst b/third_party/coverage-3.6/doc/source.rst
|
| deleted file mode 100644
|
| index aafb976cff2a518e5259832aa089d883b1abb1c6..0000000000000000000000000000000000000000
|
| --- a/third_party/coverage-3.6/doc/source.rst
|
| +++ /dev/null
|
| @@ -1,74 +0,0 @@
|
| -.. _source:
|
| -
|
| -=======================
|
| -Specifying source files
|
| -=======================
|
| -
|
| -:history: 20100725T172000, new in 3.4
|
| -
|
| -
|
| -When coverage.py is running your program and measuring its execution, it needs
|
| -to know what code to measure and what code not to. Measurement imposes a speed
|
| -penalty, and the collected data must be stored in memory and then on disk.
|
| -More importantly, when reviewing your coverage reports, you don't want to be
|
| -distracted with modules that aren't your concern.
|
| -
|
| -Coverage.py has a number of ways you can focus it in on the code you care
|
| -about.
|
| -
|
| -
|
| -.. _source_execution:
|
| -
|
| -Execution
|
| ----------
|
| -
|
| -When running your code, the ``coverage run`` command will by default measure
|
| -all code, unless it is part of the Python standard library.
|
| -
|
| -You can specify source to measure with the ``--source`` command-line switch,
|
| -or the ``[run] source`` configuration value. The value is a list of directories
|
| -or package names. If specified, only source inside these directories or
|
| -packages will be measured. Specifying the source option also enables
|
| -coverage.py to report on unexecuted files, since it can search the source tree
|
| -for files that haven't been measured at all.
|
| -
|
| -You can further fine-tune coverage.py's attention with the ``--include`` and
|
| -``--omit`` switches (or ``[run] include`` and ``[run] omit`` configuration
|
| -values). ``--include`` is a list of filename patterns. If specified, only files
|
| -matching those patterns will be measured. ``--omit`` is also a list of filename
|
| -patterns, specifying files not to measure. If both ``include`` and ``omit``
|
| -are specified, first the set of files is reduced to only those that match the
|
| -include patterns, then any files that match the omit pattern are removed from
|
| -the set.
|
| -
|
| -The ``include`` and ``omit`` filename patterns follow typical shell syntax:
|
| -``*`` matches any number of characters and ``?`` matches a single character.
|
| -Patterns that start with a wildcard character are used as-is, other patterns
|
| -are interpreted relative to the current directory.
|
| -
|
| -The ``source``, ``include``, and ``omit`` values all work together to determine
|
| -the source that will be measured.
|
| -
|
| -
|
| -.. _source_reporting:
|
| -
|
| -Reporting
|
| ----------
|
| -
|
| -Once your program is measured, you can specify the source files you want
|
| -reported. Usually you want to see all the code that was measured, but if you
|
| -are measuring a large project, you may want to get reports for just certain
|
| -parts.
|
| -
|
| -The report commands (``report``, ``html``, ``annotate``, and ``xml``) all take
|
| -optional ``modules`` arguments, and ``--include`` and ``--omit`` switches. The
|
| -``modules`` arguments specify particular modules to report on. The ``include``
|
| -and ``omit`` values are lists of filename patterns, just as with the ``run``
|
| -command.
|
| -
|
| -Remember that the reporting commands can only report on the data that has been
|
| -collected, so the data you're looking for may not be in the data available for
|
| -reporting.
|
| -
|
| -Note that these are ways of specifying files to measure. You can also exclude
|
| -individual source lines. See :ref:`excluding` for details.
|
|
|