codeplay/CodePlay.Core/Parsers/BaseParser.cs

using CodePlay.Core.Interfaces;
using CodePlay.Core.Models;
using CodePlay.Core.Common;

namespace CodePlay.Core.Parsers;

/// <summary>
/// 解析器基类
/// </summary>
public abstract class BaseParser : IParser
{
    /// <summary>
    /// 支持的语言类型
    /// </summary>
    public abstract LanguageType SupportedLanguage { get; }
    
    /// <summary>
    /// 解析源代码并生成 AST
    /// </summary>
    public abstract Task<SyntaxTree> ParseAsync(string sourceCode, CancellationToken cancellationToken = default);
    
    /// <summary>
    /// 创建语法树
    /// </summary>
    protected SyntaxTree CreateSyntaxTree()
    {
        return new SyntaxTree
        {
            Language = SupportedLanguage,
            Root = new SyntaxNode
            {
                Type = SyntaxNodeType.CompilationUnit
            }
        };
    }
    
    /// <summary>
    /// 添加注释到语法树
    /// </summary>
    protected void AddComment(SyntaxTree tree, string text, CommentType type, int lineNumber)
    {
        tree.Comments.Add(new SyntaxComment
        {
            Text = text,
            Type = type,
            LineNumber = lineNumber
        });
    }
    
    /// <summary>
    /// 记录解析日志
    /// </summary>
    protected TransformationLog CreateLog(string operation, string details, LogLevel level = LogLevel.Info)
    {
        return new TransformationLog
        {
            Timestamp = DateTime.UtcNow,
            Operation = operation,
            Details = details,
            Level = level
        };
    }
}