Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://banditcpp.github.io/bandit/
Human-friendly unit testing for C++11
https://banditcpp.github.io/bandit/
bdd behavior-driven-development c-plus-plus c-plus-plus-11 cpp cpp-library cpp11 header-only library tdd test-driven-development test-framework testing testing-framework testing-library
Last synced: 28 days ago
JSON representation
Human-friendly unit testing for C++11
- Host: GitHub
- URL: https://banditcpp.github.io/bandit/
- Owner: banditcpp
- License: other
- Created: 2013-07-23T08:58:22.000Z (over 11 years ago)
- Default Branch: main
- Last Pushed: 2024-02-04T14:03:43.000Z (10 months ago)
- Last Synced: 2024-11-11T00:02:30.829Z (about 1 month ago)
- Topics: bdd, behavior-driven-development, c-plus-plus, c-plus-plus-11, cpp, cpp-library, cpp11, header-only, library, tdd, test-driven-development, test-framework, testing, testing-framework, testing-library
- Language: C++
- Homepage: https://banditcpp.github.io/bandit/
- Size: 4.91 MB
- Stars: 260
- Watchers: 24
- Forks: 37
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-cpp-testing - Bandit - A header-only framework for C++11 that wants to make working with unit tests a pleasant experience. (Testing Frameworks)
README
bandit
======
[](LICENSE.txt)
[](https://github.com/banditcpp/bandit/graphs/contributors)
[](https://github.com/banditcpp/bandit/watchers)
[](https://github.com/banditcpp/bandit/stargazers)
[](https://github.com/banditcpp/bandit/network/members)
[](https://github.com/banditcpp/bandit/graphs/code-frequency)
[](https://github.com/banditcpp/bandit/commits/master)
[](https://travis-ci.org/banditcpp/bandit)
[](https://ci.appveyor.com/project/banditcpp/bandit)
[](https://codecov.io/gh/banditcpp/bandit)
[](https://www.codacy.com/app/sbeyer/bandit?utm_source=github.com&utm_medium=referral&utm_content=banditcpp/bandit&utm_campaign=Badge_Grade)
[](https://scan.coverity.com/projects/banditcpp-bandit)
[](https://github.com/banditcpp/bandit/issues)
[](https://github.com/banditcpp/bandit/pulls)
[](//webchat.freenode.net/?channels=%23banditcpp)
[](https://conan.io/center/recipes/bandit)
Human-friendly unit testing for C++11
Bandit is a framework for C++11 that wants to make working with unit tests a
pleasant experience.
## An example
This is a complete test application written in bandit:
```c++
#include
using namespace snowhouse;
using namespace bandit;
// Tell bandit there are tests here.
go_bandit([]() {
// We're describing how a fuzzbox works.
describe("fuzzbox", []() {
guitar_ptr guitar;
fuzzbox_ptr fuzzbox;
// Make sure each test has a fresh setup with
// a guitar with a fuzzbox connected to it.
before_each([&]() {
guitar = guitar_ptr(new struct guitar());
fuzzbox = fuzzbox_ptr(new struct fuzzbox());
guitar->add_effect(fuzzbox.get());
});
it("starts in clean mode", [&]() {
AssertThat(guitar->sound(), Equals(sounds::clean));
});
// Describe what happens when we turn on the fuzzbox.
describe("in distorted mode", [&]() {
// Turn on the fuzzbox.
before_each([&]() {
fuzzbox->flip();
});
it("sounds distorted", [&]() {
AssertThat(guitar->sound(), Equals(sounds::distorted));
});
});
});
});
int main(int argc, char* argv[]) {
// Run the tests.
return bandit::run(argc, argv);
}
```
## Download
Clone the Git repository:
```sh
git clone --recursive https://github.com/banditcpp/bandit.git
```
or if you have already cloned the repository without `--recursive`, do
```sh
cd bandit
git submodule update --init --recursive
```
The Git repository contains several directories besides bandit itself,
that is, the specifications (or tests) for bandit (in `specs`),
the bandit website and documentation (in `docs`),
and auxiliary tools for CMake (in `cmake`) and continuous integration (in `util`).
## Installation
Bandit is header-only, so there is no need for additional compilation before you
can start using it. (CMake is only necessary to compile the specs for bandit itself.)
If you want to use bandit inside your projects,
add the parent directory of the `bandit` directory to your project's
include directories and you are ready to go.
Note that you can remove all directories except the `bandit` directory.
Also keep license and copyright information intact.
You can also simply use the `headers-only` branch as a submodule:
```sh
git submodule add -b headers-only https://github.com/banditcpp/bandit bandit
git submodule update --init --recursive
```
## Compilers
Bandit has been tested with the following compilers:
* GCC ≥ 4.5
* Clang ≥ 3.2
* MSVC ≥ 2012
If you want to see if bandit works for your compiler, bandit is shipped with a
cmake project for generating bandit's self tests. Let us know how it goes.
If your compiler does not support the C++11 features required by Bandit, we
suggest that you take a look at [Igloo](//iglootesting.wordpress.com/), which is
built on the same philosophy but works without C++11.
## Online resources
* [The bandit website](//banditcpp.github.io/bandit)
* [Bandit on GitHub](//github.com/banditcpp/bandit)
* [Issues with bandit](//github.com/banditcpp/bandit/issues?state=open)
* IRC: [#banditcpp on freenode](//webchat.freenode.net?channels=%23banditcpp)