https://github.com/droolsassert/droolsassert

Drools unit and integration testing with JUnit and jbehave
https://github.com/droolsassert/droolsassert

code-coverage drools jbehave junit performance-analysis spring

Last synced: about 2 months ago
JSON representation

Drools unit and integration testing with JUnit and jbehave

• Host: GitHub
• URL: https://github.com/droolsassert/droolsassert
• Owner: droolsassert
• License: apache-2.0
• Created: 2019-05-17T07:59:25.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2025-03-07T13:46:55.000Z (7 months ago)
• Last Synced: 2025-07-14T20:13:39.560Z (3 months ago)
• Topics: code-coverage, drools, jbehave, junit, performance-analysis, spring
• Language: Java
• Homepage:
• Size: 1.84 MB
• Stars: 18
• Watchers: 3
• Forks: 8
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

          
## Goal

Relieve Drools JUnit testing 

## Audience

The goal of unit testing is to isolate each part of the program and show that the individual parts are correct. You can achieve this easier when working with drools using this library. Be certain about the rules being activated and the facts retained in your session for a scenario you need.

## Approach

Unit test is about taking minimum piece of code and test all possible usecases defining specification. With integration tests your goal is not all possible usecases but integration of several units that work together. Do the same with rules. Segregate rules by business meaning and purpose. Simplest 'unit under the test' could be file with single or [high cohesion](https://stackoverflow.com/q/10830135/448078) set of rules and what is required for it to work (if any), like common DSL definition file or decision table. For integration test you could take meaningful subset or all rules of the system. 

## Usage

Specify any combination of rules you want to test in single session using `@DroolsSession`, `logResources` to see what was actually included.  

Spring ant-like [PathMatchingResourcePatternResolver](https://docs.spring.io/spring-framework/docs/current/javadoc-api/org/springframework/core/io/support/PathMatchingResourcePatternResolver.html) gives you robust tool to include functionality you want to test together or segregate.  

    @DroolsSession("**/project/rules/ruleUnderTest.drl")

Declare JUnit5 [extension](https://junit.org/junit5/docs/current/user-guide/#extensions) for the test ([rule](https://www.baeldung.com/junit-4-rules) for JUnit4)

    @RegisterExtension

    public DroolsAssert drools = new DroolsAssert();

Specify list of rules expected to be activated for a scenario with `@TestRules` annotation in addition to assertions inside test method and use other useful utilities to deal with the session.

    @Test

    @TestRules(expected = "atomic int rule")

    public void testInt() {

        drools.insertAndFire(new AtomicInteger());

        assertEquals(1, drools.getObject(AtomicInteger.class).get());

    }

## Examples

[Dummy assertions](https://github.com/droolsassert/droolsassert/wiki/Dummy-assertions)  

[Complex event processing](https://github.com/droolsassert/droolsassert/wiki/Complex-event-processing)  

[Spring integration test](https://github.com/droolsassert/droolsassert/wiki/Spring-integration-test)  

[Extend it with your application specific utilities](https://github.com/droolsassert/droolsassert/wiki/Extension-example)  

[Gather performance statistic](https://github.com/droolsassert/droolsassert/wiki/Performance-stats)  

[Activation report](https://github.com/droolsassert/droolsassert/wiki/Activation-report)  

[State transition report](https://github.com/droolsassert/droolsassert/wiki/State-transition-report)  

[Run tests in parallel](https://github.com/droolsassert/droolsassert/wiki/Parallel-run)  

[Jbehave integration](https://github.com/droolsassert/droolsassert/wiki/Jbehave-integration)  

[Jbehave Spring example](https://github.com/droolsassert/droolsassert/wiki/Jbehave-Spring-example)  

[Jbehave extention](https://github.com/droolsassert/droolsassert/wiki/Jbehave-extention)  

[JUnit vs jbehave](https://github.com/droolsassert/droolsassert/wiki/JUnit-vs-jbehave)  

## Maven dependency

    

        org.droolsassert

        droolsassert

        x.x.x

        test

    

## Compatibility matrix

    DroolsJunit5Junit4Java

    10.x.x3.4.22.8.217+

    9.x.x3.3.42.7.811+

    8.x.x3.1.102.6.1011+

    7.x.x3.0.192.5.191.8+

    6.4+2.4.122.3.131.8+

## Support

[Buy me a coffee](https://www.buymeacoffee.com/droolsassert)