feat: we can now concat multiple arrays using concat helper (#40)

Author: brian-mulier

tzatziki-common/src/main/resources/burningwave.static.properties

@@ -0,0 +1,3 @@
+managed-logger.repository=autodetect
+managed-logger.repository.enabled=false
+banner.hide=true

tzatziki-core/README.md

@@ -294,6 +294,34 @@ And userName is equal to "bob"
 
 *notice that you need to surround your expression with `{{{[ expression ]}}}` to have Handlebars deal with the whitespaces*
 
+You can also use some built-in-handlebars helpers, or use some custom helpers for Tzatziki. One is used for example to concatenate multiple arrays :
+```gherkin
+Given that myFirstArray is:
+"""
+- firstItem
+- secondItem
+"""
+And that mySecondArray is:
+"""
+- thirdItem
+- fourthItem
+"""
+
+When resultArray is:
+"""
+{{#concat myFirstArray mySecondArray}}
+  {{this}}
+{{/concat}}
+"""
+
+Then resultArray is equal to:
+"""
+[firstItem, secondItem, thirdItem, fourthItem]
+"""
+```
+
+Other custom helpers are foreach (loop through array), split (split a String by symbol), math (compute some value) and conditional helpers (to compare values and output conditionally)
+
 ## Time management
 
 This library uses [Natty](http://natty.joestelmach.com/try.jsp) to express time human friendly way.

tzatziki-core/src/main/java/com/decathlon/tzatziki/steps/ObjectSteps.java

@@ -43,6 +43,7 @@
 import java.util.regex.Matcher;
 import java.util.regex.Pattern;
 import java.util.stream.Collectors;
+import java.util.stream.Stream;
 
 import static com.decathlon.tzatziki.steps.DynamicTransformers.register;
 import static com.decathlon.tzatziki.utils.Comparison.IS_COMPARED_TO;
@@ -91,6 +92,22 @@ public class ObjectSteps {
                 return ((Collection<?>) context).stream()
                         .map(value -> unchecked(() -> options.fn(value)))
                         .collect(Collectors.joining());
+            })
+            .registerHelper("concat", (firstArray, options) -> {
+                if(options.params.length <= 0){
+                    return null;
+                }
+
+                List<Collection<?>> collectionsToConcat = Stream.concat(Stream.of(firstArray), Arrays.stream(options.params))
+                        .map(arrayToConcat -> {
+                    if (arrayToConcat instanceof Collection<?> array) {
+                        return array;
+                    } else {
+                        return Mapper.<List<?>>read(arrayToConcat.toString(), List.class);
+                    }
+                }).toList();
+
+                return collectionsToConcat.stream().flatMap(Collection::stream).collect(Collectors.toList());
             });
 
     static {

tzatziki-core/src/test/resources/com/decathlon/tzatziki/steps/objects.feature

@@ -609,11 +609,40 @@ Feature: to interact with objects in the context
     And it is not true that it is not true that it is not true that it is not true that test is equal to "true"
     And it is not true that within 100ms it is not true that during 100ms it is not true that test is equal to "true"
 
-  Scenario Template:
+  Scenario Template: some additional conditional chain guards
     Given that if <shouldDoTask> == true => after 100ms taskDone is "true"
     Then if <shouldDoTask> == true => within 110ms taskDone is equal to "true"
 
     Examples:
       | shouldDoTask |
       | true         |
       | false        |
+
+  Scenario: concatenate multiple arrays using handlebars helper
+    Given that myFirstArray is:
+    """
+    - firstItem
+    - secondItem
+    """
+    And that mySecondArray is:
+    """
+    - thirdItem
+    - fourthItem
+    """
+    And that myThirdArray is:
+    """
+    - fifthItem
+    - sixthItem
+    """
+
+    When resultArray is:
+    """
+    {{#concat myFirstArray mySecondArray myThirdArray}}
+      {{this}}
+    {{/concat}}
+    """
+
+    Then resultArray is equal to:
+    """
+    [firstItem, secondItem, thirdItem, fourthItem, fifthItem, sixthItem]
+    """