README.md
1Boost.Contract
2==============
3
4Contract programming for C++.
5All contract programming features are supported: Subcontracting, class invariants (also static and volatile), postconditions (with old and return values), preconditions, customizable actions on assertion failure (e.g., terminate or throw), optional compilation and checking of assertions, disable assertions while already checking other assertions (to avoid infinite recursion), etc.
6
7### License
8
9Distributed under the [Boost Software License, Version 1.0](http://www.boost.org/LICENSE_1_0.txt).
10
11### Properties
12
13* C++11 (C++03 possible but not recommended without lambda functions and variadic macros, see documentation for more information).
14* Shared Library / DLL with `BOOST_CONTRACT_DYN_LINK` (static library with `BOOST_CONTRACT_STATIC_LINK`, header-only also possible but not recommended, see `BOOST_CONTRACT_HEADER_ONLY` documentation for more information).
15
16### Build Status
17
18Branch | Travis | Appveyor | Coverity Scan | codecov.io | Deps | Docs | Tests |
19:-------------: | ------ | -------- | ------------- | ---------- | ---- | ---- | ----- |
20[`master`](https://github.com/boostorg/contract/tree/master) | [](https://travis-ci.com/boostorg/contract) | [](https://ci.appveyor.com/project/lcaminiti/contract/branch/master) | [](https://scan.coverity.com/projects/boostorg-contract) | [](https://codecov.io/gh/boostorg/contract/branch/master)| [](https://pdimov.github.io/boostdep-report/master/contract.html) | [](https://www.boost.org/doc/libs/master/libs/contract/doc/html/index.html) | [](http://www.boost.org/development/tests/master/developer/contract.html)
21[`develop`](https://github.com/boostorg/contract/tree/develop) | [](https://travis-ci.com/boostorg/contract) | [](https://ci.appveyor.com/project/lcaminiti/contract/branch/develop) | [](https://scan.coverity.com/projects/boostorg-contract) | [](https://codecov.io/gh/boostorg/contract/branch/develop) | [](https://pdimov.github.io/boostdep-report/develop/contract.html) | [](https://www.boost.org/doc/libs/develop/libs/contract/doc/html/index.html) | [](http://www.boost.org/development/tests/develop/developer/contract.html)
22
23### Directories
24
25| Name | Purpose |
26| ----------- | ------------------------------ |
27| `build` | Build |
28| `doc` | Documentation |
29| `example` | Examples |
30| `include` | Header code |
31| `meta` | Integration with Boost |
32| `src` | Source code |
33| `test` | Unit tests |
34
35### More Information
36
37* [Ask questions](http://stackoverflow.com/questions/ask?tags=c%2B%2B,boost,boost-contract).
38* [Report bugs](https://github.com/boostorg/contract/issues): Be sure to mention Boost version, platform and compiler you are using. A small compilable code sample to reproduce the problem is always good as well.
39* Submit your patches as pull requests against **develop** branch. Note that by submitting patches you agree to license your modifications under the [Boost Software License, Version 1.0](http://www.boost.org/LICENSE_1_0.txt).
40* Discussions about the library are held on the [Boost developers mailing list](http://www.boost.org/community/groups.html#main). Be sure to read the [discussion policy](http://www.boost.org/community/policy.html) before posting and add the `[contract]` text at the beginning of the subject line.
41
42
){kind=link}
){kind=link}
){kind=link}
){kind=link}
){kind=link}
){kind=link}
){kind=link}
){kind=link}
){kind=link}
){kind=link}
){kind=link}