Ein Testframework für C++17

C++-Tests über Assertions hinaus.

Catch3 behält die Testfälle, Assertions und Sections, die Sie für Catch2 schreiben, und ergänzt einen eigenen Runner, Property-Tests, Mocks, Snapshots und strukturierte Ergebnisse.

Was Catch3 ergänzt

Alles, was Catch2-Tests tun, funktioniert weiter. Was Catch3 ergänzt, steht daneben, in eigenen Headern und einer eigenen Bibliothek.

Vertraute Tests

Testfälle, Assertions, Sections, Matcher, Generatoren, Listener und Benchmarks funktionieren unverändert.

Ein eigener Runner

Tests laufen parallel in Worker-Prozessen; ein Absturz oder Hänger beendet einen Test, nicht den Lauf. Fehlschläge werden wiederholt, um instabile und reihenfolgeabhängige Tests zu unterscheiden.

Ein Lauf erinnert sich

Die Historie steuert Zeitlimits, Reihenfolge, inkrementelle Läufe und Wiederholungen. Instabile Tests kommen in Quarantäne; Berichte gibt es für Konsole, JUnit, JSON und als Traces.

Property-Tests

Werte entstehen aus einem reproduzierbaren Seed, ein Prädikat wird über viele Durchläufe geprüft, und eine fehlschlagende Eingabe schrumpft zu einem kleineren Gegenbeispiel.

Mocks

Mocks virtueller Schnittstellen und freier Funktionen hinter einer Naht prüfen Aufrufzahl, Argumente und Reihenfolge.

Snapshots und Ergebnisse

Text-Snapshots in Dateien Ihrer Wahl und ein öffentliches Ergebnismodell mit einem deterministischen JUnit-XML-Writer.

Eine Property in wenigen Zeilen

Der Wurzel-Seed und die Ableitung jedes Durchlaufs sind stabil, daher lässt sich ein gemeldeter fehlschlagender Durchlauf wiederholen.

#include <Progmasoft/Catch3.hpp>

TEST_CASE("integers stay in their domain", "[property]") {
    CATCH3_CHECK_PROPERTY(
        Progmasoft::Catch3::Integer<int>(1, 100),
        [](int value) { return value > 0; },
        Progmasoft::Catch3::PropertyOptions{
            .Trials = 250,
            .Seed = 0xC0FFEE,
            .MaxShrinkSteps = 200});
}

Baut mit dem, was Sie nutzen

Bazel ist der Haupt-Build. Projektdateien für CMake, Meson, Xmake und Premake werden daneben gepflegt, und ein installiertes Catch3 wird mit find_package oder pkg-config gefunden.

  • Bazel
  • CMake
  • Meson
  • Xmake
  • Premake

Freie Software

Dateien aus Catch2 behalten die Boost Software License 1.0; Dateien, die Progmasoft schreibt, stehen unter der GNU LGPL, Version 3 oder später. Catch3 ist keine offizielle Catch2-Version und wird von den Catch2-Maintainern nicht unterstützt.

Mit Catch3 beginnen

Laden Sie die Bibliothek herunter, lesen Sie, wie ein Catch2-Projekt umzieht, und führen Sie Ihre erste Property aus.