nile-coverage 0.1.0b12

Nile plugin adding coverage reports for Cairo Smart Contracts.

nile-coverage

Nile plugin adding coverage reports for Cairo Smart Contracts.

Getting started

:warning: WARNING

This package requires cairo-lang >= 0.10.1. If you are using older versions, check this section before continuing.

Install the plugin inside the virtual environment of your Nile project:

(env): pip install nile-coverage

Nile automatically detecs installed plugins using python entry points feature. You should see the coverage command listed running nile, and you can run the report with:

(env): nile coverage

For a full list of options run:

(env): nile coverage --help

Troubleshooting

1. Getting Nothing to report after tests have been run successfully.

This project requires Starknet >= 0.10.1. If you are using Starknet 0.10.0, check this guide.

2. Report doesn't catch execution when multiple threads are used with pytest-xdist.

In order to solve this, pass the --single-thread option to the coverage command:

(env): nile coverage -s

3. How to run the coverage in a subset of the tests suite.

Mark tests in with pytest marks and use the --mark argument to run a subset of tests:

(env): nile coverage -m unit