본문으로 건너뛰기

Proxy

객체를 감싸서 일부 메서드만 바꾸고, 나머지는 원래 객체에 넘기는 방법입니다.

개념​

  • proxy는 원래 객체를 속성으로 보관하고, 일부 메서드만 직접 정의하고 나머지는 원래 객체에 넘기는 객체입니다.
  • **__getattr__**은 객체에 없는 속성을 읽으려 할 때만 불립니다. 그래서 직접 정의하지 않은 속성은 모두 __getattr__을 거쳐 원래 객체로 갑니다.

사용 방법​

  • 바꿀 메서드 한두 개만 직접 정의합니다.
  • 나머지 속성 접근은 __getattr__으로 원래 객체에 넘깁니다.
  • 이미 감싼 객체는 다시 감싸지 않습니다.

왜 필요한가​

원래 객체가 가진 수십 개의 메서드를 하나하나 옮겨 적지 않아도 됩니다.

예시​

# 예시: write만 바꾸고 나머지는 원래 stream에 넘기는 proxy
import io


class PrefixWriter:
def __init__(self, raw: io.TextIOBase) -> None:
self._raw = raw

def write(self, text: str) -> int:
# 내용이 있는 줄에만 prefix를 붙입니다
return self._raw.write(f"[app] {text}" if text.strip() else text)

def __getattr__(self, name: str):
# 직접 정의하지 않은 속성은 모두 원래 stream에서 찾습니다
return getattr(self._raw, name)


buffer = io.StringIO()
writer = PrefixWriter(buffer)
writer.write("started\n")
print(writer.getvalue()) # [app] started — getvalue는 __getattr__을 거쳐 StringIO에서 옵니다

Self-Index에서의 사용​

src/selfindex/pipeline/run.py:31의 _TsWriter는 write, flush만 정의하고 나머지는 원래 stdout에 넘깁니다.

def __getattr__(self, name):
return getattr(self._raw, name)

def _install_ts_stdout():
if not isinstance(sys.stdout, _TsWriter):
sys.stdout = _TsWriter(sys.stdout)

upstream이 client.chat.completions.create(...)처럼 긴 경로로 부르는 경우에는, chat과 completions를 self를 돌려주는 property로 만들어 같은 경로를 흉내 냅니다(adapters/browsecomp/agent/or_client_ours.py:19의 _Routed).

주의할 점​

proxy는 원래 객체와 타입이 다르므로 isinstance 검사까지 통과해야 하는 상황에는 맞지 않습니다. 그럴 때는 상속(B4)을 씁니다.