Fossil Test next step

.github/workflows/meson_ci.yml

@@ -56,18 +56,8 @@ jobs:
       - name: Configure
         run: meson setup builddir_msvc_${{ matrix.msvc_version }} --fatal-meson-warnings -Dwerror=true -Dwith_test=enabled -Dwarning_level=3
 
-      - name: Compile
-        run: meson compile -C builddir_msvc_${{ matrix.msvc_version }}
-
       - name: Run Tests
-        run: meson test -C builddir_msvc_${{ matrix.msvc_version }} -v --test-arg='summary ci'
-
-      - name: Upload Test Log
-        if: failure()
-        uses: actions/upload-artifact@v4
-        with:
-          name: windows_msvc_${{ matrix.msvc_version }}_meson_testlog
-          path: builddir_msvc_${{ matrix.msvc_version }}/meson-logs/testlog.txt
+        run: meson test -C builddir_msvc_${{ matrix.msvc_version }} -v --test-args='verbose=ci'
 
   build_macosx:
     name: Building on macOS with Xcode ${{ matrix.xcode_version }}
@@ -96,18 +86,8 @@ jobs:
       - name: Configure
         run: meson setup builddir --fatal-meson-warnings -Dwerror=true -Dwith_test=enabled -Dwarning_level=3
 
-      - name: Compile
-        run: meson compile -C builddir
-
       - name: Run Tests
-        run: meson test -C builddir -v --test-arg='summary ci'
-
-      - name: Upload Test Log
-        if: failure()
-        uses: actions/upload-artifact@v4
-        with:
-          name: macos_xcode_${{ matrix.xcode_version }}_meson_testlog
-          path: builddir/meson-logs/testlog.txt
+        run: meson test -C builddir -v --test-args='verbose=ci'
 
   build_msys:
     name: Building on MSYS ${{ matrix.architecture }}
@@ -143,18 +123,8 @@ jobs:
       - name: Configure
         run: meson setup builddir --fatal-meson-warnings -Dwerror=true -Dwith_test=enabled -Dwarning_level=3
 
-      - name: Compile
-        run: meson compile -C builddir
-
       - name: Run Tests
-        run: meson test -C builddir -v --test-arg='summary ci'
-
-      - name: Upload Test Log
-        if: failure()
-        uses: actions/upload-artifact@v4
-        with:
-          name: msys_${{ matrix.architecture }}_meson_testlog
-          path: builddir/meson-logs/testlog.txt
+        run: meson test -C builddir -v --test-args='verbose=ci'
 
   build_mingw:
     name: Building on MinGW ${{ matrix.architecture }}
@@ -194,18 +164,8 @@ jobs:
       - name: Configure
         run: meson setup builddir --fatal-meson-warnings -Dwerror=true -Dwith_test=enabled -Dwarning_level=3
 
-      - name: Compile
-        run: meson compile -C builddir
-
       - name: Run Tests
-        run: meson test -C builddir -v --test-arg='summary ci'
-
-      - name: Upload Test Log
-        if: failure()
-        uses: actions/upload-artifact@v4
-        with:
-          name: mingw_${{ matrix.architecture }}_meson_testlog
-          path: builddir/meson-logs/testlog.txt
+        run: meson test -C builddir -v --test-args='verbose=ci'
 
   build_posix:
     name: Build on Linux ${{ matrix.distro }}
@@ -247,8 +207,7 @@ jobs:
             /bin/bash -c "
               sudo apt update
               meson setup builddir --fatal-meson-warnings -Dwerror=true -Dwith_test=enabled -Dwarning_level=3
-              meson compile -C builddir
-              meson test -C builddir -v --test-arg='summary ci'"
+              meson test -C builddir -v --test-args='verbose=ci'"
 
   build_cross:
     name: Building on Bedrock ${{ matrix.architecture }}
@@ -342,9 +301,9 @@ jobs:
 
       - name: Build the Project
         run: |
-          meson compile -C builddir -v
+          meson compile -C builddir
 
       - name: Test the Project
         run: |
-          meson test -C builddir -v --test-arg='summary ci'
+          meson test -C builddir -v --test-args='verbose=ci'
 

README.md

@@ -1,31 +1,17 @@
 # ***Fossil Test by Fossil Logic***
 
