/*
    * SPDX-FileCopyrightText: Copyright (c) 2011-2026 Yegor Bugayenko
    * SPDX-License-Identifier: MIT
    */
   package com.qulice.checkstyle;
   
   import com.qulice.spi.Environment;
   import com.qulice.spi.Violation;
   import java.io.File;
  import java.io.IOException;
  import java.util.Collection;
  import org.cactoos.io.ResourceOf;
  import org.cactoos.text.FormattedText;
  import org.cactoos.text.IoCheckedText;
  import org.cactoos.text.TextOf;
  import org.hamcrest.MatcherAssert;
  import org.hamcrest.Matchers;
  import org.junit.jupiter.api.Test;
  
  /**
   * Test case for {@link CheckstyleValidator}'s handling of the
   * stock {@code ReturnCount} check, including a regression guard
   * against cross-test violation leakage (issue #547).
   *
   * @since 0.25.1
   */
  final class CheckstyleReturnCountTest {
  
      @Test
      void reportsErrorOnMoreThanOneReturnStatement() throws Exception {
          final String file = "ReturnCount.java";
          MatcherAssert.assertThat(
              "More than one return must be reported",
              this.runValidation(file, false),
              Matchers.hasItem(
                  new ViolationMatcher(
                      "Return count is 2 (max allowed for non-void methods/lambdas is 1)",
                      file
                  )
              )
          );
      }
  
      @Test
      void doesNotLeakViolationsBetweenTests() throws Exception {
          MatcherAssert.assertThat(
              "ReturnCount.java must not yield violations from ParametrizedClass.java",
              this.runValidation("ReturnCount.java", false),
              Matchers.not(
                  Matchers.hasItem(
                      new ViolationMatcher(
                          "Type Javadoc comment is missing @param <T> tag.",
                          "ReturnCount.java"
                      )
                  )
              )
          );
      }
  
      private Collection<Violation> runValidation(final String file,
          final boolean passes) throws IOException {
          final Environment.Mock mock = new Environment.Mock();
          final Environment env = mock.withParam(
              "license",
              String.format(
                  "file:%s",
                  new License().savePackageInfo(
                      new File(mock.basedir(), "src/main/java/foo")
                  ).withLines("Hello.")
                      .withEol(String.valueOf('\n')).file()
              )
          ).withFile(
              String.format("src/main/java/foo/%s", file),
              new IoCheckedText(
                  new TextOf(
                      new ResourceOf(
                          new FormattedText("com/qulice/checkstyle/%s", file)
                      )
                  )
              ).asString()
          );
          final Collection<Violation> results =
              new CheckstyleValidator(env).validate(env.files(file));
          MatcherAssert.assertThat(
              "validation result should match expected state",
              results.isEmpty(),
              Matchers.is(passes)
          );
          return results;
      }
  }