README.rst

RiveScript Coverage Plugin

A plug-in to measure code coverage in RiveScript with python

Features

The RiveScript Coverage Plugin is a plugin for Coverage.py which extends that package to measure code coverage for RiveScript files. It uses code analysis tools and debug hooks provided by the RiveScript interpreter to determine which lines are executable, and which have been executed. It supports CPython version 3.6 and above and plugs into Coverage.py version 5.0 and above. It requires RiveScript 1.14.9 or above.

Documentation is on Read The Docs. Code repository and issue tracker are on GitHub.

Getting Started

1. Use pip to install:

   $ pip install rivescript_coverage_plugin
   

2. Create or edit your .coveragerc file and add this:

   [run]
   plugins = rivescript_coverage_plugin
   

3. Run the coverage command or pytest with the --cov option and your RiveScript files will automatically be included in the coverage analysis and subsequent report generation.

Note that just like with Python coverage, RiveScript files that are not executed at all will not be part of your coverage report. To add them, use the source = . or other more specific source specifier in the [run] section of your .coveragerc file or the --source command line option. See the Coverage Documentation section "Specifying source files" for more information on this.