Added comments and renamed methods

Author: amandelpie

utbot-sample/src/main/java/guava/examples/math/Stats.java

@@ -27,7 +27,7 @@ public final class Stats implements Serializable {
   private final double max;
 
   /**
-   * Internal constructor. Users should use {@link #of} or {@link StatsAccumulator#snapshot}.
+   * Internal constructor. Users should use {@link #ofIterable} or {@link StatsAccumulator#snapshot}.
    *
    * <p>To ensure that the created instance obeys its contract, the parameters should satisfy the
    * following constraints. This is the callers responsibility and is not enforced here.
@@ -54,7 +54,7 @@ public final class Stats implements Serializable {
    * @param values a series of values, which will be converted to {@code double} values (this may
    *     cause loss of precision)
    */
-  public static Stats of(Iterable<? extends Number> values) {
+  public static Stats ofIterable(Iterable<? extends Number> values) {
     StatsAccumulator accumulator = new StatsAccumulator();
     accumulator.addAll(values);
     return accumulator.snapshot();
@@ -66,7 +66,7 @@ public static Stats of(Iterable<? extends Number> values) {
    * @param values a series of values, which will be converted to {@code double} values (this may
    *     cause loss of precision)
    */
-  public static Stats of5(Iterator<? extends Number> values) {
+  public static Stats ofIterator(Iterator<? extends Number> values) {
     StatsAccumulator accumulator = new StatsAccumulator();
     accumulator.addAll(values);
     return accumulator.snapshot();
@@ -77,7 +77,7 @@ public static Stats of5(Iterator<? extends Number> values) {
    *
    * @param values a series of values
    */
-  public static Stats of1(double... values) {
+  public static Stats ofDoubles(double... values) {
     StatsAccumulator acummulator = new StatsAccumulator();
     acummulator.addAll(values);
     return acummulator.snapshot();
@@ -88,7 +88,7 @@ public static Stats of1(double... values) {
    *
    * @param values a series of values
    */
-  public static Stats of2(int... values) {
+  public static Stats ofInts(int... values) {
     StatsAccumulator acummulator = new StatsAccumulator();
     acummulator.addAll(values);
     return acummulator.snapshot();
@@ -100,7 +100,7 @@ public static Stats of2(int... values) {
    * @param values a series of values, which will be converted to {@code double} values (this may
    *     cause loss of precision for longs of magnitude over 2^53 (slightly over 9e15))
    */
-  public static Stats of3(long... values) {
+  public static Stats ofLongs(long... values) {
     StatsAccumulator acummulator = new StatsAccumulator();
     acummulator.addAll(values);
     return acummulator.snapshot();

utbot-summary-tests/src/test/kotlin/math/SummaryOfMath.kt

@@ -6,6 +6,12 @@ import org.junit.jupiter.api.Test
 import org.utbot.examples.DoNotCalculate
 import org.utbot.framework.plugin.api.MockStrategyApi
 
+/**
+ * It runs test generation for the poor analogue of the Stats.of method ported from the guava-26.0 framework
+ * and validates generated docs, display names and test method names.
+ *
+ * @see <a href="https://github.com/UnitTestBot/UTBotJava/issues/198">Related issue</a>
+ */
 class SummaryOfMath : SummaryTestCaseGeneratorTest(
     Stats::class,
 ) {
@@ -43,7 +49,7 @@ class SummaryOfMath : SummaryTestCaseGeneratorTest(
         val displayName3 = "addAll -> return new Stats(count, mean, sumOfSquaresOfDeltas, min, max)"
         val displayName4 = "addAll -> return new Stats(count, mean, sumOfSquaresOfDeltas, min, max)"
 
-        val method = Stats::of2
+        val method = Stats::ofInts
         val mockStrategy = MockStrategyApi.NO_MOCKS
         val coverage = DoNotCalculate