Callable
실행할 동작을 함수, lambda, 호출 가능한 객체로 전달받는 방법입니다.
개념
- Callable은 괄호를 붙여 부를 수 있는 모든 것을 뜻하는 타입입니다.
- **
__call__**을 정의한 객체는 함수처럼obj()로 부를 수 있습니다.
사용 방법
- 실행 단위를
Callable[[], int | None]로 받습니다. lambda, 일반 함수,__call__을 가진 객체를 모두 인자로 전달할 수 있습니다. - 실행에 필요한 값(명령, 인자, 환경)을 들고 있어야 하면
__call__을 가진 frozen dataclass로 만듭니다.
왜 필요한가
단계를 실행하는 쪽은 "부르면 exit code가 나온다"만 알면 됩니다. 단계가 함수인지 하위 프로세스인지 몰라도 됩니다.
예시
# 예시: lambda와 __call__ 객체를 같은 Stage에 넣습니다
import subprocess
import sys
from collections.abc import Callable
from dataclasses import dataclass
@dataclass(frozen=True)
class Stage:
name: str
action: Callable[[], int]
@dataclass(frozen=True)
class Command:
"""하위 프로세스 하나를 들고 있다가, 부르면 실행하고 exit code를 돌려줍니다."""
arguments: tuple[str, ...]
def __call__(self) -> int:
return subprocess.run(self.arguments, check=False).returncode
stages = [
Stage("inline", lambda: 0),
Stage("process", Command((sys.executable, "-c", "pass"))),
]
for stage in stages:
print(stage.name, stage.action()) # inline 0, process 0
Self-Index에서의 사용
src/selfindex/runtime/workflows/execution.py:13
@dataclass(frozen=True)
class Stage:
name: str
action: Callable[[], int | None]
artifacts: Callable[[], tuple[Path, ...]] | None = None
@dataclass(frozen=True)
class Command:
name: str
arguments: tuple[str, ...]
environment: Mapping[str, str]
directory: Path
def __call__(self) -> int:
...
같은 방식으로 EncodedTexts(validation/base.py:15)는 미리 encode한 결과를 들고 있다가 함수처럼 조회되고,
TextEncoding Protocol(pipeline/contracts.py:15)은 __call__ 시그니처만으로 encoder의 약속을 정합니다.