Fossil Logic XTest - C

XTest is a cutting-edge test library developed by Fossil Logic, designed to streamline and enhance the testing process for modern software development. Combining the power of rich assertion capabilities, behavior-driven development (BDD), test-driven development (TDD), and a command-line interface (CLI), XTest empowers developers to achieve unparalleled efficiency and reliability in their testing workflows. Xtest streamlines the testing process, enabling faster feedback cycles and accelerated development workflows. The intuitive CLI interface makes it easy for developers to interact with the test framework, facilitating seamless integration into existing development environments.

Command-Line Interface

This CLI tool provides various options to customize the behavior and output of the test runner. Use the options above to tailor your testing experience according to your needs.

Usage: xcli [options] 2024-05-31 16:05:19
Options: {help,version,tip,console,priority,color,dry-run,repeat}

        -h, --help       : Display this help message                                       :
        -v, --version    : Display program version                                         :
        -t, --tip        : Display a helpful tip                                           :
        -c, --console    : Set IO mode for runner ('human'/cutback/turbo)                  :
        -p, --priority N : Set priority threshold for test cases (1-100)                   :
        -r, --repeat   N : Set a given repeat for a number of times (1-100)                :
        -c, --color      : Enable colored output                                           :
        --dry-run        : Do a simple pass of the test runner to ensure it works          :

Adding dependency

1. Install Meson Build System: Before integrating the dependency, ensure you have Meson 1.2 or newer installed on your host system. You can install it with this command.

   python -m pip install meson           # to install Meson
   python -m pip install --upgrade meson # to upgrade Meson

2. Adding Wrap File: You can add a .wrap, first go into subprojects directory and create fscl-xtest-c.wrap next copy the defintion into the file:

   # ======================
   # Git Wrap package definition
   # ======================
   [wrap-git]
   url = https://github.com/fossil-lib/tscl-xtest-c.git
   revision = v3.0.0
   
   [provide]
   fscl-xtest-c = fscl_xtest_c_dep

3. Integrate the New Dependency: After creating the dependency .wrap file, you need to integrate it into your Meson project. This typically involves adding the dependency to your meson.build file. Here's an example of how you might do that:

   dep = dependency('fscl-xtest-c')

   This line retrieves the fscl-xtest-c dependency, allowing you to use it in your project.

Configure Options

You have options when configuring the build, each serving a different purpose:

• Running Tests: To enable running tests, use -Dwith_test=enabled when configuring the build.

Example:

meson setup builddir -Dwith_test=enabled

Contributing and Support

If you're interested in contributing to this project, encounter any issues, have questions, or would like to provide feedback, don't hesitate to open an issue or visit the Fossil Logic Docs for more information.