. d reformatted code and updated markdown snippets

Author: actions-user

approvaltests-util/docs/ArrayUtils.md

@@ -21,7 +21,7 @@ comparables.add(3.1415);
 comparables.add("Lars");
 Comparable[] comparableArray = ArrayUtils.toArray(comparables);
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/ArrayUtilsTest.java#L101-L108' title='Snippet source file'>snippet source</a> | <a href='#snippet-toArray' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/ArrayUtilsTest.java#L105-L112' title='Snippet source file'>snippet source</a> | <a href='#snippet-toArray' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 This works in almost all cases with the notable exceptions of empty arrays, some common interfaces 
@@ -32,7 +32,7 @@ In which case you can always use the overloaded method
 ```java
 Comparable[] array = ArrayUtils.toArray(comparables, Comparable.class);
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/ArrayUtilsTest.java#L109-L111' title='Snippet source file'>snippet source</a> | <a href='#snippet-toArrayWithClass' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/ArrayUtilsTest.java#L113-L115' title='Snippet source file'>snippet source</a> | <a href='#snippet-toArrayWithClass' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 

approvaltests-util/docs/Features.md

@@ -52,7 +52,7 @@ For Example Action3 has the single method:
 ```java
 public void call(In1 a, In2 b, In3 c);
 ```
-<sup><a href='/approvaltests-util/src/main/java/org/lambda/actions/Action3.java#L10-L12' title='Snippet source file'>snippet source</a> | <a href='#snippet-action3_call' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util/src/main/java/org/lambda/actions/Action3.java#L11-L13' title='Snippet source file'>snippet source</a> | <a href='#snippet-action3_call' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 The first 3 have native java equivalents (that are hard to remember).  

approvaltests-util/docs/StringUtils.md

@@ -23,7 +23,7 @@ For example
 List<Integer> number = Arrays.asList(1, 2, 3, 4, 5);
 String text = StringUtils.join(number, ", ");
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/StringUtilsTest.java#L66-L69' title='Snippet source file'>snippet source</a> | <a href='#snippet-join_collection' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/StringUtilsTest.java#L71-L74' title='Snippet source file'>snippet source</a> | <a href='#snippet-join_collection' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 will produce
 <!-- snippet: /approvaltests-util-tests/src/test/java/com/spun/util/StringUtilsTest.testJoinCollection.approved.txt -->
@@ -44,7 +44,7 @@ For example:
 List<Integer> number = Arrays.asList(1, 2, 3, 4, 5);
 String text = StringUtils.join(number, ", ", n -> StringUtils.padNumber(n, 3));
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/StringUtilsTest.java#L75-L78' title='Snippet source file'>snippet source</a> | <a href='#snippet-join_collection_with_lambda' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/StringUtilsTest.java#L81-L84' title='Snippet source file'>snippet source</a> | <a href='#snippet-join_collection_with_lambda' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 will Produce
 <!-- snippet: /approvaltests-util-tests/src/test/java/com/spun/util/StringUtilsTest.testJoinCollectionWithFunction.approved.txt -->

approvaltests-util/docs/how_to/CaptureLogs.md

@@ -25,7 +25,7 @@ StringBuffer log = SimpleLogger.logToString();
 new Sample().methodThatLogs();
 Approvals.verify(log);
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/logger/SimpleLoggerTest.java#L35-L39' title='Snippet source file'>snippet source</a> | <a href='#snippet-log_to_string' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/logger/SimpleLoggerTest.java#L36-L40' title='Snippet source file'>snippet source</a> | <a href='#snippet-log_to_string' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 ## See also

approvaltests-util/docs/how_to/ExtendQueryable.md

@@ -20,7 +20,7 @@ public static Queryable<String> findFirstWordsOnly(List<String> words)
   });
 }
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryableTest.java#L36-L51' title='Snippet source file'>snippet source</a> | <a href='#snippet-custom-query' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryableTest.java#L38-L53' title='Snippet source file'>snippet source</a> | <a href='#snippet-custom-query' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 You can add this to Queryable by implementing the `com.lambda.utils.Extendable` interface.
 <!-- snippet: implementing-extendable -->
@@ -35,7 +35,7 @@ public static class CustomQuery implements Extendable<List<String>>
     this.caller = caller;
   }
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryableTest.java#L20-L29' title='Snippet source file'>snippet source</a> | <a href='#snippet-implementing-extendable' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryableTest.java#L20-L30' title='Snippet source file'>snippet source</a> | <a href='#snippet-implementing-extendable' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 Now you can add extension methods that are **not static**
 <!-- snippet: extendable-query -->
@@ -46,7 +46,7 @@ public Queryable<String> findFirstWordsOnly()
   return findFirstWordsOnly(caller);
 }
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryableTest.java#L30-L35' title='Snippet source file'>snippet source</a> | <a href='#snippet-extendable-query' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryableTest.java#L31-L37' title='Snippet source file'>snippet source</a> | <a href='#snippet-extendable-query' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 and now you can call it as such
 <!-- snippet: custom-query-example -->
@@ -56,7 +56,7 @@ Queryable<String> list = Queryable.as("One fish", "two fish", "red fish", "blue
 Queryable<String> firstWordsOnlyWithExtension = list.select(String::toUpperCase).use(CustomQuery.class)
     .findFirstWordsOnly();
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryableTest.java#L56-L60' title='Snippet source file'>snippet source</a> | <a href='#snippet-custom-query-example' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryableTest.java#L58-L62' title='Snippet source file'>snippet source</a> | <a href='#snippet-custom-query-example' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 whereas previously you had to use
 <!-- snippet: custom-query-example-static -->
@@ -65,7 +65,7 @@ whereas previously you had to use
 Queryable<String> firstWordsOnlyStatic = CustomQuery
     .findFirstWordsOnly(Query.select(list, String::toUpperCase));
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryableTest.java#L61-L64' title='Snippet source file'>snippet source</a> | <a href='#snippet-custom-query-example-static' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryableTest.java#L63-L66' title='Snippet source file'>snippet source</a> | <a href='#snippet-custom-query-example-static' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 ## See also

approvaltests-util/docs/how_to/LoadersAndSavers.md

@@ -52,7 +52,7 @@ public void sendOutSeniorDiscounts(DataBase database, MailServer mailServer)
   }
 }
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/persistence/LoadersAndSaversExamplesTest.java#L68-L79' title='Snippet source file'>snippet source</a> | <a href='#snippet-step1' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/persistence/LoadersAndSaversExamplesTest.java#L71-L82' title='Snippet source file'>snippet source</a> | <a href='#snippet-step1' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 In this case, we want to replace the functions that use the DataBase object with Loaders :
@@ -72,7 +72,7 @@ public void senior_customer_list_includes_only_those_over_age_65()
   Approvals.verifyAll("", mailServer.getRecipients());
 }
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/persistence/LoadersAndSaversExamplesTest.java#L16-L25' title='Snippet source file'>snippet source</a> | <a href='#snippet-step0' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/persistence/LoadersAndSaversExamplesTest.java#L16-L26' title='Snippet source file'>snippet source</a> | <a href='#snippet-step0' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 This test works against a live database with a live mail server.
@@ -94,7 +94,7 @@ Now we dump the data resulting from a successful query so that we can create a f
 List<Customer> seniorCustomers = database.getSeniorCustomers();
 seniorCustomers.stream().forEach(System.out::println);
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/persistence/LoadersAndSaversExamplesTest.java#L47-L50' title='Snippet source file'>snippet source</a> | <a href='#snippet-step_capture_data' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/persistence/LoadersAndSaversExamplesTest.java#L50-L53' title='Snippet source file'>snippet source</a> | <a href='#snippet-step_capture_data' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 generates
@@ -116,7 +116,7 @@ Step 3: Create a result object populated with these values (or at least enough o
 List.of(new Customer("Bob, Jones, 123 Elm St., Tempe, AZ, 14-MAR-1958"),
     new Customer("Mary, Smith, 345 Oak St., Mason, VA, 04-MAY-1944"));
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/persistence/LoadersAndSaversExamplesTest.java#L59-L62' title='Snippet source file'>snippet source</a> | <a href='#snippet-step_fake_data' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/persistence/LoadersAndSaversExamplesTest.java#L62-L65' title='Snippet source file'>snippet source</a> | <a href='#snippet-step_fake_data' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 ### Step 4: In the original method, replace the function call with a Loader

approvaltests-util/docs/how_to/UseMutablesInLambdas.md

@@ -61,7 +61,7 @@ scheduler.rsvp();
 i.set("Steve");
 scheduler.bookHotel();
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/utils/MutableTest.java#L20-L28' title='Snippet source file'>snippet source</a> | <a href='#snippet-mutable_example' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/utils/MutableTest.java#L21-L29' title='Snippet source file'>snippet source</a> | <a href='#snippet-mutable_example' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 Will produce the following:

approvaltests-util/docs/how_to/VarArgsWithAtleastOne.md

@@ -27,7 +27,7 @@ public Integer findSmallest(Integer... numbers)
   { throw new IllegalArgumentException("you must have at least one number"); }
   // rest of the code
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/MinimumVarargSamples.java#L20-L26' title='Snippet source file'>snippet source</a> | <a href='#snippet-minimalVarargsRuntime' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/MinimumVarargSamples.java#L21-L27' title='Snippet source file'>snippet source</a> | <a href='#snippet-minimalVarargsRuntime' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 ### Compile time solution
@@ -44,7 +44,7 @@ public Integer findSmallest(Integer first, Integer... numbers)
   Integer[] combined = ArrayUtils.combine(first, numbers);
   // rest of the code
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/MinimumVarargSamples.java#L29-L34' title='Snippet source file'>snippet source</a> | <a href='#snippet-minimalVarargsCompileTime' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/MinimumVarargSamples.java#L31-L36' title='Snippet source file'>snippet source</a> | <a href='#snippet-minimalVarargsCompileTime' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 ### Advantages

approvaltests-util/docs/reference/Query.md

@@ -31,7 +31,7 @@ Integer[] numbers = Range.get(1, 20);
 Integer[] evenQueryNumbers = Query.where(numbers, n -> n % 2 == 0).orderBy(OrderBy.Order.Descending, n -> n)
     .asArray();
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryTest.java#L37-L41' title='Snippet source file'>snippet source</a> | <a href='#snippet-query_example' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryTest.java#L39-L43' title='Snippet source file'>snippet source</a> | <a href='#snippet-query_example' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 Here is the exact same function but using Java Streams:
@@ -42,7 +42,7 @@ Here is the exact same function but using Java Streams:
 Integer[] evenStreamNumbers = Arrays.stream(numbers).filter(n -> n % 2 == 0)
     .sorted((o1, o2) -> o2.compareTo(o1)).toArray(Integer[]::new);
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryTest.java#L42-L45' title='Snippet source file'>snippet source</a> | <a href='#snippet-stream_example' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryTest.java#L44-L47' title='Snippet source file'>snippet source</a> | <a href='#snippet-stream_example' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 Another example using sum() vs. reduce():
@@ -53,7 +53,7 @@ Another example using sum() vs. reduce():
 String[] names = {"Llewellyn", "Scott"};
 int lengthsFromQuery = Query.sum(names, n -> n.length()).intValue();
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryTest.java#L49-L52' title='Snippet source file'>snippet source</a> | <a href='#snippet-query_sum_example' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryTest.java#L51-L54' title='Snippet source file'>snippet source</a> | <a href='#snippet-query_sum_example' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 Here is the exact same function but using Java Streams:
@@ -63,7 +63,7 @@ Here is the exact same function but using Java Streams:
 ```java
 int lengthsFromStream = (int) Arrays.stream(names).map(n -> n.length()).reduce(0, (a, b) -> a + b);
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryTest.java#L53-L55' title='Snippet source file'>snippet source</a> | <a href='#snippet-stream_sum_example' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryTest.java#L55-L57' title='Snippet source file'>snippet source</a> | <a href='#snippet-stream_sum_example' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 #### Other benefits
@@ -82,7 +82,7 @@ Using Query:
 ```java
 List<String> strings = Query.select(numbers, n -> "" + n);
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryTest.java#L60-L62' title='Snippet source file'>snippet source</a> | <a href='#snippet-list_is_queryable' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryTest.java#L62-L64' title='Snippet source file'>snippet source</a> | <a href='#snippet-list_is_queryable' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 Using Streams:
@@ -91,7 +91,7 @@ Using Streams:
 ```java
 List<String> strings2 = Arrays.stream(numbers).map(n -> "" + n).collect(Collectors.toList());
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryTest.java#L63-L65' title='Snippet source file'>snippet source</a> | <a href='#snippet-list_from_stream' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryTest.java#L65-L67' title='Snippet source file'>snippet source</a> | <a href='#snippet-list_from_stream' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 ### API
@@ -119,7 +119,7 @@ Queryable<String> names = Queryable.as("Now is the time", "Fourscore and seven y
     "When in the course of human events");
 Queryable<String> allNames = names.selectMany(n -> Arrays.asList(n.split(" "))).orderBy(n -> n);
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryableTest.java#L143-L147' title='Snippet source file'>snippet source</a> | <a href='#snippet-queryable_select_many' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryableTest.java#L152-L156' title='Snippet source file'>snippet source</a> | <a href='#snippet-queryable_select_many' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 resulting in
@@ -157,7 +157,7 @@ Here is a simple example of grouping words by their first letter.
 Queryable<String> words = Queryable.as("Jack", "and", "Jill", "jumped", "up", "the", "hill");
 Queryable<Entry<Character, Queryable<String>>> result = words.groupBy(w -> w.toLowerCase().charAt(0));
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryableTest.java#L153-L156' title='Snippet source file'>snippet source</a> | <a href='#snippet-group_by_key' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryableTest.java#L163-L166' title='Snippet source file'>snippet source</a> | <a href='#snippet-group_by_key' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 producing:
 <!-- snippet: QueryableTest.testGroupBy.approved.txt -->
@@ -185,7 +185,7 @@ Queryable<String> words = Queryable.as("One Fish Two Fish Red Fish Blue Fish".sp
 Queryable<Entry<Object, Object>> result = words.groupBy(w -> w.length(), w -> w.toLowerCase(),
     r -> r.join("_"));
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryableTest.java#L176-L180' title='Snippet source file'>snippet source</a> | <a href='#snippet-group_by_full' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryableTest.java#L189-L193' title='Snippet source file'>snippet source</a> | <a href='#snippet-group_by_full' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 resulting in
 <!-- snippet: QueryableTest.testGroupByCombineWordsOfSimilarLengths.approved.txt -->