Code coverage for Solidity smart-contracts

cgewecke 3ce4c053bd Add --version cli flag		5 years ago
.circleci	Show test output in CI	5 years ago
dist	Add --version cli flag	5 years ago
docs	Remove send/transfer warnings in README & docs	5 years ago
lib	Add --version cli flag	5 years ago
scripts	Comment out zeppelin E2E coveralls call	5 years ago
test	Add --version cli flag	5 years ago
.gitignore	Fix circle/ci	5 years ago
.npmignore	Initial draft: 0.7.0	5 years ago
CHANGELOG.md	Update changelog: 0.6.7	5 years ago
LICENSE	Add MIT License	8 years ago
README.md	Add --version cli flag	5 years ago
buidler.config.js	Initial draft: 0.7.0	5 years ago
index.js	Add index.js stub	5 years ago
package.json	Add UI reporter class (#389 )	5 years ago
truffle-plugin.json	Truffle plugin draft	5 years ago
yarn.lock	Add UI reporter class (#389 )	5 years ago

README.md

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