-**Fossil Test** is a powerful and flexible unit testing, mocking, and benchmarking suite developed by Fossil Logic to ensure the reliability, clarity, and performance of **C**, **C++**, and **Python** projects. Supporting multiple development methodologies—including Behavior-Driven Development (BDD), Domain-Driven Design (DDD), and Test-Driven Development (TDD)—Fossil Test offers a versatile foundation for building high-quality, maintainable test suites across diverse workflows. Starting with version 1.1.8, it integrates **Jellyfish AI**, an intelligent system designed to apply AI where it makes sense—enhancing test coverage insights, feedback clarity, and overall developer experience.
-
-The Fossil suite consists of three complementary frameworks to streamline the development and testing process:
-
-- **Fossil Test**: The core unit testing framework that enables developers to create, manage, and execute unit tests effectively, ensuring each component functions as expected.
-- **Fossil Mock**: A dedicated mocking library that simulates complex dependencies. Using mock objects, developers can isolate and thoroughly test individual components, improving the precision and reliability of test coverage.
-- **Fossil Mark**: A benchmarking tool that provides detailed performance insights by measuring execution time, identifying bottlenecks, and offering in-depth reporting to optimize code efficiency.
-
-Together, **Fossil Test**, **Fossil Mock**, and **Fossil Mark** — now supercharged with **Jellyfish AI** — offer a powerful, integrated toolkit for developing, testing, and optimizing robust software, making them an essential asset for developers committed to quality and performance.
-
----
-
-## **Key Features**
+**Fossil Test** is a comprehensive suite for unit testing, mocking, and benchmarking, designed by Fossil Logic to enhance the reliability, clarity, and performance of **C**, **C++**, and **Python** projects. Supporting methodologies like Behavior-Driven Development (BDD), Domain-Driven Design (DDD), and Test-Driven Development (TDD), it caters to diverse workflows with features such as a robust Command-Line Interface (CLI), advanced mocking tools, integrated benchmarking, and parallel test execution. With additional capabilities like customizable output themes, tag-based test filtering, and detailed performance insights, **Fossil Test**, alongside **Fossil Mock**, **Fossil Mark**, and **Fossil Sanity Kit** for testing command-line operations, forms a powerful toolkit for building, testing, and optimizing high-quality, maintainable software.
 
 | Feature                     | Description                                                                                                                             |
 |-----------------------------|-----------------------------------------------------------------------------------------------------------------------------------------|
-| **Jellyfish AI Integration** | Intelligent assistant for analyzing test coverage, diagnostics, and improving test clarity (available from v1.1.8 onward).               |
-| **BDD, DDD, and TDD Support** | Supports Behavior-Driven, Domain-Driven, and Test-Driven Development styles, catering to various project methodologies.                    |
-| **Comprehensive Unit Testing** | A full suite of tools for creating, managing, and executing unit tests, ensuring that individual units of code behave as expected.         |
-| **Mocking Capabilities**    | Powerful mocking features allow developers to simulate complex dependencies, ensuring focused and reliable unit tests.                 |
-| **Performance Tracking**    | Measures and reports the performance of each test case, helping developers optimize test execution time and performance.                 |
-| **Command-Line Interface (CLI)** | A powerful CLI for running tests, generating reports, and managing the test suite, supporting automation and integration workflows.    |
-
----
-
-*Note: Jellyfish AI is developed as part of the Fossil Logic ecosystem and is tightly integrated with Fossil Test to offer non-intrusive, intelligent guidance throughout the testing process.*
+| **Command-Line Interface (CLI)** | A robust CLI for executing tests, managing test suites, and generating reports, enabling seamless automation and integration workflows. |
+| **Support for Multiple Testing Styles** | Fully compatible with Behavior-Driven Development (BDD), Domain-Driven Design (DDD), and Test-Driven Development (TDD) methodologies. |
+| **Mocking Capabilities** | Advanced mocking tools to simulate complex dependencies, ensuring isolated and precise unit testing. |
+| **Benchmarking Tools** | Integrated benchmarking features to measure execution time, identify bottlenecks, and optimize code performance. |
+| **Sanity Kit for Command Tests** | A specialized suite for validating command-line tools and scripts, ensuring consistent behavior across environments. |
+| **Customizable Output Themes** | Multiple output themes (e.g., fossil, catch, doctest) to tailor the appearance of test results. |
+| **Tag-Based Test Filtering** | Organize and execute tests based on custom tags for better test management. |
+| **Detailed Performance Insights** | Comprehensive reporting on test execution times and resource usage to aid in performance optimization. |
 
 ---
 
@@ -57,7 +43,7 @@ To get started with Fossil Test, ensure you have the following installed:
    # ======================
    [wrap-git]
    url = https://github.com/fossillogic/fossil-test.git
-   revision = v1.2.0
+   revision = v1.2.1
 
    [provide]
    fossil-test = fossil_test_dep
@@ -83,14 +69,46 @@ The Fossil Test CLI provides an efficient way to run and manage tests directly f
 |----------------------------------|-----------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------|
 | `--version`                      | Displays the current version of Fossil Test.                                                  | Useful for verifying the version of the tool in use.                                          |
 | `--help`                         | Shows help message with usage instructions.                                                   | Provides a quick reference for all available commands.                                        |
