code(utils/formatter) - introduce newline separator for prevent escap…

…ing in json

README.md

@@ -962,7 +962,7 @@ type CalculatedConfig struct {
 
 **fResRaw** - result in bytes format
 
-**reverse([]T)** - return reverse array
+**FNewLine** - new line separator
 
 ```json
 {

pkg/utils/expression.go

@@ -7,16 +7,19 @@ import (
 )
 
 const (
-	fitterResultJsonRef = "fResJson"
-	fitterResultRef     = "fRes"
-	fitterIndexRef      = "fIndex"
-	fitterResultRaw     = "fResRaw"
+	fitterResultJsonRef           = "fResJson"
+	fitterResultRef               = "fRes"
+	fitterIndexRef                = "fIndex"
+	fitterResultRaw               = "fResRaw"
+	fitterNewLinePlaceholderKey   = "FNewLine"
+	fitterNewLinePlaceholderValue = "$__FLINE__$"
 )
 
 var (
 	defEnv = map[string]interface{}{
-		"FNull": builder.NullValue,
-		"FNil":  nil,
+		fitterNewLinePlaceholderKey: fitterNewLinePlaceholderValue,
+		"FNull":                     builder.NullValue,
+		"FNil":                      nil,
 		"isNull": func(value interface{}) bool {
 			return builder.NullValue == value
 		},

pkg/utils/formatter.go

@@ -49,7 +49,7 @@ func Format(str string, value builder.Interfacable, index *uint32, input builder
 		str = strings.ReplaceAll(str, humanIndexPlaceHolder, fmt.Sprintf("%d", *index+1))
 	}
 
-	return formatJsonPathString(str, value, index, input)
+	return strings.ReplaceAll(formatJsonPathString(str, value, index, input), fitterNewLinePlaceholderValue, "\n")
 }
 
 func processPrefix(prefix string, value builder.Interfacable, index *uint32, input builder.Interfacable) string {

pkg/utils/formatter_test.go

@@ -53,6 +53,10 @@ func (s *TestFormatterSuite) TestFile() {
 	assert.Equal(s.T(), "hi 14 test end", utils.Format("{{{FromExp='hi ' + '{{{FromFile=./test_formatted_file.log}}}' + ' end'}}}", nil, nil, nil))
 }
 
+func (s *TestFormatterSuite) TestNewLineSeparator() {
+	assert.Equal(s.T(), "\n", utils.Format("$__FLINE__$", nil, nil, nil))
+}
+
 func (s *TestFormatterSuite) TestExpr() {
 	index := uint32(1)
 	assert.Equal(s.T(), "8", utils.Format("{{{FromExp=fRes + 5 + fIndex}}}", builder.Number(2), &index, nil))