. dt document currently supported Reporters when using EnvironmentalVariableReporter

Author: LarsEckart

approvaltests-tests/src/test/java/org/approvaltests/reporters/EnvironmentVariableReporterTest.java

@@ -2,10 +2,11 @@
 
 import org.approvaltests.Approvals;
 import org.approvaltests.core.Options;
-import org.junit.jupiter.api.Assertions;
 import org.junit.jupiter.api.Test;
 
-import static org.junit.jupiter.api.Assertions.*;
+import java.util.List;
+import java.util.Set;
+import java.util.stream.Collectors;
 
 public class EnvironmentVariableReporterTest
 {
@@ -26,4 +27,11 @@ public void testEnvironmentVariable()
       EnvironmentVariableReporter.ENVIRONMENT_VARIABLES = System::getenv;
     }
   }
+  @Test
+  void testValidEnvironmentalValues()
+  {
+    Set<String> reporters = new EnvironmentVariableReporter().getReporterMapping().keySet();
+    List<String> sortedReporters = reporters.stream().sorted().collect(Collectors.toList());
+    Approvals.verifyAll("", sortedReporters, x -> x);
+  }
 }

approvaltests-tests/src/test/java/org/approvaltests/reporters/EnvironmentVariableReporterTest.testValidEnvironmentalValues.approved.txt

@@ -0,0 +1,27 @@
+AraxisMergeReporter
+AutoApproveReporter
+AutoApproveWhenEmptyReporter
+BeyondCompareReporter
+ClipboardReporter
+CodeCompareReporter
+DelayedClipboardReporter
+DiffMergeReporter
+DiffReporter
+FileCaptureReporter
+ImageReporter
+ImageWebReporter
+IntelliJReporter
+JunitReporter
+KDiff3Reporter
+KaleidoscopeDiffReporter
+MeldMergeReporter
+P4MergeReporter
+PitReporter
+QuietReporter
+TestNgReporter
+TextWebReporter
+TkDiffReporter
+TortoiseDiffReporter
+VisualStudioCodeReporter
+WinMergeReporter
+WindowsDiffReporter

approvaltests/docs/how_to/ConfigureReporters.md

@@ -91,35 +91,7 @@ Lastly, it is possible to set the `APPROVAL_TESTS_USE_REPORTER` environment vari
 
 The environment variable can take any combination of the following values. Multiple values should be separated by a comma, without whitespace.
 
-```java
-"AraxisMergeReporter",
-"AutoApproveReporter",
-"AutoApproveWhenEmptyReporter",
-"BeyondCompareReporter",
-"ClipboardReporter",
-"CodeCompareReporter",
-"DelayedClipboardReporter",
-"DiffMergeReporter",
-"DiffReporter",
-"FileCaptureReporter",
-"ImageReporter",
-"ImageWebReporter",
-"IntelliJReporter",
-"JunitReporter",
-"KDiff3Reporter",
-"KaleidoscopeDiffReporter",
-"MeldMergeReporter",
-"P4MergeReporter",
-"PitReporter",
-"QuietReporter",
-"TestNgReporter",
-"TextWebReporter",
-"TkDiffReporter",
-"TortoiseDiffReporter",
-"VisualStudioCodeReporter",
-"WinMergeReporter",
-"WindowsDiffReporter",
-```
+snippets: EnvironmentVariableReporterTest.testValidEnvironmentalValues.approved.txt
 
 For example, setting `APPROVAL_TESTS_USE_REPORTER=AutoApproveReporter` allows you to approve all pending changes at once
 without modifying the source code and rebuilding the code to temporarily choose a different reporter. Similarly, setting

approvaltests/src/main/java/org/approvaltests/reporters/EnvironmentVariableReporter.java

@@ -78,4 +78,8 @@ public boolean report(String received, String approved)
     { return false; }
     return reporter.report(received, approved);
   }
+  public Map<String, Class> getReporterMapping()
+  {
+    return new HashMap<>(REPORTER_MAP);
+  }
 }