This website works better with JavaScript.
Home
Explore
Help
Sign In
mirrors
/
rspamd
mirror of
https://github.com/vstakhov/rspamd.git
Watch
1
Star
0
Fork
0
Code
Issues
0
Releases
159
Wiki
Activity
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
21175
Commits
28
Branches
Branch:
master
master
rspamd-3.8
vstakhov-fuzzy-tcp
external-maps
libev-migration
log_json
mime-rework
rdns-tcp-rework
rework-symcache
rspamd-0.5
rspamd-0.6
rspamd-0.7
rspamd-0.8
rspamd-0.9
rspamd-1.0
rspamd-1.1
rspamd-1.2
rspamd-1.3
rspamd-1.4
rspamd-1.5
rspamd-1.6
rspamd-1.9
rspamd-3.7
torch-removal
vstakhov-fasttext-langdet
vstakhov-fuzzy-cxx
vstakhov-known-senders
vstakhov-stringzilla
3.8.4
3.8.3
3.8.2
3.8.1
3.8.0
3.7.5
3.7.4
3.7.3
3.7.2
3.7.1
3.6
3.5
3.4
3.3
3.2
3.1
3.0
2.7
2.6
2.5
2.4
2.3
2.2
2.1
2.0
1.9.4
1.9.3
1.9.2
1.9.1
1.9.0
1.8.3
1.8.2
1.8.1
1.8.0
1.7.9
1.7.8
1.7.7
1.7.6
1.7.5
1.7.4
1.7.3
1.7.2
1.7.1
1.7.0
1.6.6
1.6.5
1.6.4
1.6.3
1.6.2
1.6.1
1.6.0
1.5.9
1.5.8
1.5.7
1.5.6
1.5.5
1.5.4
1.5.3
1.5.2
1.5.1
1.5.0
1.4.4
1.4.3
1.4.2
1.4.1
1.4.0
1.3.5
1.3.4
1.3.3
1.3.2
1.3.1
1.3.0
1.2.8
1.2.7
1.2.6
1.2.5
1.2.4
1.2.3
1.2.2
1.2.1
1.2.0
1.1.4
1.1.3
1.1.2
1.1.1
1.1.0
1.0.11
1.0.10
1.0.9
1.0.8
1.0.7
1.0.6
1.0.5
1.0.4
1.0.3
1.0.2
1.0.1
1.0.0
0.9.10
0.9.9
0.9.8
0.9.7
0.9.6
0.9.5
0.9.4
0.9.3
0.9.2
0.9.1
0.9.0
0.8.3
0.8.2
0.8.1
0.8.0
0.7.6
0.7.5
0.7.4
0.7.3
0.7.2
0.7.1
0.7.0
0.6.10
0.6.9
0.6.8
0.6.7
0.6.6
0.6.5
0.6.4
0.6.3
0.6.2
0.6.1
0.6.0
0.5.6
0.5.5
0.5.4
0.5.3
0.5.2
0.5.1
0.5.0
0.4.7
0.4.6
0.4.5
0.4.4
0.4.3
0.4.2
0.4.1
0.4.0
0.3.14
0.3.13
0.3.12
0.3.11
0.3.10
0.3.9
0.3.8
0.3.7
0.3.3
0.3.2
0.3.1
0.3.0
0.2.7
Branches
Tags
${ item.name }
Create branch
${ searchTerm }
from 'master'
${ noResults }
rspamd
/
contrib
/
doctest
/
README.md
README.md
11KB
Raw
Permalink
Blame
History
master branch
Windows
All
dev branch
Windows
All
**doctest** is a new C++ testing framework but is by far the fastest both in compile times (by [**orders of magnitude**](doc/markdown/benchmarks.md)) and runtime compared to other feature-rich alternatives. It brings the ability of compiled languages such as [**D**](
https://dlang.org/spec/unittest.html
) / [**Rust**](
https://doc.rust-lang.org/book/second-edition/ch11-00-testing.html
) / [**Nim**](
https://nim-lang.org/docs/unittest.html
) to have tests written directly in the production code thanks to a fast, transparent and flexible test runner with a clean interface. [![Standard](
https://img.shields.io/badge/c%2B%2B-11/14/17/20-blue.svg
)](
https://en.wikipedia.org/wiki/C%2B%2B#Standardization
) [![License](
https://img.shields.io/badge/license-MIT-blue.svg
)](
https://opensource.org/licenses/MIT
) [![Version](
https://badge.fury.io/gh/onqtam%2Fdoctest.svg
)](
https://github.com/onqtam/doctest/releases
) [![download](
https://img.shields.io/badge/download%20%20-link-blue.svg
)](
https://raw.githubusercontent.com/onqtam/doctest/master/doctest/doctest.h
) [![CII Best Practices](
https://bestpractices.coreinfrastructure.org/projects/503/badge
)](
https://bestpractices.coreinfrastructure.org/projects/503
) [![Language grade: C/C++](
https://img.shields.io/lgtm/grade/cpp/g/onqtam/doctest.svg
)](
https://lgtm.com/projects/g/onqtam/doctest/context:cpp
) [![Join the chat at
https://gitter.im/onqtam/doctest
](
https://badges.gitter.im/onqtam/doctest.svg
)](
https://gitter.im/onqtam/doctest?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge
) [![Try it online](
https://img.shields.io/badge/try%20it-online-orange.svg
)](
https://wandbox.org/permlink/nJIibfbivG7BG7r1
) [
](
http://www.patreon.com/onqtam
) The framework is and will stay free but needs your support to sustain its development. There are lots of
new features
and maintenance to do. If you work for a company using **doctest** or have the means to do so, please consider financial support. Monthly donations via Patreon and one-offs via PayPal. [
](
https://www.paypal.me/onqtam/10
) A complete example with a self-registering test that compiles to an executable looks like this: ![cover-example](scripts/data/using_doctest_888px_wide.gif) There are many C++ testing frameworks - [Catch](
https://github.com/catchorg/Catch2
), [Boost.Test](
http://www.boost.org/doc/libs/1_64_0/libs/test/doc/html/index.html
), [UnitTest++](
https://github.com/unittest-cpp/unittest-cpp
), [cpputest](
https://github.com/cpputest/cpputest
), [googletest](
https://github.com/google/googletest
) and many [other](
https://en.wikipedia.org/wiki/List_of_unit_testing_frameworks#C.2B.2B
). The **key** differences between it and other testing frameworks are that it is light and unintrusive: - Ultra light on compile times both in terms of [**including the header**](doc/markdown/benchmarks.md#cost-of-including-the-header) and writing [**thousands of asserts**](doc/markdown/benchmarks.md#cost-of-an-assertion-macro) - Doesn't produce any warnings even on the [**most aggressive**](scripts/cmake/common.cmake#L84) warning levels for **MSVC**/**GCC**/**Clang** - Offers a way to remove **everything** testing-related from the binary with the [**```DOCTEST_CONFIG_DISABLE```**](doc/markdown/configuration.md#doctest_config_disable) identifier - [**thread-safe**](doc/markdown/faq.md#is-doctest-thread-aware) - asserts (and logging) can be used from multiple threads spawned from a single test case - [**example**](examples/all_features/concurrency.cpp) - asserts can be used [**outside of a testing context**](doc/markdown/assertions.md#using-asserts-out-of-a-testing-context) - as a general purpose assert library - [**example**](examples/all_features/asserts_used_outside_of_tests.cpp) - Doesn't pollute the global namespace (everything is in namespace ```doctest```) and doesn't drag **any** headers with it - Very [**portable**](doc/markdown/features.md#extremely-portable) C++11 (use tag [**1.2.9**](
https://github.com/onqtam/doctest/tree/1.2.9
) for C++98) with over 180 different CI builds (static analysis, sanitizers...) - binaries (exe/dll) can use the test runner of another binary - so tests end up in a single registry - [**example**](examples/executable_dll_and_plugin/) ![cost-of-including-the-framework-header](scripts/data/benchmarks/header.png) This allows the framework to be used in more ways than any other - tests can be written directly in the production code! *Tests can be considered a form of documentation and should be able to reside near the production code which they test.* - This makes the barrier for writing tests **much lower** - you don't have to: **1)** make a separate source file **2)** include a bunch of stuff in it **3)** add it to the build system and **4)** add it to source control - You can just write the tests for a class or a piece of functionality at the bottom of its source file - or even header file! - Tests in the production code can be thought of as documentation or up-to-date comments - showing the use of APIs - Testing internals that are not exposed through the public API and headers is no longer a mind-bending exercise - [**Test-driven development**](
https://en.wikipedia.org/wiki/Test-driven_development
) in C++ has never been easier! The framework can be used like any other if you don't want/need to mix production code and tests - check out the [**features**](doc/markdown/features.md). **doctest** is modeled after [**Catch**](
https://github.com/catchorg/Catch2
) and some parts of the code have been taken directly - check out [**the differences**](doc/markdown/faq.md#how-is-doctest-different-from-catch). [This table](
https://github.com/martinmoene/catch-lest-other-comparison
) compares **doctest** / [**Catch**](
https://github.com/catchorg/Catch2
) / [**lest**](
https://github.com/martinmoene/lest
) which are all very similar. Checkout the [**CppCon 2017 talk**](
https://cppcon2017.sched.com/event/BgsI/mix-tests-and-production-code-with-doctest-implementing-and-using-the-fastest-modern-c-testing-framework
) on [**YouTube**](
https://www.youtube.com/watch?v=eH1CxEC29l8
) to get a better understanding of how the framework works and read about how to use it in [**the JetBrains article**](
https://blog.jetbrains.com/rscpp/better-ways-testing-with-doctest/
) - highlighting the unique aspects of the framework! On a short description on how to use the framework along production code you could refer to [**this GitHub issue**](
https://github.com/onqtam/doctest/issues/252
). There is also an [**older article**](
https://accu.org/var/uploads/journals/Overload137.pdf
) in the february edition of ACCU Overload 2017. [![CppCon 2017 talk about doctest on youtube](scripts/data/youtube-cppcon-talk-thumbnail.png)](
https://www.youtube.com/watch?v=eH1CxEC29l8
) Documentation ------------- Project: - [Features and design goals](doc/markdown/features.md) - the complete list of features - [Roadmap](doc/markdown/roadmap.md) - upcoming features - [Benchmarks](doc/markdown/benchmarks.md) - compile-time and runtime supremacy - [Contributing](CONTRIBUTING.md) - how to make a proper pull request - [Changelog](CHANGELOG.md) - generated changelog based on closed issues/PRs Usage: - [Tutorial](doc/markdown/tutorial.md) - make sure you have read it before the other parts of the documentation - [Assertion macros](doc/markdown/assertions.md) - [Test cases, subcases and test fixtures](doc/markdown/testcases.md) - [Parameterized test cases](doc/markdown/parameterized-tests.md) - [Command line](doc/markdown/commandline.md) - [Logging macros](doc/markdown/logging.md) - [```main()``` entry point](doc/markdown/main.md) - [Configuration](doc/markdown/configuration.md) - [String conversions](doc/markdown/stringification.md) - [Reporters](doc/markdown/reporters.md) - [Extensions](doc/markdown/extensions.md) - [FAQ](doc/markdown/faq.md) - [Build systems](doc/markdown/build-systems.md) - [Examples](examples) Contributing ------------ [
](
http://www.patreon.com/onqtam
) Support the development of the project with donations! There is a list of planned features which are all important and big - see the [**roadmap**](doc/markdown/roadmap.md). I took a break from working in the industry to make open source software so every cent is a big deal. [
](
https://www.paypal.me/onqtam/10
) If you work for a company using **doctest** or have the means to do so, please consider financial support. Contributions in the form of issues and pull requests are welcome as well - check out the [**Contributing**](CONTRIBUTING.md) page. Stargazers over time ------------ [![Stargazers over time](
https://starcharts.herokuapp.com/onqtam/doctest.svg
)](
https://starcharts.herokuapp.com/onqtam/doctest
) Logo ------------ The [logo](scripts/data/logo) is licensed under a Creative Commons Attribution 4.0 International License. Copyright © 2019 [area55git](
https://github.com/area55git
) [![License: CC BY 4.0](
https://licensebuttons.net/l/by/4.0/80x15.png
)](
https://creativecommons.org/licenses/by/4.0/
)