본문으로 건너뛰기

BaseException

외부 코드의 except Exception에 잡히면 안 되는 신호를 만드는 방법입니다.

개념​

Python 예외의 뿌리는 BaseException이고, 일반 오류는 그 아래의 Exception을 상속합니다. except Exception은 Exception 계열만 잡으므로, BaseException을 직접 상속한 예외는 그냥 지나갑니다. KeyboardInterrupt가 이렇게 만들어져 있습니다.

사용 방법​

  • 외부 코드의 except Exception에 처리되지 않고 호출한 쪽으로 전달되어야 하는 신호만 BaseException을 직접 상속합니다.
  • 그 신호를 잡아 처리하는 wrapper를 반드시 함께 둡니다.
  • 실패했을 때 상태를 되돌리는 코드도 except BaseException:으로 잡고, 되돌린 뒤 반드시 raise합니다. 그래야 KeyboardInterrupt로 멈춰도 반쯤 바뀐 상태가 남지 않습니다.

왜 필요한가​

query별 시간 제한을 외부 라이브러리의 대화 loop 안에서 발생시키면, Exception을 상속한 예외는 그 라이브러리가 "도구 호출 실패"로 삼키고 loop를 계속 돕니다. BaseException이면 우리 wrapper까지 올라옵니다.

예시​

# 예시: 외부 loop의 except Exception을 뚫고 올라오는 시간 제한 신호
class Deadline(BaseException):
pass


def upstream_loop(step) -> None:
"""외부 코드라고 가정합니다. 오류를 잡아 출력하고 계속 돕니다."""
for turn in range(3):
try:
step(turn)
except Exception as error:
print("upstream swallowed:", error)


def step(turn: int) -> None:
if turn == 0:
raise ValueError("tool failed")
raise Deadline()


try:
upstream_loop(step)
except Deadline:
print("deadline reached") # ValueError는 삼켜졌지만 Deadline은 올라왔습니다

Self-Index에서의 사용​

adapters/browsecomp/agent/oss_client_ours.py:20, :97

class _QueryDeadline(BaseException): ...

def _conversation_with_deadline(original, client, initial_request, tool_handler, ...):
_QUERY_CLOCK.started = time.monotonic()
try:
out = original(client, initial_request, tool_handler, max_iterations, verbose)
except _QueryDeadline as deadline:
...
raise

상태를 되돌리는 except BaseException:은 index/dense.py:312, retrieval/snapshots.py:63, runtime/workflows/execution.py:63에 있습니다.

주의할 점​

BaseException 상속은 일반 오류 처리를 모두 건너뛰므로, 처리할 wrapper가 정해져 있을 때만 씁니다.