From 11d72fe14d057019c803b74eae6112d56e47c71a Mon Sep 17 00:00:00 2001
From: piyush kumar sadangi <piyushkumarsadangi@piyushs-MacBook-Air.local>
Date: Wed, 19 Jun 2024 13:11:38 +0530
Subject: [PATCH] Issue #1: Create a application what parses xdocs with example
 config specified

---
 AbstractClassName/Example1/config.xml         | 34 ++++++++++++++++++
 AbstractClassName/Example2/config.xml         | 36 +++++++++++++++++++
 AbstractClassName/Example3/config.xml         | 36 +++++++++++++++++++
 AbstractClassName/Example4/config.xml         | 36 +++++++++++++++++++
 .../main/java/com/example/extractor/Main.java |  5 +--
 .../example/extractor/MainsLauncherTest.java  |  2 +-
 6 files changed, 146 insertions(+), 3 deletions(-)
 create mode 100644 AbstractClassName/Example1/config.xml
 create mode 100644 AbstractClassName/Example2/config.xml
 create mode 100644 AbstractClassName/Example3/config.xml
 create mode 100644 AbstractClassName/Example4/config.xml

diff --git a/AbstractClassName/Example1/config.xml b/AbstractClassName/Example1/config.xml
new file mode 100644
index 000000000..73a06279b
--- /dev/null
+++ b/AbstractClassName/Example1/config.xml
@@ -0,0 +1,34 @@
+<?xml version="1.0"?>
+<!DOCTYPE module PUBLIC
+        "-//Checkstyle//DTD Checkstyle Configuration 1.3//EN"
+        "https://checkstyle.org/dtds/configuration_1_3.dtd">
+
+<module name = "Checker">
+    <property name="charset" value="UTF-8"/>
+
+    <!-- do not change severity to 'error', as that will hide errors caused by exceptions -->
+    <property name="severity" value="warning"/>
+
+    <!-- haltOnException is required for exception fixes and reporting of all exceptions -->
+    <property name="haltOnException" value="false"/>
+
+    <!-- BeforeExecutionFileFilters is required for sources of java9 -->
+    <module name="BeforeExecutionExclusionFileFilter">
+        <property name="fileNamePattern" value="module\-info\.java$" />
+    </module>
+
+    <module name="TreeWalker">
+        <module name="AbstractClassName"/>
+
+        <!-- usuppress javadoc parsing errors, as we test Check not a parser -->
+        <module name="SuppressionXpathSingleFilter">
+            <property name="message" value="Javadoc comment at column \d+ has parse error"/>
+        </module>
+    </module>
+
+    <!-- as we run on regression even on non-compiled files we need to skip exceptions on them -->
+    <module name="SuppressionSingleFilter">
+        <property name="checks" value="Checker"/>
+        <property name="message" value="Exception occurred while parsing"/>
+    </module>
+</module>
diff --git a/AbstractClassName/Example2/config.xml b/AbstractClassName/Example2/config.xml
new file mode 100644
index 000000000..f76b7b72f
--- /dev/null
+++ b/AbstractClassName/Example2/config.xml
@@ -0,0 +1,36 @@
+<?xml version="1.0"?>
+<!DOCTYPE module PUBLIC
+        "-//Checkstyle//DTD Checkstyle Configuration 1.3//EN"
+        "https://checkstyle.org/dtds/configuration_1_3.dtd">
+
+<module name = "Checker">
+    <property name="charset" value="UTF-8"/>
+
+    <!-- do not change severity to 'error', as that will hide errors caused by exceptions -->
+    <property name="severity" value="warning"/>
+
+    <!-- haltOnException is required for exception fixes and reporting of all exceptions -->
+    <property name="haltOnException" value="false"/>
+
+    <!-- BeforeExecutionFileFilters is required for sources of java9 -->
+    <module name="BeforeExecutionExclusionFileFilter">
+        <property name="fileNamePattern" value="module\-info\.java$" />
+    </module>
+
+    <module name="TreeWalker">
+        <module name="AbstractClassName">
+            <property name="ignoreModifier" value="true"/>
+        </module>
+
+        <!-- usuppress javadoc parsing errors, as we test Check not a parser -->
+        <module name="SuppressionXpathSingleFilter">
+            <property name="message" value="Javadoc comment at column \d+ has parse error"/>
+        </module>
+    </module>
+
+    <!-- as we run on regression even on non-compiled files we need to skip exceptions on them -->
+    <module name="SuppressionSingleFilter">
+        <property name="checks" value="Checker"/>
+        <property name="message" value="Exception occurred while parsing"/>
+    </module>
+</module>
diff --git a/AbstractClassName/Example3/config.xml b/AbstractClassName/Example3/config.xml
new file mode 100644
index 000000000..36fc30b73
--- /dev/null
+++ b/AbstractClassName/Example3/config.xml
@@ -0,0 +1,36 @@
+<?xml version="1.0"?>
+<!DOCTYPE module PUBLIC
+        "-//Checkstyle//DTD Checkstyle Configuration 1.3//EN"
+        "https://checkstyle.org/dtds/configuration_1_3.dtd">
+
+<module name = "Checker">
+    <property name="charset" value="UTF-8"/>
+
+    <!-- do not change severity to 'error', as that will hide errors caused by exceptions -->
+    <property name="severity" value="warning"/>
+
+    <!-- haltOnException is required for exception fixes and reporting of all exceptions -->
+    <property name="haltOnException" value="false"/>
+
+    <!-- BeforeExecutionFileFilters is required for sources of java9 -->
+    <module name="BeforeExecutionExclusionFileFilter">
+        <property name="fileNamePattern" value="module\-info\.java$" />
+    </module>
+
+    <module name="TreeWalker">
+        <module name="AbstractClassName">
+            <property name="ignoreName" value="true"/>
+        </module>
+
+        <!-- usuppress javadoc parsing errors, as we test Check not a parser -->
+        <module name="SuppressionXpathSingleFilter">
+            <property name="message" value="Javadoc comment at column \d+ has parse error"/>
+        </module>
+    </module>
+
+    <!-- as we run on regression even on non-compiled files we need to skip exceptions on them -->
+    <module name="SuppressionSingleFilter">
+        <property name="checks" value="Checker"/>
+        <property name="message" value="Exception occurred while parsing"/>
+    </module>
+</module>
diff --git a/AbstractClassName/Example4/config.xml b/AbstractClassName/Example4/config.xml
new file mode 100644
index 000000000..f78944496
--- /dev/null
+++ b/AbstractClassName/Example4/config.xml
@@ -0,0 +1,36 @@
+<?xml version="1.0"?>
+<!DOCTYPE module PUBLIC
+        "-//Checkstyle//DTD Checkstyle Configuration 1.3//EN"
+        "https://checkstyle.org/dtds/configuration_1_3.dtd">
+
+<module name = "Checker">
+    <property name="charset" value="UTF-8"/>
+
+    <!-- do not change severity to 'error', as that will hide errors caused by exceptions -->
+    <property name="severity" value="warning"/>
+
+    <!-- haltOnException is required for exception fixes and reporting of all exceptions -->
+    <property name="haltOnException" value="false"/>
+
+    <!-- BeforeExecutionFileFilters is required for sources of java9 -->
+    <module name="BeforeExecutionExclusionFileFilter">
+        <property name="fileNamePattern" value="module\-info\.java$" />
+    </module>
+
+    <module name="TreeWalker">
+        <module name="AbstractClassName">
+            <property name="format" value="^Generator.+$"/>
+        </module>
+
+        <!-- usuppress javadoc parsing errors, as we test Check not a parser -->
+        <module name="SuppressionXpathSingleFilter">
+            <property name="message" value="Javadoc comment at column \d+ has parse error"/>
+        </module>
+    </module>
+
+    <!-- as we run on regression even on non-compiled files we need to skip exceptions on them -->
+    <module name="SuppressionSingleFilter">
+        <property name="checks" value="Checker"/>
+        <property name="message" value="Exception occurred while parsing"/>
+    </module>
+</module>
diff --git a/extractor/src/main/java/com/example/extractor/Main.java b/extractor/src/main/java/com/example/extractor/Main.java
index 0ba588385..9212e5de1 100644
--- a/extractor/src/main/java/com/example/extractor/Main.java
+++ b/extractor/src/main/java/com/example/extractor/Main.java
@@ -1,3 +1,4 @@
+
 package com.example.extractor;
 
 import java.nio.file.*;
