Finish v0.4.0

Author: theshadowco

.github/workflows/check.yml

@@ -11,17 +11,17 @@ jobs:
         java_version: ['17', '21']
         os: [ubuntu-latest, windows-latest, macOS-latest]
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
     - name: Set up JDK ${{ matrix.java_version }}
-      uses: actions/setup-java@v4
+      uses: actions/setup-java@v5
       with:
         java-version: ${{ matrix.java_version }}
         distribution: 'adopt'
     - name: Build with Gradle
       run: ./gradlew check --stacktrace
     - name: Archive test results
       if: failure()
-      uses: actions/upload-artifact@v4
+      uses: actions/upload-artifact@v5
       with:
         name: junit_report_${{ matrix.os }}_${{ matrix.java_version }}
         path: build/reports/tests/test

.github/workflows/publish-to-maven-central.yml

@@ -12,7 +12,7 @@ jobs:
   publish:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
       - name: Set up JDK

.github/workflows/qa.yml

@@ -12,7 +12,7 @@ jobs:
     runs-on: ubuntu-latest
     if: github.event_name == 'push' || github.event.pull_request.head.repo.full_name == github.event.repository.full_name
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
         with:
           fetch-depth: ''
       - run: |

.github/workflows/release.yml

@@ -12,7 +12,7 @@ jobs:
         matrix:
           os: [ ubuntu-latest, windows-latest, macOS-latest ]
       steps:
-        - uses: actions/checkout@v5
+        - uses: actions/checkout@v6
           with:
             fetch-depth: 0
         - uses: actions/setup-java@v5

.github/workflows/update-gradle.yaml

@@ -10,7 +10,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
       - name: Set up JDK 17

build.gradle.kts

@@ -8,14 +8,14 @@ plugins {
     idea
     id("org.cadixdev.licenser") version "0.6.1"
     id("me.qoomon.git-versioning") version "6.4.4"
-    id("io.freefair.lombok") version "8.14.2"
-    id("io.freefair.javadoc-links") version "8.14.2"
-    id("io.freefair.javadoc-utf-8") version "8.14.2"
-    id("io.freefair.maven-central.validate-poms") version "8.14.2"
-    id("com.github.ben-manes.versions") version "0.52.0"
+    id("io.freefair.lombok") version "9.1.0"
+    id("io.freefair.javadoc-links") version "9.1.0"
+    id("io.freefair.javadoc-utf-8") version "9.1.0"
+    id("io.freefair.maven-central.validate-poms") version "9.1.0"
+    id("com.github.ben-manes.versions") version "0.53.0"
     id("ru.vyarus.pom") version "3.0.0"
-    id("org.jreleaser") version "1.19.0"
-    id("org.sonarqube") version "6.2.0.5505"
+    id("org.jreleaser") version "1.21.0"
+    id("org.sonarqube") version "7.1.0.6387"
     id("me.champeau.jmh") version "0.7.3"
 }
 
@@ -49,13 +49,12 @@ gitVersioning.apply {
 }
 
 dependencies {
-    implementation("io.github.1c-syntax", "bsl-parser-core", "0.3.1")
-    implementation("io.github.1c-syntax", "antlr4", "0.1.2")
+    implementation("io.github.1c-syntax", "antlr4", "0.2.0")
     implementation("commons-io", "commons-io", "2.15.1")
-    implementation("org.junit.jupiter", "junit-jupiter-api", "5.10.1")
-    implementation("org.assertj", "assertj-core", "3.25.0")
+    implementation("org.junit.jupiter", "junit-jupiter-api", "5.11.4")
+    implementation("org.assertj", "assertj-core", "3.27.0")
 
-    testImplementation("org.junit.jupiter", "junit-jupiter-engine", "5.10.1")
+    testImplementation("org.junit.jupiter", "junit-jupiter-engine", "5.11.4")
     testImplementation("org.mockito", "mockito-core", "5.8.0")
 }
 

src/main/java/com/github/_1c_syntax/bsl/parser/testing/LexerAsserts.java

