"""
ctstruct/parsers/base.py
파서 추상 베이스 클래스
"""

from abc import ABC, abstractmethod
from ..tree import CTTree


class BaseParser(ABC):
    """
    모든 텍스트 파서의 공통 인터페이스.

    구현 클래스는 parse() 메서드만 오버라이드하면 됩니다.
    """

    @abstractmethod
    def parse(self, text: str) -> CTTree:
        """
        텍스트를 파싱하여 CTTree 반환.

        Args:
            text: 파싱할 원문 텍스트

        Returns:
            구조화된 CTTree 객체
        """
        ...

    def __call__(self, text: str) -> CTTree:
        return self.parse(text)