Un framework de test pour C++17

Des tests C++ au-delà des assertions.

Catch3 garde les cas de test, les assertions et les sections que vous écrivez pour Catch2, et ajoute son propre exécuteur, des tests de propriétés, des mocks, des instantanés et des résultats structurés.

Ce qu'apporte Catch3

Tout ce que font les tests Catch2 continue de fonctionner. Ce qu'apporte Catch3 se trouve à côté, dans ses propres en-têtes et sa propre bibliothèque.

Des tests familiers

Cas de test, assertions, sections, matchers, générateurs, listeners et benchmarks fonctionnent sans changement.

Un exécuteur à lui

Les tests tournent en parallèle dans des processus de travail ; un plantage ou un blocage termine un test, pas l'exécution. Les échecs sont relancés pour distinguer les tests instables de ceux qui dépendent de l'ordre.

Une exécution se souvient

L'historique règle les délais, l'ordre, les exécutions incrémentales et la relecture. Les tests instables vont en quarantaine ; les rapports sortent en console, JUnit, JSON et traces.

Tests de propriétés

Les valeurs viennent d'une graine reproductible, un prédicat est vérifié sur de nombreux essais, et une entrée en échec se réduit à un contre-exemple plus petit.

Mocks

Des mocks d'interfaces virtuelles et de fonctions libres derrière une couture vérifient le nombre d'appels, les arguments et l'ordre.

Instantanés et résultats

Des instantanés texte dans les fichiers de votre choix, et un modèle de résultats public avec un écrivain JUnit XML déterministe.

Une propriété en quelques lignes

La graine racine et la dérivation de chaque essai sont stables : un essai en échec signalé peut être rejoué.

#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});
}

Se construit avec vos outils

Bazel est la construction principale. Les fichiers de projet CMake, Meson, Xmake et Premake sont tenus à côté, et un Catch3 installé se trouve avec find_package ou pkg-config.

  • Bazel
  • CMake
  • Meson
  • Xmake
  • Premake

Logiciel libre

Les fichiers issus de Catch2 gardent la Boost Software License 1.0 ; les fichiers écrits par Progmasoft sont sous GNU LGPL, version 3 ou ultérieure. Catch3 n'est pas une version officielle de Catch2 et n'est pas soutenu par ses mainteneurs.

Commencer avec Catch3

Téléchargez la bibliothèque, lisez comment migrer un projet Catch2 et lancez votre première propriété.