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 TransformationLogEntry CreateLog(string operation, string details, string level = "Info")
    {
        return new TransformationLogEntry { Timestamp = DateTime.UtcNow, Operation = operation, Details = details, Level = level };
    }
}