@@ -49,7 +49,7 @@ public LexerAsserts(TestLexer<?> lexer, String inputString, int mode, int channe
    * При проверке анализируются все токены всех каналов, включая служебный конца строки
    *
    * @param expectedTokens контрольный массив токенов
-   * @return
+   * @return Ассерт (для текучести)
    */
   public LexerAsserts containsExactly(Integer... expectedTokens) {
     var tokenTypes = tokens.stream()
@@ -63,7 +63,7 @@ public LexerAsserts containsExactly(Integer... expectedTokens) {
    * При проверке анализируются токены указанного в assertThat канала, исключая служебный конца строки
    *
    * @param expectedTokens контрольный массив токенов
-   * @return
+   * @return Ассерт (для текучести)
    */
   public LexerAsserts containsAll(Integer... expectedTokens) {
     var tokenTypes = tokens.stream()
@@ -79,7 +79,7 @@ public LexerAsserts containsAll(Integer... expectedTokens) {
    *
    * @param index Порядковый индекс токена в строке
    * @param text  текст токена
-   * @return
+   * @return Ассерт (для текучести)
    */
   public LexerAsserts tokenHasText(int index, String text) {
     var token = tokens.get(index);
@@ -93,7 +93,7 @@ public LexerAsserts tokenHasText(int index, String text) {
    *
    * @param index  Порядковый индекс токена в строке
    * @param lineNo номер строки расположения токена
-   * @return
+   * @return Ассерт (для текучести)
    */
   public LexerAsserts tokenOnLine(int index, int lineNo) {
     var token = tokens.get(index);
@@ -107,7 +107,7 @@ public LexerAsserts tokenOnLine(int index, int lineNo) {
    * идентификаторов токенов (с учетом установленных mode и channel)
    *
    * @param actual строка для сравнения
-   * @return
+   * @return Ассерт (для текучести)
    */
   public LexerAsserts isEqualTo(String actual) {
     var actualTokens = lexer.getTokens(mode, actual);

src/main/java/com/github/_1c_syntax/bsl/parser/testing/ParserAsserts.java

@@ -21,7 +21,6 @@
  */
 package com.github._1c_syntax.bsl.parser.testing;
 
-import com.github._1c_syntax.bsl.parser.BSLParserRuleContext;
 import lombok.SneakyThrows;
 import org.antlr.v4.runtime.Parser;
 import org.antlr.v4.runtime.ParserRuleContext;
@@ -41,7 +40,7 @@ public class ParserAsserts {
   private final Parser parser;
   private final TestParser<?, ?> testParser;
 
-  private final BSLParserRuleContext currentAST;
+  private final ParserRuleContext currentAST;
 
   @SneakyThrows
   public ParserAsserts(TestParser<?, ?> testParser, Parser parser) {
@@ -50,7 +49,7 @@ public ParserAsserts(TestParser<?, ?> testParser, Parser parser) {
     var fields = testParser.getParserClazz().getDeclaredMethods();
     var result = Arrays.stream(fields).filter(field -> testParser.ruleName(0).equals(field.getName())).findFirst();
     if (result.isPresent()) {
-      this.currentAST = (BSLParserRuleContext) result.get().invoke(parser);
+      this.currentAST = (ParserRuleContext) result.get().invoke(parser);
       this.parser.reset();
     } else {
       this.currentAST = null;
@@ -59,9 +58,10 @@ public ParserAsserts(TestParser<?, ?> testParser, Parser parser) {
 
   /**
    * Выполняет проверку совпадения прочитанного узла на предмет ошибок парсинга
-   * @param tree
-   * @return
-   * @throws RecognitionException
+   *
+   * @param tree Узел дерева
+   * @return Ассерт (для текучести)
+   * @throws RecognitionException Ошибка парсинга
    */
   public ParserAsserts matches(ParseTree tree) throws RecognitionException {
     if (parser.getNumberOfSyntaxErrors() != 0) {
@@ -78,7 +78,7 @@ public ParserAsserts matches(ParseTree tree) throws RecognitionException {
         throw ctx.exception;
       }
 
-      if (((ParserRuleContext) tree).parent == null) {
+      if (ctx.parent == null) {
         boolean parseSuccess = testParser.getLexerClazz().cast(parser.getInputStream().getTokenSource())._hitEOF;
         if (!parseSuccess) {
           throw new RecognitionException(
@@ -99,8 +99,9 @@ public ParserAsserts matches(ParseTree tree) throws RecognitionException {
 
   /**
    * Убеждается, что прочитанного узла нет либо есть ошибка его чтения
-   * @param tree
-   * @return
+   *
+   * @param tree Узел дерева
+   * @return Ассерт (для текучести)
    */
   public ParserAsserts noMatches(ParseTree tree) {
     assertThat(tree).satisfiesAnyOf(
@@ -112,9 +113,10 @@ public ParserAsserts noMatches(ParseTree tree) {
 
   /**
    * Выполняет анализ наличия в дереве узлов с нужным идентификатором в нужном количестве
-   * @param ruleId
-   * @param count
-   * @return
+   *
+   * @param ruleId идентификатор рула
+   * @param count количество узлов
+   * @return Ассерт (для текучести)
    */
   public ParserAsserts containsRule(int ruleId, int count) {
     assertThat(currentAST).isNotNull();

src/main/java/com/github/_1c_syntax/bsl/parser/testing/ResourceUtils.java

@@ -36,8 +36,8 @@ public class ResourceUtils {
   /**
    * Читает файл фикстуры из тестовых ресурсов проекта
    *
-   * @param resourceName
-   * @return
+   * @param resourceName имя файла фикстуры
+   * @return Прочитанное содержимое
    */
   public String byName(@NonNull String resourceName) {
     if (resourceName.isBlank()) {

src/main/java/com/github/_1c_syntax/bsl/parser/testing/TestLexer.java

@@ -21,16 +21,15 @@
  */
 package com.github._1c_syntax.bsl.parser.testing;
 
-import com.github._1c_syntax.bsl.parser.CaseChangingCharStream;
-import com.github._1c_syntax.bsl.parser.UnicodeBOMInputStream;
 import lombok.Getter;
 import lombok.SneakyThrows;
 import org.antlr.v4.runtime.CharStream;
 import org.antlr.v4.runtime.CharStreams;
-import org.antlr.v4.runtime.CommonTokenStream;
 import org.antlr.v4.runtime.ConsoleErrorListener;
+import org.antlr.v4.runtime.IncrementalTokenStream;
 import org.antlr.v4.runtime.Lexer;
 import org.antlr.v4.runtime.Token;
+import org.antlr.v4.runtime.UnicodeBOMInputStream;
 import org.apache.commons.io.IOUtils;
 
 import java.io.IOException;
@@ -72,9 +71,9 @@ public TestLexer(Class<T> clazz) {
   /**
    * Возвращает список токенов в переданной строке
    *
-   * @param mode
-   * @param inputString
-   * @return
+   * @param mode        Режим
+   * @param inputString Входная строка
+   * @return Токены в строке
    */
   public List<Token> getTokens(int mode, String inputString) {
     return getTokensStream(mode, inputString).getTokens();
@@ -83,11 +82,11 @@ public List<Token> getTokens(int mode, String inputString) {
   /**
    * Возвращает токены переданной строки
    *
-   * @param mode
-   * @param inputString
-   * @return
+   * @param mode        Режим
+   * @param inputString Входная строка
+   * @return Токены в строке
    */
-  public CommonTokenStream getTokensStream(int mode, String inputString) {
+  public IncrementalTokenStream getTokensStream(int mode, String inputString) {
     CharStream input;
 
     try (
@@ -96,8 +95,7 @@ public CommonTokenStream getTokensStream(int mode, String inputString) {
       var inputStreamReader = new InputStreamReader(ubis, StandardCharsets.UTF_8)
     ) {
       ubis.skipBOM();
-      var inputTemp = CharStreams.fromReader(inputStreamReader);
-      input = new CaseChangingCharStream(inputTemp);
+      input = CharStreams.fromReader(inputStreamReader);
     } catch (IOException e) {
       throw new RuntimeException(e);
     }
@@ -106,7 +104,7 @@ public CommonTokenStream getTokensStream(int mode, String inputString) {
     lexer.removeErrorListener(ConsoleErrorListener.INSTANCE);
     lexer.pushMode(mode);
 
-    var tempTokenStream = new CommonTokenStream(lexer);
+    var tempTokenStream = new IncrementalTokenStream(lexer);
     tempTokenStream.fill();
 
     return tempTokenStream;
@@ -116,7 +114,7 @@ public CommonTokenStream getTokensStream(int mode, String inputString) {
    * Формирует строку с именами токенов на основании переданного массива их идентификаторов
    *
    * @param tokenTypes массив идентификаторов (типов) токенов
-   * @return
+   * @return Имя токена
    */
   public String tokenName(Integer[] tokenTypes) {
     return Arrays.stream(tokenTypes).map(this::tokenName).collect(Collectors.joining(", "));
@@ -125,8 +123,8 @@ public String tokenName(Integer[] tokenTypes) {
   /**
    * Возвращает имя токена по его идентификатору (типу)
    *
-   * @param type
-   * @return
+   * @param type Идентификатор токена
+   * @return Имя токена
    */
   public String tokenName(Integer type) {
     if (!ruleNames.isEmpty() && type < ruleNames.size()) {
@@ -149,7 +147,7 @@ public LexerAsserts assertThat(String inputString) {
   /**
    * Настраивает и запоминает тестируемый контекст. Использует дефолтное channel
    *
-   * @param mode
+   * @param mode        Режим
    * @param inputString анализируемая строка
    * @return служебный класс для замыкания
    */
@@ -160,7 +158,7 @@ public LexerAsserts assertThat(int mode, String inputString) {
   /**
    * Настраивает и запоминает тестируемый контекст
    *
-   * @param mode
+   * @param mode        Режим
    * @param inputString анализируемая строка
    * @param channel     анализируемая строка
    * @return служебный класс для замыкания
@@ -173,7 +171,7 @@ public LexerAsserts assertThat(int mode, String inputString, int channel) {
    * Настраивает и запоминает тестируемый контекст. Использует дефолтное mode
    *
    * @param inputString анализируемая строка
-   * @param channel
+   * @param channel     Канал
    * @return служебный класс для замыкания
    */
   public LexerAsserts assertThat(String inputString, int channel) {
@@ -182,8 +180,8 @@ public LexerAsserts assertThat(String inputString, int channel) {
 
   private T createLexer(Class<T> lexerClass) {
     try {
-      return lexerClass.getDeclaredConstructor(CharStream.class, boolean.class)
-        .newInstance(CharStreams.fromString(""), true);
+      return lexerClass.getDeclaredConstructor(CharStream.class)
+        .newInstance(CharStreams.fromString(""));
     } catch (InstantiationException | IllegalAccessException | InvocationTargetException | NoSuchMethodException e) {
       throw new RuntimeException(e);
     }