TheDude
/
solidity-coverage
mirror of https://github.com/sc-forks/solidity-coverage
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Update README for 0.7.0 Release (#463)

Browse Source
pull/465/head
cgewecke 5 years ago committed by GitHub
parent 67a3a78854
commit 4980e2aa02
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 41 additions and 26 deletions
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Show Stats Download Patch File Download Diff File
  1. 45
      README.md
  2. 4
      docs/api.md
  3. 14
      docs/upgrade.md

45
README.md
Unescape View File

@ -1,9 +1,9 @@
# solidity-coverage # solidity-coverage
[![Gitter chat](https://badges.gitter.im/sc-forks/solidity-coverage.svg)][18] [![Gitter chat](https://badges.gitter.im/sc-forks/solidity-coverage.svg)][18]
![npm (tag)](https://img.shields.io/npm/v/solidity-coverage/beta) ![npm (tag)](https://img.shields.io/npm/v/solidity-coverage/master)
[![CircleCI](https://circleci.com/gh/sc-forks/solidity-coverage.svg?style=svg)][20] [![CircleCI](https://circleci.com/gh/sc-forks/solidity-coverage.svg?style=svg)][20]
[![codecov](https://codecov.io/gh/sc-forks/solidity-coverage/branch/beta/graph/badge.svg)][21] [![codecov](https://codecov.io/gh/sc-forks/solidity-coverage/branch/master/graph/badge.svg)][21]
[![buidler](https://buidler.dev/buidler-plugin-badge.svg?1)][26] [![buidler](https://buidler.dev/buidler-plugin-badge.svg?1)][26]
@ -16,9 +16,14 @@
## Install ## Install
``` ```
$ npm install --save-dev solidity-coverage@beta $ npm install --save-dev solidity-coverage
``` ```
**Resources**:
+ [0.7.0 release notes][31]
+ [A guide][29] to upgrading from 0.6.x to 0.7.x
+ [0.6.3 docs][30]
### Truffle V5 ### Truffle V5
**Add** this package to your plugins array in `truffle-config.js` ([Truffle docs][27]) **Add** this package to your plugins array in `truffle-config.js` ([Truffle docs][27])
@ -48,6 +53,12 @@ module.exports = {
npx buidler coverage [command-options] npx buidler coverage [command-options]
``` ```
**Buidler Project Examples:**
+ Simple: [buidler-metacoin][32]
+ More complex: [MolochDao/moloch][33]
## Usage notes: ## Usage notes:
+ Coverage runs tests a little more slowly. + Coverage runs tests a little more slowly.
+ Coverage launches its own in-process ganache server. + Coverage launches its own in-process ganache server.
@ -78,7 +89,6 @@ module.exports = {
}; };
``` ```
| Option <img width=200/>| Type <img width=200/> | Default <img width=1300/> | Description <img width=800/> | | Option <img width=200/>| Type <img width=200/> | Default <img width=1300/> | Description <img width=800/> |
| ------ | ---- | ------- | ----------- | | ------ | ---- | ------- | ----------- |
| silent | *Boolean* | false | Suppress logging output | | silent | *Boolean* | false | Suppress logging output |
@ -158,17 +168,17 @@ $ yarn
[1]: https://github.com/trufflesuite/ganache-core#options [1]: https://github.com/trufflesuite/ganache-core#options
[2]: https://istanbul.js.org/docs/advanced/alternative-reporters/ [2]: https://istanbul.js.org/docs/advanced/alternative-reporters/
[3]: https://mochajs.org/api/mocha [3]: https://mochajs.org/api/mocha
[4]: https://github.com/sc-forks/solidity-coverage/blob/beta/docs/faq.md#running-out-of-gas [4]: https://github.com/sc-forks/solidity-coverage/blob/master/docs/faq.md#running-out-of-gas
[5]: https://github.com/sc-forks/solidity-coverage/blob/beta/docs/faq.md#running-out-of-memory [5]: https://github.com/sc-forks/solidity-coverage/blob/master/docs/faq.md#running-out-of-memory
[6]: https://github.com/sc-forks/solidity-coverage/blob/beta/docs/faq.md#running-out-of-time [6]: https://github.com/sc-forks/solidity-coverage/blob/master/docs/faq.md#running-out-of-time
[7]: https://github.com/sc-forks/solidity-coverage/blob/beta/docs/faq.md#continuous-integration [7]: https://github.com/sc-forks/solidity-coverage/blob/master/docs/faq.md#continuous-integration
[8]: https://github.com/sc-forks/solidity-coverage/blob/beta/docs/faq.md#notes-on-branch-coverage [8]: https://github.com/sc-forks/solidity-coverage/blob/master/docs/faq.md#notes-on-branch-coverage
[9]: https://sc-forks.github.io/metacoin/ [9]: https://sc-forks.github.io/metacoin/
[10]: https://coveralls.io/github/OpenZeppelin/openzeppelin-solidity?branch=master [10]: https://coveralls.io/github/OpenZeppelin/openzeppelin-solidity?branch=master
[11]: https://github.com/sc-forks/solidity-coverage/tree/beta/test/units [11]: https://github.com/sc-forks/solidity-coverage/tree/master/test/units
[12]: https://github.com/sc-forks/solidity-coverage/issues [12]: https://github.com/sc-forks/solidity-coverage/issues
[13]: https://github.com/sc-forks/solidity-coverage/blob/beta/docs/faq.md#notes-on-gas-distortion [13]: https://github.com/sc-forks/solidity-coverage/blob/master/docs/faq.md#notes-on-gas-distortion
[14]: https://github.com/sc-forks/solidity-coverage/blob/beta/docs/advanced.md [14]: https://github.com/sc-forks/solidity-coverage/blob/master/docs/advanced.md
[15]: #config-options [15]: #config-options
[16]: https://blog.colony.io/code-coverage-for-solidity-eecfa88668c2 [16]: https://blog.colony.io/code-coverage-for-solidity-eecfa88668c2
[17]: https://github.com/JoinColony/solcover [17]: https://github.com/JoinColony/solcover
@ -177,9 +187,14 @@ $ yarn
[20]: https://circleci.com/gh/sc-forks/solidity-coverage [20]: https://circleci.com/gh/sc-forks/solidity-coverage
[21]: https://codecov.io/gh/sc-forks/solidity-coverage [21]: https://codecov.io/gh/sc-forks/solidity-coverage
[22]: https://cdn-images-1.medium.com/max/800/1*uum8t-31bUaa6dTRVVhj6w.png [22]: https://cdn-images-1.medium.com/max/800/1*uum8t-31bUaa6dTRVVhj6w.png
[23]: https://github.com/sc-forks/solidity-coverage/blob/beta/docs/advanced.md#workflow-hooks [23]: https://github.com/sc-forks/solidity-coverage/blob/master/docs/advanced.md#workflow-hooks
[24]: https://github.com/sc-forks/solidity-coverage/blob/beta/docs/advanced.md#skipping-tests [24]: https://github.com/sc-forks/solidity-coverage/blob/master/docs/advanced.md#skipping-tests
[25]: https://github.com/sc-forks/solidity-coverage/issues/417 [25]: https://github.com/sc-forks/solidity-coverage/issues/417
[26]: https://buidler.dev/ [26]: https://buidler.dev/
[27]: https://www.trufflesuite.com/docs [27]: https://www.trufflesuite.com/docs
[28]: https://github.com/sc-forks/solidity-coverage/blob/beta/docs/api.md [28]: https://github.com/sc-forks/solidity-coverage/blob/master/docs/api.md
[29]: https://github.com/sc-forks/solidity-coverage/blob/master/docs/upgrade.md#upgrading-from-06x-to-070
[30]: https://github.com/sc-forks/solidity-coverage/tree/0.6.x-final#solidity-coverage
[31]: https://github.com/sc-forks/solidity-coverage/releases/tag/v0.7.0
[32]: https://github.com/sc-forks/buidler-e2e/tree/coverage
[33]: https://github.com/sc-forks/moloch

4
docs/api.md
Unescape View File

@ -23,7 +23,7 @@ contracts.
+ there are two complete [coverage tool/plugin implementations][5] (for Buidler and Truffle) + there are two complete [coverage tool/plugin implementations][5] (for Buidler and Truffle)
which can be used as sources if you're building something similar. which can be used as sources if you're building something similar.
[5]: https://github.com/sc-forks/solidity-coverage/tree/beta/plugins [5]: https://github.com/sc-forks/solidity-coverage/tree/master/plugins
# Table of Contents # Table of Contents
@ -240,7 +240,7 @@ const solcoverJS = utils.loadSolcoverJS(config);
const api = new CoverageAPI(solcoverJS); const api = new CoverageAPI(solcoverJS);
``` ```
[7]: https://github.com/sc-forks/solidity-coverage/tree/beta#config-options [7]: https://github.com/sc-forks/solidity-coverage/tree/master#config-options
------------- -------------

14
docs/upgrade.md
Unescape View File

@ -2,7 +2,7 @@
**Install** **Install**
``` ```
$ npm install --save-dev solidity-coverage@beta $ npm install --save-dev solidity-coverage
``` ```
**Add** this package to your plugins array in `truffle-config.js` **Add** this package to your plugins array in `truffle-config.js`
@ -19,13 +19,13 @@ truffle run coverage [command-options]
A full list of options and other information are [available here][8] A full list of options and other information are [available here][8]
# Upgrading from 0.6.x to 0.7.0-beta.x # Upgrading from 0.6.x to 0.7.x
First, follow [the installation instructions](#how-to-install-070) and see if it works. First, follow [the installation instructions](#how-to-install-070) and see if it works.
:rabbit2: It does!? Bye. :rabbit2: It does!? Bye.
:elephant: It does not. Good... :elephant: It does not.
#### Are you using Truffle V5? #### Are you using Truffle V5?
@ -42,7 +42,7 @@ First, follow [the installation instructions](#how-to-install-070) and see if it
+ If the flags were `allowUnlimitedContractSize`, `gasLimit`, `gasPrice` or `emitFreeLogs`, + If the flags were `allowUnlimitedContractSize`, `gasLimit`, `gasPrice` or `emitFreeLogs`,
you can safely ignore them. Ditto if your port was `8555`. you can safely ignore them. Ditto if your port was `8555`.
+ If the flags were things like `accounts` or `network_id`, you'll need to transfer them as + If the flags were things like `--account` or `-i`, you'll need to transfer them as
[ganache-core options][1] to the `providerOptions` key in .solcover.js. [ganache-core options][1] to the `providerOptions` key in .solcover.js.
+ Ganache's "cli flag" and "js option" formats are slightly different. Check out [their docs][1] + Ganache's "cli flag" and "js option" formats are slightly different. Check out [their docs][1]
@ -128,11 +128,11 @@ First, follow [the installation instructions](#how-to-install-070) and see if it
[1]: https://github.com/trufflesuite/ganache-core#options [1]: https://github.com/trufflesuite/ganache-core#options
[2]: https://github.com/sc-forks/solidity-coverage/blob/beta/docs/advanced.md [2]: https://github.com/sc-forks/solidity-coverage/blob/master/docs/advanced.md
[3]: https://github.com/sc-forks/solidity-coverage/blob/beta/docs/advanced.md#workflow-hooks [3]: https://github.com/sc-forks/solidity-coverage/blob/master/docs/advanced.md#workflow-hooks
[4]: https://github.com/sc-forks/metacoin [4]: https://github.com/sc-forks/metacoin
[5]: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/1923 [5]: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/1923
[6]: https://github.com/JoinColony/colonyNetwork/pull/716 [6]: https://github.com/JoinColony/colonyNetwork/pull/716
[7]: https://github.com/aragon/aragon-court/pull/123 [7]: https://github.com/aragon/aragon-court/pull/123
[8]: https://github.com/sc-forks/solidity-coverage/tree/beta#command-options [8]: https://github.com/sc-forks/solidity-coverage/tree/master#command-options

Write Preview
Loading…
Cancel
Save