feat(#65): add docs to README + get motives at runtime

Author: Marat-Tim

.github/motives.groovy

@@ -0,0 +1,25 @@
+/*
+ * SPDX-FileCopyrightText: Copyright (c) 2016-2025 Objectionary.com
+ * SPDX-License-Identifier: MIT
+ */
+package org.eolang.lints
+
+/**
+ * This script is run using gplus in the script motives.sh.
+ * It saves to a file named lint and the extension.md is the motive of this lint.
+ * All files are saved to the tmp folder
+ * @todo #65:30min after fixing this problem https://github.com/jcabi/jcabi-parent/issues/586,
+ * move this script to the src/main/groovy folder and write a test for it.
+ */
+
+static def saveLint(Lint<?> lint) {
+    new File("tmp/${lint.name()}.md").text = lint.motive()
+}
+
+new PkMono().forEach {
+    saveLint(it)
+}
+
+new PkWpa().forEach {
+    saveLint(it)
+}

.github/motives.sh

@@ -41,12 +41,15 @@ tail() {
   printf '</article></section></body></html>'
 }
 
+mkdir tmp
+mvn clean compile gplus:execute
+
 while IFS= read -r f; do
   n=$(basename "${f}" .md)
   html=gh-pages/${tag}/${n}.html
   ( head && pandoc "${f}" && tail ) > "${html}"
   echo "${n} -> $(du -b "${html}" | cut -f1) bytes"
-done < <(find src/main/resources/org/eolang/motives -name '*.md' | sort)
+done < <(find tmp -name '*.md' | sort)
 
 (
   head

pom.xml

@@ -534,6 +534,23 @@
           </execution>
         </executions>
       </plugin>
+      <plugin>
+        <groupId>org.codehaus.gmavenplus</groupId>
+        <artifactId>gmavenplus-plugin</artifactId>
+        <version>4.1.1</version>
+        <configuration>
+          <scripts>
+            <script>./.github/motives.groovy</script>
+          </scripts>
+        </configuration>
+        <dependencies>
+          <dependency>
+            <groupId>org.apache.groovy</groupId>
+            <artifactId>groovy</artifactId>
+            <version>4.0.26</version>
+          </dependency>
+        </dependencies>
+      </plugin>
     </plugins>
   </build>
 </project>

src/main/java/org/eolang/lints/LtByXsl.java

@@ -11,7 +11,9 @@
 import com.jcabi.xml.XMLDocument;
 import com.jcabi.xml.XSL;
 import com.jcabi.xml.XSLDocument;
+import io.github.secretx33.resourceresolver.DefaultResourceLoader;
 import java.io.IOException;
+import java.nio.charset.StandardCharsets;
 import java.util.Collection;
 import java.util.LinkedList;
 import java.util.Optional;
@@ -40,9 +42,9 @@ final class LtByXsl implements Lint<XML> {
     private final XSL sheet;
 
     /**
-     * Motive document.
+     * Path to motive document.
      */
-    private final Input doc;
+    private final String doc;
 
     /**
      * Ctor.
@@ -54,20 +56,18 @@ final class LtByXsl implements Lint<XML> {
             new ResourceOf(
                 String.format("org/eolang/lints/%s.xsl", xsl)
             ),
-            new ResourceOf(
-                String.format("org/eolang/motives/%s.md", xsl)
-            )
+            String.format("org/eolang/motives/%s.md", xsl)
         );
     }
 
     /**
      * Ctor.
-     * @param xsl Relative path of XSL
-     * @param motive Relative path of a motive document
+     * @param xsl Absolute path of XSL
+     * @param motive Absolute path of a motive document
      * @throws IOException If fails
      */
     @SuppressWarnings("PMD.ConstructorOnlyInitializesOrCallOtherConstructors")
-    LtByXsl(final Input xsl, final Input motive) throws IOException {
+    LtByXsl(final Input xsl, final String motive) throws IOException {
         final XML xml = new XMLDocument(new IoCheckedText(new TextOf(xsl)).asString());
         this.rule = new Xnav(xml.toString())
             .element("xsl:stylesheet")
@@ -117,7 +117,9 @@ public Collection<Defect> defects(final XML xmir) {
 
     @Override
     public String motive() throws IOException {
-        return new IoCheckedText(new TextOf(this.doc)).asString();
+        return new DefaultResourceLoader()
+            .getResource(this.doc)
+            .getContentAsString(StandardCharsets.UTF_8);
     }
 
     /**

src/main/java/org/eolang/lints/PkByXsl.java

@@ -54,13 +54,11 @@ private static Iterable<Lint<XML>> all() {
                     res ->
                         new LtByXsl(
                             new InputOf(res.getInputStream()),
-                            new InputOf(
-                                PkByXsl.XSL_PATTERN.matcher(
-                                    PkByXsl.LINTS_PATH.matcher(
-                                        res.getURL().toString()
-                                    ).replaceAll("eolang/motives")
-                                ).replaceAll(".md")
-                            )
+                            PkByXsl.XSL_PATTERN.matcher(
+                                PkByXsl.LINTS_PATH.matcher(
+                                    res.getURL().toString()
+                                ).replaceAll("eolang/motives")
+                            ).replaceAll(".md")
                         ),
                     Arrays.asList(
                         new PathMatchingResourcePatternResolver().getResources(