A KISS, non-intrusive cross-platform C unit testing framework
移至檔案
Steffen Vogel 5b0f2b1290 create nanomsg sockets in /var/lib by default 2016-09-27 21:20:37 -04:00
.cmake travis: Use the default python installation for cram 2016-09-23 17:23:24 +02:00
.githooks hooks: Append diffs with tee rather than overwrite them 2016-09-13 23:38:49 +02:00
dependencies boxfort,windows: Fixed arena mapping errors. Fixes #149. 2016-09-18 21:45:57 +02:00
dev contrib: Added autotools skeleton 2016-09-24 00:51:49 +02:00
doc doc: Fixed wrong usage of parameterized test arrays 2016-09-27 18:52:48 +02:00
include/criterion debug: Added support for --debug=idle. Fixes #154. 2016-09-16 17:15:47 +02:00
po debug: Added support for --debug=idle. Fixes #154. 2016-09-16 17:15:47 +02:00
samples asserts: Add assertions for wide strings 2016-09-10 08:48:30 +02:00
src create nanomsg sockets in /var/lib by default 2016-09-27 21:20:37 -04:00
test cram,osx: Fixed mismatch in getopt diagnostic 2016-09-24 20:32:12 +02:00
.bumpversion.cfg release: Prepare a release candidate for 2.3.0 2016-09-19 00:21:17 +02:00
.gitignore Merge branch 'features/io-rewrite-nanopb' into bleeding 2016-01-18 01:35:55 +01:00
.gitmodules boxfort: Added boxfort dependency 2016-09-03 15:08:51 +02:00
.travis.yml travis: Use the default python installation for cram 2016-09-23 17:23:24 +02:00
.uncrustify.cfg style: Fixed (A) Op (B) formatting taking 'Op' as a function rather than an operator 2016-09-06 10:49:10 +02:00
AUTHORS authors: Added AUTHORS file 2016-09-22 13:03:40 +02:00
CMakeLists.txt dyncall: Fixed -fPIC warnings on windows and CXX requirement 2016-09-13 12:56:20 +02:00
CONTRIBUTING.md contributing: Added bit on commit messages 2016-09-06 11:02:08 +02:00
ChangeLog changelog: Added the parameter change to the custom logger provider API 2016-09-21 13:57:25 +02:00
LICENSE We're in 2016. 2016-01-06 17:35:35 +01:00
README.md contrib: Added autotools skeleton 2016-09-24 00:51:49 +02:00
appveyor.yml release: Prepare a release candidate for 2.3.0 2016-09-19 00:21:17 +02:00
debian.copyright [license] Updated license year on missed files 2016-01-18 16:06:54 +01:00
description.txt Added missing files for ppa builds 2015-11-28 14:33:09 +01:00

README.md

Criterion Logo =========

Unix Build Status Windows Build Status Coverage Status License Version

A dead-simple, yet extensible, C and C++ unit testing framework.

Screencast

Philosophy

Most test frameworks for C require a lot of boilerplate code to set up tests and test suites -- you need to create a main, then register new test suites, then register the tests within these suits, and finally call the right functions.

This gives the user great control, at the unfortunate cost of simplicity.

Criterion follows the KISS principle, while keeping the control the user would have with other frameworks:

  • C99 and C++11 compatible.
  • Tests are automatically registered when declared.
  • Implements a xUnit framework structure.
  • A default entry point is provided, no need to declare a main unless you want to do special handling.
  • Test are isolated in their own process, crashes and signals can be reported and tested.
  • Unified interface between C and C++: include the criterion header and it just works.
  • Supports parameterized tests and theories.
  • Progress and statistics can be followed in real time with report hooks.
  • TAP output format can be enabled with an option.
  • Runs on Linux, FreeBSD, Mac OS X, and Windows (Compiling with MinGW GCC and Visual Studio 2015+).

Downloads

Packages

  • Mac OS X: brew install snaipe/soft/criterion
  • AUR: yaourt -S criterion

Binary archives

Binary releases are available on the release page

If you have a different platform, you can still build the library from source

Developer Resources

Documentation

An online documentation is available on ReadTheDocs (PDF | Zip | Epub)

Samples

Sample tests can be found in the sample directory.

Getting help

Channel Description
Subscribe to the mailing list Criterion mailing list on freelists.org
Join the chat at https://gitter.im/Snaipe/Criterion Snaipe/Criterion on gitter.im
Join #criterion on freenode #criterion on irc.freenode.net

Misc

Credits

Logo made by Paul Bouigue