///////////////////////////////////////////////////////////////////////////////////////////////
   // checkstyle: Checks Java source code and other text files for adherence to a set of rules.
   // Copyright (C) 2001-2026 the original author or authors.
   //
   // This library is free software; you can redistribute it and/or
   // modify it under the terms of the GNU Lesser General Public
   // License as published by the Free Software Foundation; either
   // version 2.1 of the License, or (at your option) any later version.
   //
  // This library is distributed in the hope that it will be useful,
  // but WITHOUT ANY WARRANTY; without even the implied warranty of
  // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  // Lesser General Public License for more details.
  //
  // You should have received a copy of the GNU Lesser General Public
  // License along with this library; if not, write to the Free Software
  // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  ///////////////////////////////////////////////////////////////////////////////////////////////
  
  package com.puppycrawl.tools.checkstyle.checks.javadoc;
  
  import static com.google.common.truth.Truth.assertWithMessage;
  import static com.puppycrawl.tools.checkstyle.checks.javadoc.JavadocPackageCheck.MSG_LEGACY_PACKAGE_HTML;
  import static com.puppycrawl.tools.checkstyle.checks.javadoc.JavadocPackageCheck.MSG_PACKAGE_INFO;
  
  import java.io.File;
  import java.util.Collections;
  
  import org.junit.jupiter.api.Test;
  
  import com.puppycrawl.tools.checkstyle.AbstractModuleTestSupport;
  import com.puppycrawl.tools.checkstyle.api.CheckstyleException;
  import com.puppycrawl.tools.checkstyle.api.FileText;
  import com.puppycrawl.tools.checkstyle.internal.utils.TestUtil;
  import com.puppycrawl.tools.checkstyle.utils.CommonUtil;
  
  public class JavadocPackageCheckTest
      extends AbstractModuleTestSupport {
  
      @Override
      public String getPackageLocation() {
          return "com/puppycrawl/tools/checkstyle/checks/javadoc/javadocpackage";
      }
  
      @Test
      public void testMissing() throws Exception {
          final String[] expected = {
              "1: " + getCheckMessage(MSG_PACKAGE_INFO),
          };
          verifyWithInlineConfigParser(
              getPath("InputJavadocPackageBadCls.java"),
              expected);
      }
  
      @Test
      public void testMissingWithAllowLegacy() throws Exception {
          final String[] expected = {
              "1: " + getCheckMessage(MSG_PACKAGE_INFO),
          };
          verifyWithInlineConfigParser(
              getPath("InputJavadocPackageBadCls2.java"),
              expected);
      }
  
      @Test
      public void testWithMultipleFiles() throws Exception {
          final String[] expected = {
              "1: " + getCheckMessage(MSG_PACKAGE_INFO),
          };
          verifyWithInlineConfigParser(getPath("InputJavadocPackageNoJavadoc.java"),
              getPath("InputJavadocPackageBadTag.java"), expected);
      }
  
      @Test
      public void testBoth() throws Exception {
          final String[] expected = {
              "1: " + getCheckMessage(MSG_LEGACY_PACKAGE_HTML),
          };
          verifyWithInlineConfigParser(
              getPath("bothfiles" + File.separator + "InputJavadocPackageBothIgnored.java"),
              expected);
      }
  
      @Test
      public void testHtmlDisallowed() throws Exception {
          final String[] expected = {
              "1: " + getCheckMessage(MSG_PACKAGE_INFO),
          };
          verifyWithInlineConfigParser(
              getPath("packagehtml" + File.separator + "InputJavadocPackageHtmlIgnored.java"),
              expected);
      }
  
      @Test
      public void testHtmlAllowed() throws Exception {
          final String[] expected = CommonUtil.EMPTY_STRING_ARRAY;
          verifyWithInlineConfigParser(
              getPath("packagehtml" + File.separator + "InputJavadocPackageHtmlIgnored2.java"),
              getPath("noparentfile" + File.separator + "package-info.java"),
             expected);
     }
 
     @Test
     public void testAnnotation() throws Exception {
         final String[] expected = CommonUtil.EMPTY_STRING_ARRAY;
         verifyWithInlineConfigParser(
             getPath("annotation"
                     + File.separator + "package-info.java"), expected);
     }
 
     /**
      * Using direct call to check here because there is no other way
      * to reproduce exception with invalid canonical path.
      */
     @Test
     public void testCheckstyleExceptionIfFailedToGetCanonicalPathToFile() {
         final JavadocPackageCheck check = new JavadocPackageCheck();
         final File fileWithInvalidPath = new File("\u0000\u0000\u0000");
         final FileText mockFileText = new FileText(fileWithInvalidPath, Collections.emptyList());
         final String expectedExceptionMessage =
                 "Exception while getting canonical path to file " + fileWithInvalidPath.getPath();
         final CheckstyleException exc =
                 TestUtil.getExpectedThrowable(
                     CheckstyleException.class, () -> {
                         check.processFiltered(
                             fileWithInvalidPath, mockFileText);
                     });
         assertWithMessage(
                 "Invalid exception message. Expected: %s",
                 expectedExceptionMessage)
             .that(exc.getMessage())
             .isEqualTo(expectedExceptionMessage);
     }
 
     @Test
     public void testNonJava() throws Exception {
         final String[] expected = CommonUtil.EMPTY_STRING_ARRAY;
         verifyWithInlineConfigParser(
             getPath("InputJavadocPackageNotJava.txt"),
             expected);
     }
 
     @Test
     public void testWithFileWithoutParent() throws Exception {
         final String[] expected = CommonUtil.EMPTY_STRING_ARRAY;
         verifyWithInlineConfigParser(
                 getPath("annotation" + File.separator + "package-info.java"),
                 expected);
     }
 
 }