JavaScript tool created for helping in process of testing solidity smart contracts.
Short answer: it is a tool that helps you create ministro contract.
Now let's explain what Ministro contract is.
When you testing solidity contracts, you have a lot of repeated code like:
it('should do something', () => {
await instance.foo()
assert(foo)
}
it('should do something again', () => {
await instance.foo()
assert(foo)
}
Once you tested your foo() in one scenario, in most cases you not checking it
next time, you using foo() (in some other scenarios...) - and this is not good.
MinistroContract allows you to write test conditions once and use them
in each case scenario with just one line of code.
Thanks to this, your tests are very strong, easy to understand
and you have clean, short code.
The best way to understand how to use it, is to review the simple example in test directory.
Basically you need to create ministroContract that reflect all methods
that real smart contract has.
Each ministroContract must have all methods from smart contract (including public readers).
Each method must have all possible test you can perform base
ONLY (!) on input (arguments) and output (events, return values) data.
You also must cover scenario, when method throw (if this is a case).
When you do all that, you just execute a method on ministroContract
and ech time you do it in your tests scenarios, all this tests that you wrote
(in ministro method) will be executed and checked.
There are also some additional helpers mechanisms here like:
- checking is transaction was successful or throw
- read all events for transaction
Each ministro method must have:
- parameters that are equal to smart contract instance (required)
- object with transaction parameters (optional)
- parameter that inform us, if this execution is expected to throw (optional)
Please review the code of example test/ministro-contracts/ministroOwnable.js -
its pretty simple, so you should be able to understand how to use it.
Note: this test might not be enough for each cases, if some external data are present and ministro contract do not have access to them, you need to check them directly in test file (outside ministro).
DO NOT modify ministro by adding additional params to the method,
because this is not how it should work.
MinistroContract test should be the same for ALL cases and they should
work the same each time, so anybody can use it in any scenario
and not worry abut your special case.
git clone <this-repo>
git hf init
npm install
npm run lint
npm run test
After each release npm package should be updated.
To make it easy please remember to always update version is package.json :)
then you need just:
npm publish
In case of any issues, please refer to documentation.