@@ -27,7 +28,7 @@ public static void main(String[] args) throws Exception {
         String inputDirectory = checkstyleRepoPath + "/" + pathInRepo;
 
         System.out.println("PROJECT_ROOT: " + PROJECT_ROOT);
-        Path outputDirectory = PROJECT_ROOT.resolve("AbbreviationAsWordInName");
+        Path outputDirectory = PROJECT_ROOT.resolve("AbstractClassName");
 
         // Process files in the input directory and save results to the output directory
         processFiles(inputDirectory, outputDirectory.toString());
@@ -103,4 +104,4 @@ private static void processFile(String exampleFile, Path outputPath) {
             e.printStackTrace();
         }
     }
-}
\ No newline at end of file
+}
diff --git a/extractor/src/test/java/com/example/extractor/MainsLauncherTest.java b/extractor/src/test/java/com/example/extractor/MainsLauncherTest.java
index 7a22d5e4e..4753af3c9 100644
--- a/extractor/src/test/java/com/example/extractor/MainsLauncherTest.java
+++ b/extractor/src/test/java/com/example/extractor/MainsLauncherTest.java
@@ -7,7 +7,7 @@ public class MainsLauncherTest {
     @Test
     public void testMain() throws Exception {
         // Define the path in repo you want to test
-        String pathInRepo = "src/xdocs-examples/resources/com/puppycrawl/tools/checkstyle/checks/naming/abbreviationaswordinname";
+        String pathInRepo = "src/xdocs-examples/resources/com/puppycrawl/tools/checkstyle/checks/naming/abstractclassname";
 
         // Pass the path as an argument
         Main.main(new String[]{pathInRepo});