Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ivafanas/sltbench
C++ benchmark tool. Practical, stable and fast performance testing framework.
https://github.com/ivafanas/sltbench
benchmark benchmark-framework benchmarking cplusplus cpp cpp-library open-source performance test-framework testing testing-tools
Last synced: 28 days ago
JSON representation
C++ benchmark tool. Practical, stable and fast performance testing framework.
- Host: GitHub
- URL: https://github.com/ivafanas/sltbench
- Owner: ivafanas
- License: bsl-1.0
- Created: 2016-06-19T12:12:16.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2023-01-27T03:26:01.000Z (almost 2 years ago)
- Last Synced: 2024-05-22T16:33:10.313Z (7 months ago)
- Topics: benchmark, benchmark-framework, benchmarking, cplusplus, cpp, cpp-library, open-source, performance, test-framework, testing, testing-tools
- Language: C++
- Homepage:
- Size: 341 KB
- Stars: 149
- Watchers: 17
- Forks: 10
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Changelog: ChangeLog.rst
- License: LICENSE
Awesome Lists containing this project
- awesome-cpp-testing - sltbench - C++ benchmark tool. Practical, stable and fast performance testing framework. (Performance Testing)
README
# sltbench
[](https://travis-ci.org/ivafanas/sltbench)
[](https://ci.appveyor.com/project/ivafanas/sltbench)
C++ benchmark tool. Practical, stable and fast performance testing framework.
- practical - came up from daily production tasks. Usability matters
- stable - correctness and reproducibility is a goal
- fast - if results are stable, they should be produced as soon as possible
This tool is trained to gain about 5% measure stability (depends on function,
input and context). Of course, it cannot strongly guarantee 5% stability (some
functions are unstable itself, nothing helps), but it tends to.
# Why sltbench
The closest and the most famous analogue is googlebench - microbenchmarking
library from Google engineers.
Key features of `sltbench` are:
* sltbench is about *4.7x times faster* than googlebench (test execution time).
* sltbench produces results with less timing error, which matters for
performance results reproducibility. About 5x times improvement for testing
dataset.
* Supports correct mutable fixtures.
* Supports lazy arguments generation including reading from file,
autogeneration etc.. (critical for large input datasets which does not fit
into RAM all together)
* Output customization, separate tools for performance results comparison and
more.
### measure time
(Results below are obtained on 4 cores i7-2600 CPU @ 3.40GHz, 8Gb RAM
for sltbench dataset; see "Metrics" section for details; see
[How to benchmark](doc/howtobenchmark.md) section for instructions)
| |sltbench|googlebench|nonius|
|----------------------|:------:|:---------:|:----:|
| benchmark time, sec | 87.45 | 416.44 |482.03|
| average rel error, % | 0.4% | 5.6% | 2.6%|
| maximum rel error, % | 2.9% | 15.1% | 60% |
4.7x times speedup might be useful for projects with big performance tests count. For the original project regression performance testing tooks about a week and testing time reduction matters.
Less relative error means:
* Less false speedups/slowdowns you get during testing. Economy of developer
time.
* More precise performance changes may be obtained. If testing tool provides
15% relative error than 10% speedup couldn't be measured.
### compilation time
Sltbench contains improvements on compilation time of benchmarks (not library!)
for the most popular api since 2.4.0. Benchmarks for functions without arguments
and driver launch might be implemented in a more lightweight manner. See
[Advanced user guide](doc/advanced_user_guide.md) for explanation how to reuse
improvements.
(benchcompile metric results below are obtained on Intel(R) Core(TM) i5-8400 CPU
@ 2.80GHz, clang-6.0.0, dataset=simple for optimized cases only)
| | compilation time, sec |
|--------------------|:---------------------:|
| sltbench 2.4.0 | 2.5 |
| googlebench v1.5.1 | 16.5 |
# Motivating example
The following code registers `my_function` for timing. Just compile it (do not
forget about includes) and the executable file will test `my_function` for
performance.
```c++
void my_function()
{
std::vector v(100000, 0);
std::sort(v.begin(), v.end());
}
SLTBENCH_FUNCTION(my_function);
SLTBENCH_MAIN();
```
# Documentation
* [Build instructions](doc/build.md)
* [Examples](doc/examples.md)
* [How to benchmark](doc/howtobenchmark.md) - follow this
instruction before you run any performance test
* [How to analyse performance results](doc/howto_analyze_results.md)
* [How to compare performance results](doc/compare_results.md)
* [Advanced command line options](doc/commandlineoptions.md)
* [Advanced user guide](doc/advanced_user_guide.md)
* [Critical metrics for sltbench project and evaluation tools](tools/metrics/README.md)
# License
sltbench is released under the Apache 2.0 license