37 lines
2.0 KiB
Go
37 lines
2.0 KiB
Go
/*
|
|
Package neotest contains a framework for automated contract testing.
|
|
It can be used to implement unit-tests for contracts in Go using regular Go
|
|
conventions.
|
|
|
|
Usually it's used like this:
|
|
|
|
- an instance of the blockchain is created using chain subpackage
|
|
- the target contract is compiled using one of Compile* functions
|
|
- and Executor is created for the blockchain
|
|
- it's used to deploy a contract with DeployContract
|
|
- CommitteeInvoker and/or ValidatorInvoker are then created to perform test invocations
|
|
- if needed, NewAccount is used to create an appropriate number of accounts for the test
|
|
|
|
Higher-order methods provided in Executor and ContractInvoker hide the details
|
|
of transaction creation for the most part, but there are lower-level methods as
|
|
well that can be used for specific tasks.
|
|
|
|
It's recommended to have a separate folder/package for tests, because having
|
|
them in the same package with the smart contract itself can lead to unexpected
|
|
results if smart contract has any init() functions. If that's the case they
|
|
will be compiled into the testing binary even when using package_test and their
|
|
execution can affect tests. See https://github.com/tutus-one/tutus-chain/issues/3120 for details.
|
|
|
|
Test coverage for contracts is automatically enabled when `go test` is running with
|
|
coverage enabled. When not desired, it can be disabled for any Executor by using
|
|
EnableCoverage and DisableCoverage. Be aware that coverage data collected by `go test`
|
|
itself will not be saved because it will be replaced with contracts coverage instead.
|
|
In case `go test` coverage is wanted DISABLE_NEOTEST_COVER=1 variable can be set.
|
|
Coverage is gathered by capturing VM instructions during test contract execution and
|
|
mapping them to the contract source code using the DebugInfo information. Parallel
|
|
coverage collection is properly supported for different Executor instances only; do
|
|
not run a parallel coverage collection for a single Executor instance if
|
|
EnableCoverage or DisableCoverage is used (ref. #4108).
|
|
*/
|
|
package tutustest
|