This package contains a tool to verify and add contracts in FlatCurry programs by proving contracts with an SMT solver. If a proof is successful, no contract check will be performed at run time, otherwise a dynamic (strict) contract check will be added. The static verification of contracts has the advantage that the resulting program will run more efficiently compared to a program with dynamic contract checking only/
A detailed description of the ideas of this tool can be found in the LOPSTR 2017 paper.
The tool is invoked via
> curry-contracts <Curry module>This analyzes the FlatCurry code of the module, attempts to prove the contracts in this module (unless option --add is set), and adds dynamic contract checking if a proof is not successful. Finally, the FlatCurry program is replaced by the transformed version (unless option --target=NONE is set). Hence, this tool might be integrated into the compilation chain of a Curry system. In addition to the transformation of the FlatCurry program, successful proofs will be stored in files so that they can be re-used by other tools. For instance, if the postcondition of an operation f defined in module M is verified, a file PROOF_M_f_SatisfiesPostCondition.smt is generated. This file contains the SMT script of this proof.
The directory examples contains various examples where the contract prover can eliminate all contracts at compile time.
In contrast to the first contract prover described in LOPSTR 2017 paper, which tried to remove contracts added by the Curry preprocessor, this version tries to verify contracts before they are added to the Curry program and adds dynamic checks only for unverified contracts (see the auxiliary operations defined in include/ContractChecker.curry).
The strategy is as follows:
For each postcondition f'post, try to verify it. If this is not successful, a dynamic check is added to f.
For each function call (f args), where a preconditon f'pre exists, try to verify this precondition in the given context of the call. If it cannot be verified, transform the function call into
checkPreCond (f args) (f'pre args) "f" (args)
See include/ContractChecker.curry for the definition of checkPreCond.
Contracts can also be stored in separate files. When checking a module m, if there is a Curry module m_SPEC in the load path for module m or in the package directory include, the contents of m_SPEC is added to m before it is checked.
Contracts for operators can also be specified by operations named by op_xh1...hn', where each hi is a two digit hexadecimal number and the name of the operator corresponds to the ord values of h1...hn. For instance, a precondition for the operator !! can be named op_x2121'pre. To generate such names automatically, one can use the option --name of the tool.
examples: some examples (and test suite)
include: an include file for the SMT solver and a small Curry program containing operations which perform dynamic contract checking for unverified contracts
src: source code of the implementation