-| `--info`                         | Displays detailed information about the test run.                                             | Includes information such as test count, duration, and configuration.                         |
-| `reverse [enable/disable]`       | Enables or disables reverse order of test execution.                                          | Useful for debugging or ensuring the tests don't depend on execution order.                   |
-| `shuffle [enable/disable]`       | Enables or disables shuffling of test execution order.                                        | Helps identify order-dependent issues in the test suite.                                      |
-| `dry-run [enable/disable]`       | Enables or disables dry run mode, showing which tests will execute without running them.      | Ideal for verifying test selection criteria before actual execution.                          |
-| `repeat <number>`                | Repeats the test suite a specified number of times.                                           | Handy for stress-testing or reproducing intermittent failures.                                |
-| `color [enable/disable]`         | Enables or disables colored output.                                                           | Enhances readability in supported terminals.                                                  |
-| `format <plain, ci, jellyfish>`  | Selects the output format for test results.                                                   | Affects how test data is displayed; useful for visual or machine-parsed output.               |
-| `summary <plain, ci, jellyfish>` | Sets the level of summary output after test execution.                                        | `ci` is minimal, `jellyfish` is smart test mode, and `plain` is default classic.              |
+| `--dry-run`                      | Perform a dry run without executing commands.                                                 | Ideal for verifying test selection criteria before actual execution.                          |
+| `--host`                         | Shows info about the current host system.                                                     | Useful for looking up system you are running test on.                                          |
+| `run`                            | Execute tests with optional parameters.                                                       | Supports additional options like `--fail-fast` and `--repeat`.                               |
+| `filter`                         | Filter tests based on criteria.                                                               | Options include filtering by test name, suite name, or tags.                                  |
+| `sort`                           | Sort tests by specified criteria.                                                             | Allows sorting in ascending or descending order.                                              |
+| `shuffle`                        | Shuffle tests with optional parameters.                                                       | Includes options for specifying a seed or shuffle criteria.                                   |
+| `color=<mode>`                   | Set color mode (enable, disable, auto).                                                       | Enhances readability in supported terminals.                                                  |
+| `theme=<name>`                   | Set the theme (fossil, catch, doctest, etc.).                                                 | Customizes the appearance of test output.                                                     |
+| `verbose=<level>`                | Set verbosity level (plain, ci, doge).                                                        | Adjusts the level of detail in test output.                                                   |
+
+### Run Command Options
+| Option               | Description                                                                                   | Notes                                                                                         |
+|----------------------|-----------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------|
+| `--fail-fast`        | Stop on the first failure.                                                                    | Useful for quickly identifying and addressing critical issues.                               |
+| `--only <test>`      | Run only the specified test.                                                                  | Focuses execution on a single test for debugging or validation purposes.                      |
+| `--repeat <count>`   | Repeat the test a specified number of times.                                                  | Useful for stress testing or verifying consistency across multiple runs.                      |
+| `--help`             | Show help for the run command.                                                                | Provides detailed usage instructions for the `run` command.                                   |
+
+### Filter Command Options
+| Option               | Description                                                                                   | Notes                                                                                         |
+|----------------------|-----------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------|
+| `--test-name <name>` | Filter by test name.                                                                          | Enables precise targeting of individual tests.                                                |
+| `--suite-name <name>`| Filter by suite name.                                                                         | Useful for running all tests within a specific suite.                                         |
+| `--tag <tag>`        | Filter by tag.                                                                                | Allows grouping and execution of tests based on custom tags.                                  |
+| `--help`             | Show help for the filter command.                                                             | Provides detailed usage instructions for the `filter` command.                                |
+
+### Sort Command Options
+| Option               | Description                                                                                   | Notes                                                                                         |
+|----------------------|-----------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------|
+| `--by <criteria>`    | Sort by specified criteria.                                                                   | Common criteria include execution time, name, or priority.                                    |
+| `--order <asc/desc>` | Sort in ascending or descending order.                                                        | Helps organize test execution based on preferred order.                                       |
+| `--help`             | Show help for the sort command.                                                               | Provides detailed usage instructions for the `sort` command.                                  |
+
+### Shuffle Command Options
+| Option               | Description                                                                                   |
+|----------------------|-----------------------------------------------------------------------------------------------|
+| `--seed <seed>`      | Specify the seed for shuffling.                                                               |
+| `--count <count>`    | Number of items to shuffle.                                                                   |
+| `--by <criteria>`    | Shuffle by specified criteria.                                                                |
+| `--help`             | Show help for the shuffle command.                                                            |
 
 ## Configure Build Options