/*
    * SPDX-FileCopyrightText: Copyright (c) 2011-2026 Yegor Bugayenko
    * SPDX-License-Identifier: MIT
    */
   package com.qulice.checkstyle;
   
   import com.jcabi.log.Logger;
   import com.puppycrawl.tools.checkstyle.Checker;
   import com.puppycrawl.tools.checkstyle.ConfigurationLoader;
  import com.puppycrawl.tools.checkstyle.PropertiesExpander;
  import com.puppycrawl.tools.checkstyle.api.AuditEvent;
  import com.puppycrawl.tools.checkstyle.api.CheckstyleException;
  import com.puppycrawl.tools.checkstyle.api.Configuration;
  import com.qulice.spi.Environment;
  import com.qulice.spi.Relative;
  import com.qulice.spi.ResourceValidator;
  import com.qulice.spi.Violation;
  import java.io.File;
  import java.util.Collection;
  import java.util.LinkedList;
  import java.util.List;
  import java.util.Locale;
  import java.util.Properties;
  import java.util.Set;
  import org.xml.sax.InputSource;
  
  /**
   * Validator with Checkstyle.
   * @since 0.3
   * @checkstyle ClassDataAbstractionCoupling (260 lines)
   */
  public final class CheckstyleValidator implements ResourceValidator {
  
      /**
       * Extensions of files that are passed to Checkstyle. These match the
       * file extensions referenced by checks in {@code checks.xml}. Checkstyle
       * itself filters further based on each module's {@code fileExtensions}.
       */
      private static final Set<String> EXTENSIONS = Set.of(
          "java", "txt", "xml", "xsl", "xsd", "properties", "groovy", "vm",
          "mf", "sh", "sql", "tokens", "g", "spec", "css", "csv", "js", "json",
          "md", "yml", "yaml", "gradle", "dtd", "scss", "html"
      );
  
      /**
       * Checkstyle checker.
       */
      private final Checker checker;
  
      /**
       * Listener of checkstyle messages.
        */
      private final CheckstyleListener listener;
  
      /**
       * Environment to use.
       */
      private final Environment env;
  
      /**
       * Constructor.
       * @param env Environment to use
       */
      public CheckstyleValidator(final Environment env) {
          this.env = env;
          this.checker = new Checker();
          this.listener = new CheckstyleListener(this.env);
      }
  
      @Override
      public Collection<Violation> validate(final Collection<File> files) {
          this.checker.setModuleClassLoader(
              Thread.currentThread().getContextClassLoader()
          );
          try {
              this.checker.configure(this.configuration());
          } catch (final CheckstyleException ex) {
              throw new IllegalStateException("Failed to configure checker", ex);
          }
          this.checker.addListener(this.listener);
          final List<File> sources = this.getNonExcludedFiles(files);
          final Collection<Violation> results = new LinkedList<>();
          if (sources.isEmpty()) {
              Logger.debug(
                  this,
                  "No files to check with Checkstyle, all %d are excluded",
                  files.size()
              );
          } else {
              try {
                  Logger.debug(this, "Checkstyle processing %d files", sources.size());
                  this.checker.process(sources);
                  Logger.debug(this, "Checkstyle processed %d files", sources.size());
              } catch (final CheckstyleException ex) {
                  throw new IllegalStateException("Failed to process files", ex);
              }
              for (final AuditEvent event : this.listener.events()) {
                  final String check = event.getSourceName();
                  results.add(
                     new Violation.Default(
                         this.name(),
                         check.substring(check.lastIndexOf('.') + 1),
                         event.getFileName(),
                         String.valueOf(event.getLine()),
                         event.getMessage()
                     )
                 );
             }
         }
         return results;
     }
 
     @Override public String name() {
         return "Checkstyle";
     }
 
     /**
      * Filters out excluded files from further validation.
      * @param files Files to validate
      * @return List of relevant files
      */
     public List<File> getNonExcludedFiles(final Collection<File> files) {
         final List<File> relevant = new LinkedList<>();
         for (final File file : files) {
             final String name = new Relative(this.env.basedir(), file).path();
             if (this.env.exclude("checkstyle", name)) {
                 continue;
             }
             final int dot = name.lastIndexOf('.');
             if (dot < 0) {
                 continue;
             }
             final String ext = name.substring(dot + 1).toLowerCase(Locale.ROOT);
             if (!CheckstyleValidator.EXTENSIONS.contains(ext)) {
                 continue;
             }
             relevant.add(file);
         }
         return relevant;
     }
 
     /**
      * Load checkstyle configuration.
      * @return The configuration just loaded
      * @see #validate(Collection)
      */
     private Configuration configuration() {
         final File cache =
             new File(this.env.tempdir(), "checkstyle/checkstyle.cache");
         final File parent = cache.getParentFile();
         if (!parent.exists() && !parent.mkdirs()) {
             throw new IllegalStateException(
                 String.format(
                     "Unable to create directories needed for %s",
                     cache.getPath()
                 )
             );
         }
         if (!parent.canWrite()) {
             throw new IllegalStateException(
                 String.format(
                     "Cannot write to %s, check filesystem permissions",
                     parent.getAbsolutePath()
                 )
             );
         }
         final Properties props = new Properties();
         props.setProperty("cache.file", cache.getPath());
         final Configuration config;
         try (java.io.InputStream stream = this.getClass().getResourceAsStream("checks.xml")) {
             if (stream == null) {
                 throw new IllegalStateException(
                     "Checkstyle configuration file 'checks.xml' not found in classpath."
                 );
             }
             config = ConfigurationLoader.loadConfiguration(
                 new InputSource(stream),
                 new PropertiesExpander(props),
                 ConfigurationLoader.IgnoredModulesOptions.OMIT
             );
         } catch (final CheckstyleException | java.io.IOException ex) {
             throw new IllegalStateException("Failed to load config", ex);
         }
         return config;
     }
 }