Merge pull request #3959 from h1alexbel/3934

feat(#3934): `spdx` meta instead of `<license/>` node

Author: maxonfjvipon

REUSE.toml

@@ -32,7 +32,7 @@ path = [
     "Gemfile.lock",
     "eo-maven-plugin/src/main/resources/org/eolang/maven/latex/latex-template.txt",
     "eo-maven-plugin/src/test/resources/org/eolang/maven/commits/tags.txt",
-    "eo-runtime/src/main/resources/org/eolang/version.txt",
+    "eo-runtime/src/main/resources/org/eolang/version.txt"
 ]
 precedence = "override"
 SPDX-FileCopyrightText = "Copyright (c) 2016-2025 Objectionary.com"

eo-maven-plugin/pom.xml

@@ -23,7 +23,7 @@
     <dependency>
       <groupId>org.eolang</groupId>
       <artifactId>lints</artifactId>
-      <version>0.0.38</version>
+      <version>0.0.39</version>
     </dependency>
     <dependency>
       <groupId>org.glassfish</groupId>

eo-maven-plugin/src/main/java/org/eolang/maven/LintMojo.java

@@ -257,10 +257,16 @@ private static String summary(final ConcurrentHashMap<Severity, Integer> counts)
      * @param xmir The XML before linting
      * @param counts Counts of errors, warnings, and critical
      * @return XML after linting
+     * @todo #3934:35min Remove .without() from Program to enable `unknown-metas`
+     *  and `unsorted-metas` lints. Currently we disabled them since lints does not
+     *  support `+spdx` meta yet. Once <a href="https://github.com/objectionary/lints/issues/354">this</a>
+     *  issue will be resolved, we should enable all lints.
      */
     private static XML linted(final XML xmir, final ConcurrentHashMap<Severity, Integer> counts) {
         final Directives dirs = new Directives();
-        final Collection<Defect> defects = new Program(xmir).defects();
+        final Collection<Defect> defects = new Program(xmir).without(
+            "unknown-metas", "unsorted-metas"
+        ).defects();
         if (!defects.isEmpty()) {
             dirs.xpath("/program").addIf("errors").strict(1);
             LintMojo.embed(xmir, defects);

eo-maven-plugin/src/test/resources/org/eolang/maven/mess.eo

@@ -1,6 +1,5 @@
-# SPDX-FileCopyrightText: Copyright (c) 2016-2025 Objectionary.com
-# SPDX-License-Identifier: MIT
-
++spdx SPDX-FileCopyrightText Copyright (c) 2016-2025 Objectionary.com
++spdx SPDX-License-Identifier: MIT
 +alias org.eolang.io.stdout
 +architect yegor256@gmail.com
 +home https://github.com/objectionary/eo

eo-parser/src/main/antlr4/org/eolang/parser/Eo.g4

@@ -8,18 +8,13 @@ tokens { TAB, UNTAB }
 
 // Entry point
 program
-    : license? metas? objects EOF
+    : metas? objects EOF
     ;
 
 // Double EOL
 eop : EOL EOL
     ;
 
-// Licence
-license
-    : (COMMENTARY EOL)* COMMENTARY eop
-    ;
-
 // Metas
 metas
     : (META EOL)* META eop

eo-parser/src/main/java/org/eolang/parser/XeEoListener.java

@@ -16,8 +16,6 @@
 import org.antlr.v4.runtime.tree.ErrorNode;
 import org.antlr.v4.runtime.tree.TerminalNode;
 import org.apache.commons.text.StringEscapeUtils;
-import org.cactoos.iterable.Mapped;
-import org.cactoos.text.Joined;
 import org.xembly.Directive;
 import org.xembly.Directives;
 
@@ -104,24 +102,6 @@ public void exitEop(final EoParser.EopContext ctx) {
         // Nothing here
     }
 
-    @Override
-    public void enterLicense(final EoParser.LicenseContext ctx) {
-        this.dirs.addIf("license").set(
-            new Joined(
-                "\n",
-                new Mapped<>(
-                    cmt -> cmt.getText().substring(1).trim(),
-                    ctx.COMMENTARY()
-                )
-            )
-        ).up();
-    }
-
-    @Override
-    public void exitLicense(final EoParser.LicenseContext ctx) {
-        // Nothing here
-    }
-
     @Override
     public void enterMetas(final EoParser.MetasContext ctx) {
         this.dirs.addIf("metas");

eo-parser/src/main/resources/XMIR.xsd

@@ -9,7 +9,7 @@
     <xs:documentation>
       Every XMIR document is essentially an XML document that
       contains objects found in a EOLANG program together with
-      supplementary information, such as metas, license, and so on.
+      supplementary information, such as metas, and so on.
       The schema is used to validate the XMIR documents, which are
       generated by the EO parser. The schema defines the structure
       of the XMIR document, including the elements and attributes
@@ -252,21 +252,6 @@
       <xs:extension base="non-empty"/>
     </xs:simpleContent>
   </xs:complexType>
-  <xs:complexType name="license">
-    <xs:annotation>
-      <xs:appinfo>The entire license found in the source code</xs:appinfo>
-      <xs:documentation>
-        The element contains the entire text of the license found in the source code. This information is crucial for
-        understanding the legal terms under which the code can be used, modified, and distributed. By including the full
-        license text, developers and users can easily reference the licensing terms without needing to look up the
-        original source. This practice helps ensure compliance with the license and provides transparency regarding the
-        legal framework governing the code.
-      </xs:documentation>
-    </xs:annotation>
-    <xs:simpleContent>
-      <xs:extension base="non-empty"/>
-    </xs:simpleContent>
-  </xs:complexType>
   <xs:simpleType name="sheet">
     <xs:annotation>
       <xs:appinfo>The XSL stylesheet that was applied to the XMIR</xs:appinfo>
@@ -375,7 +360,6 @@
           </xs:sequence>
         </xs:complexType>
       </xs:element>
-      <xs:element name="license" type="license" minOccurs="0"/>
       <xs:element name="metas" minOccurs="0">
         <xs:complexType>
           <xs:sequence>

eo-parser/src/test/resources/org/eolang/parser/eo-syntax/full-syntax.yaml

@@ -4,7 +4,6 @@
 sheets: [ ]
 asserts:
   - /program[not(errors)]
-  - /program/license[text()!='']
   - /program/metas[count(meta)=4]
   - /program/metas/meta[head='foo' and tail='']
   - //o[@base='Q.org.eolang.true']
@@ -18,10 +17,6 @@ asserts:
   - //o[@atom and @name='atom' and count(o)=2 and o[@name='a']]
   - //o[@atom='org.eolang.number']
 input: |
-  # The purpose of this test case is to make
-  # sure all possible syntax scenarios can
-  # be parsed by the ANTLR
-
   +alias org.example.foo
   +alias Test Test
   +bar Some text

eo-parser/src/test/resources/org/eolang/parser/eo-syntax/leap-year.yaml

@@ -7,11 +7,6 @@ asserts:
   - /program/objects[count(o)=1]
   - //o[@base='.and']
 input: |
-  # This program is from the EOLANG original paper
-  # and must produce a working command line tool
-  #
-  # License is MIT
-
   +alias org.eolang.io.stdin
   +alias org.eolang.io.stdout
   +alias org.eolang.txt.scanner

eo-parser/src/test/resources/org/eolang/parser/factorial.eo

@@ -1,6 +1,7 @@
-# SPDX-FileCopyrightText: Copyright (c) 2016-2025 Objectionary.com
-# SPDX-License-Identifier: MIT
++spdx SPDX-FileCopyrightText Copyright (c) 2016-2025 Objectionary.com
++spdx SPDX-License-Identifier: MIT
 
+# F.
 [n] > f
   if. > @
     n.lt 1