add helper method for parsing multiline String to DslParams

src/main/java/com/lmax/simpledsl/api/DslParams.java

@@ -64,6 +64,27 @@ static DslParams create(String[] args, DslArg... arguments)
         return new DslParamsParser().parse(args, arguments);
     }
 
+    /**
+     * Create new {@link DslParams} from multiline args. Useful for passing Java text blocks.
+     *
+     * <pre>
+     *     publicAPI.placeOrder("""
+     *         FTSE100
+     *         side: buy
+     *         quantity: 10
+     *         price: 5000
+     *         expectedStatus: UNMATCHED
+     *         """);
+     * </pre>
+     *
+     * @param multilineArgs the values
+     * @param arguments the {@link DslArg multilineArgs}
+     * @return the new {@link DslParams}
+     */
+    static DslParams create(String multilineArgs, DslArg... arguments)
+    {
+        return new DslParamsParser().parse(multilineArgs.split("\\R"), arguments);
+    }
 
     /**
      * A shorthand way to create a {@link DslParams} instance that accepts a single required parameter and return the

src/test/java/com/lmax/simpledsl/internal/DslParamsParserTest.java

@@ -936,6 +936,46 @@ public void maybeShouldThrowExceptionIfRequiredParametersArePassedOutOfOrder()
         assertEquals("Unexpected ambiguous argument 1", exception.getMessage());
     }
 
+    @Test
+    public void canCreateDslParamsFromMultilineTextBlock()
+    {
+        final DslParams fromVarargs = DslParams.create(new String[]{"arg1: ags", "arg2: dan", "arg3: simon"},
+                new RequiredArg("arg1"),
+                new RequiredArg("arg2"),
+                new RequiredArg("arg3"));
+
+        final DslParams fromMultiline = DslParams.create("arg1: ags\narg2: dan\narg3: simon\n",
+                new RequiredArg("arg1"),
+                new RequiredArg("arg2"),
+                new RequiredArg("arg3"));
+
+        final DslParams fromMultilineWindows = DslParams.create("arg1: ags\r\narg2: dan\r\narg3: simon\r\n",
+                new RequiredArg("arg1"),
+                new RequiredArg("arg2"),
+                new RequiredArg("arg3"));
+
+        final DslParams fromMultilineMac = DslParams.create("arg1: ags\rarg2: dan\rarg3: simon\r",
+                new RequiredArg("arg1"),
+                new RequiredArg("arg2"),
+                new RequiredArg("arg3"));
+
+        assertEquals("ags", fromMultiline.value("arg1"));
+        assertEquals("dan", fromMultiline.value("arg2"));
+        assertEquals("simon", fromMultiline.value("arg3"));
+
+        assertEquals("ags", fromMultilineWindows.value("arg1"));
+        assertEquals("dan", fromMultilineWindows.value("arg2"));
+        assertEquals("simon", fromMultilineWindows.value("arg3"));
+
+        assertEquals("ags", fromMultilineMac.value("arg1"));
+        assertEquals("dan", fromMultilineMac.value("arg2"));
+        assertEquals("simon", fromMultilineMac.value("arg3"));
+
+        assertEquals(fromVarargs.value("arg1"), fromMultiline.value("arg1"));
+        assertEquals(fromVarargs.value("arg2"), fromMultiline.value("arg2"));
+        assertEquals(fromVarargs.value("arg3"), fromMultiline.value("arg3"));
+    }
+
     private enum PossiblePets
     {
         COW,