com.github._1c_syntax.bsl.parser.description.VariableDescription Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of bsl-parser Show documentation
Collection of parsers for Language 1C (BSL) in ANTLR4 format.
The newest version!
/*
 * This file is a part of BSL Parser.
 *
 * Copyright (c) 2018-2024
 * Alexey Sosnoviy , Nikita Fedkin , Sergey Batanov 
 *
 * SPDX-License-Identifier: LGPL-3.0-or-later
 *
 * BSL Parser is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 3.0 of the License, or (at your option) any later version.
 *
 * BSL Parser is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with BSL Parser.
 */
package com.github._1c_syntax.bsl.parser.description;

import com.github._1c_syntax.bsl.parser.BSLMethodDescriptionTokenizer;
import com.github._1c_syntax.bsl.parser.description.support.DescriptionReader;
import com.github._1c_syntax.bsl.parser.description.support.SimpleRange;
import org.antlr.v4.runtime.Token;

import javax.annotation.Nullable;
import java.util.List;
import java.util.Optional;
import java.util.stream.Collectors;

import static java.util.Objects.requireNonNull;

/**
 * Класс-описание переменной.
 */
public final class VariableDescription implements SourceDefinedSymbolDescription {

  /**
   * Содержит полное описание переменной (весь текст)
   */
  private final String description;

  /**
   * Содержит часть строки после ключевого слова, в которой должно быть
   * описание причины устаревания переменной либо альтернативы
   */
  private final String deprecationInfo;

  /**
   * Признак устаревания переменной
   */
  private final boolean deprecated;

  /**
   * Описание назначения переменной
   */
  private final String purposeDescription;

  /**
   * Если описание содержит только ссылку, то здесь будет ее значение
   * 
   * TODO Временное решение, надо будет продумать кошерное решение
   */
  private final String link;

  /**
   * Диапазон, в котором располагается описание.
   */
  private final SimpleRange range;

  /**
   * Описание "висячего" комментария
   */
  private final VariableDescription trailingDescription;

  VariableDescription(List comments) {
    this(comments, null);
  }

  VariableDescription(List comments, @Nullable Token trailingComment) {
    description = comments.stream()
      .map(Token::getText)
      .collect(Collectors.joining("\n"));

    var tokenizer = new BSLMethodDescriptionTokenizer(description);
    var ast = requireNonNull(tokenizer.getAst());

    range = SimpleRange.create(comments);
    purposeDescription = DescriptionReader.readPurposeDescription(ast);
    link = DescriptionReader.readLink(ast);
    deprecated = ast.deprecate() != null;
    deprecationInfo = DescriptionReader.readDeprecationInfo(ast);
    if (trailingComment == null) {
      trailingDescription = null;
    } else {
      trailingDescription = new VariableDescription(List.of(trailingComment));
    }
  }

  @Override
  public String getDescription() {
    return description;
  }

  @Override
  public String getDeprecationInfo() {
    return deprecationInfo;
  }

  @Override
  public boolean isDeprecated() {
    return deprecated;
  }

  @Override
  public String getPurposeDescription() {
    return purposeDescription;
  }

  @Override
  public String getLink() {
    return link;
  }

  @Override
  public SimpleRange getSimpleRange() {
    return range;
  }

  public Optional getTrailingDescription() {
    return Optional.ofNullable(trailingDescription);
  }
}