solidity-coverage

Code coverage for Solidity testing

For more details about what this is, how it works and potential limitations, see the accompanying article.
solidity-coverage is in development and its accuracy is unknown. If you find discrepancies between the coverage report and your suite's behavior, please open an issue.
solidity-coverage is Solcover

Install

$ npm install --save-dev solidity-coverage

Usage notes:

For pragma solidity >=0.4.22 <0.6.0 / Petersburg
Tests run more slowly while coverage is being generated.
Contracts consume more gas while coverage is being generated.
solidity-coverage launches its own in-process ganache instance. You can set its options via the providerOptions key in your .solcover.js config file.

Truffle >= V5: setup and run

Add "solidity-coverage" to your plugins array in truffle-config.js

module.exports = {
  networks: {...},
  plugins: ["solidity-coverage"]
}

Run

truffle run coverage [options]

Command Options

Option	Example	Description
--file	--file="test/registry/*.js"	Filename or glob describing a subset of JS tests to run. (Globs must be enclosed by quotes.)
--solcoverjs	--solcoverjs ./../.solcover.js	Relative path from working directory to config. Useful for monorepo packages that share settings. (Path must be "./" prefixed)
--version		Version info
--help		Usage notes

Config Options

Additional options can be specified in a .solcover.js config file located in the root directory of your project.

Example:

module.exports = {
  skipFiles: ['Routers/EtherRouter.sol']
};

Option	Type	Default	Description
client	Object	require("truffle").ganache	Useful if you need a specific ganache version. (usage: `client: require("ganache-core")`)
providerOptions	Object	{}	ganache-core options (ex: `network_id: 55`). Complete list of options here.
skipFiles	Array	`['Migrations.sol']`	Array of contracts or folders (with paths expressed relative to the `contracts` directory) that should be skipped when doing instrumentation. `Migrations.sol` is skipped by default, and does not need to be added to this configuration option if it is used.
istanbulReporter	Array	['html', 'lcov', 'text']	Coverage reporters for Istanbul. Optional reporter replaces the default reporters.

FAQ

Common problems & questions:

Example reports

metacoin (Istanbul HTML)
openzeppelin-solidity (Coveralls)

Contribution Guidelines

Contributions are welcome! If you're opening a PR that adds features please consider writing some unit tests for them. Bugs can be reported in the issues.

Set up the development environment with:

$ git clone https://github.com/sc-forks/solidity-coverage.git
$ yarn

6.3 KiB Raw Blame History