이름이 같은 _truthy 두 개는 빈 값을 다르게 읽었다

커뮤니티용 텔레그램 봇의 워커 파일 두 개에 똑같이 _truthy라는 함수가 있었다. 이름도 같고 하는 일도 “환경변수가 켜져 있나”로 같아 보였는데 본문이 달랐다. 이름만 바꿔서 옮기면 이렇다.

# 한 워커의 사본
def _truthy(name: str, default: str = "") -> bool:
    return os.getenv(name, default).strip().lower() in ("1", "true", "yes", "on")

# 다른 워커의 사본
def _truthy(name: str, default: bool = False) -> bool:
    raw = os.getenv(name, "").strip().lower()
    if not raw:
        return default
    return raw in ("1", "true", "yes", "on")

차이는 변수가 빈 값으로 설정돼 있을 때 나온다. .env에 FEATURE_ENABLED=처럼 등호 뒤를 비워 두면 그 변수는 존재하고 값은 빈 문자열이다. os.getenv는 변수가 있으면 그 값을, 없을 때만 default를 돌려준다. 그래서 첫 번째 사본은 default가 "1"이어도 빈 값을 받아 꺼짐이 된다. 두 번째 사본은 빈 값을 “설정 안 함”으로 보고 default를 쓴다. 같은 줄이 어느 파일에서 읽히느냐에 따라 기능이 켜지기도 하고 꺼지기도 한다.

2026년 9월 말에 이 함수들을 공용 모듈 하나로 모았다. 그 작업의 거의 전부가 이 차이를 깨뜨리지 않는 데 들어갔다.

장애가 계기는 아니었다. 다른 기능을 손보던 새벽에 저장소에 dead code나 리팩터링할 곳이 있는지 훑어보기로 했고, 이 사본들이 거기서 나왔다.

68곳, 이름은 셋, 동작은 둘

세어 보니 61개 파일 68곳이었다. 함수 이름은 _truthy, _enabled, _env_bool 세 가지였고, 함수로 빼지 않고 os.getenv(X, D).strip().lower() in (...)을 그 자리에 바로 쓴 줄도 섞여 있었다. 이름으로 나누면 갈래가 맞지 않는다. 위처럼 같은 _truthy가 서로 다른 갈래에 속했고, 설정을 읽는 공용 파일의 _env_bool은 두 번째 갈래였다.

그래서 공용 모듈에 함수를 하나가 아니라 둘 뒀다. truthy(name, default="")는 os.getenv(name, default)를 그대로 읽는 첫 번째 갈래, flag(name, default=False)는 비었으면 default를 쓰는 두 번째 갈래다. 사본마다 본문을 AST로 대조해서 어느 쪽과 같은지 확인하고, 같은 쪽 함수로만 바꿨다. 파이썬 ast로 비교하면 들여쓰기나 줄바꿈 같은 겉모양은 빠진다. ast.dump는 기본값으로 줄 번호와 열 위치도 출력하지 않는다. 비교 스크립트는 저장소에 남기지 않아서, 정확히 무엇을 정규화했는지는 커밋 메시지에 적힌 “AST로 본문을 대조”보다 자세히 확인할 수 없다.

호출부는 건드리지 않았다. 파일 안의 옛 이름을 import alias로 남겼기 때문이다. 두 번째 갈래였던 _truthy는 이렇게 바뀌었다.

from ..envcfg import flag as _truthy

def _enabled() -> bool:
    return _truthy("FEATURE_ENABLED")

파일 안에서 읽으면 예전과 똑같이 _truthy를 부른다. 이름은 여전히 갈래를 알려 주지 못하지만, 정의로 가 보면 import 한 줄에 어느 갈래인지 적혀 있다.

운영 설정 전체를 옛 코드와 새 코드에 넣었다

동작을 바꾸지 않는 리팩터링이라 검증 기준은 하나였다. 운영 .env를 그대로 넣고, 기능마다 “켜져 있나”, “설정돼 있나” 판정을 옛 코드와 새 코드에서 각각 뽑아 맞댔다. 첫 커밋에서는 판정 197개 중 차이가 0이었고, 그중 켜짐이 177개였다.

테스트도 하나 붙였다. 테스트는 두 갈래가 다르다는 사실을 고정한다. 핵심 단언 두 줄은 이렇다.

os.environ[V] = ""
check("빈 값으로 설정 = 꺼짐 (default '1' 이어도)", not envcfg.truthy(V, "1"))
check("빈 값도 default", envcfg.flag(V, True))

나중에 누가 두 함수를 보고 하나로 합치려 하면 이 두 줄 중 하나가 깨진다. 테스트 파일 머리 주석에도 “둘을 하나로 정리하면 빈 값으로 설정된 변수의 뜻이 뒤집힌다”고 적었다.

숫자 id 파서는 두 모양만 옮겼다

같은 날 두 번째로 손댄 건 채팅 id 같은 숫자 id를 읽는 함수였다. 38개 파일 72곳에 사본이 있었다. 여기는 모양이 더 여러 갈래였다. 공용 모듈로 옮긴 건 둘이다.

  • env_int(name): 비었으면 None, 숫자가 아니면 오류 로그 한 줄을 남기고 None
  • chat_id_or_owner(name): 비었으면 소유자 DM으로 보낼 기본 id, 숫자가 아니면 오류 로그를 남기고 None

두 번째 함수에서 “숫자가 아니면 None”은 일부러 지킨 동작이다. 잘못 적은 id가 조용히 소유자 DM으로 새지 않게 한다. 테스트에도 “숫자 아니면 None (owner 로 새지 않는다)“는 단언을 넣었다.

off라는 값을 따로 읽는 사본, 변수 두 개를 차례로 보는 사본, 숫자가 아니어도 로그 없이 None을 돌려주는 사본은 뜻이 달라 제자리에 남겼다. 공용 모듈 주석에는 옮긴 것이 65개라고 적혀 있다.

이 커밋에서 동작이 바뀐 곳이 하나 있다. 오류 로그 문구가 17곳에서 제각각이었다. 한국어로 쓴 곳도 있었고, is가 빠진 not a number도 있었다. 이걸 "<VAR> is not a number: %r" 하나로 맞췄다. 문구가 달랐던 사본도 옮겨진 걸 보면 대조할 때 로그 문자열은 같음 판정에서 빼고 따로 다뤘을 것으로 보지만, 비교 스크립트가 없어서 확인하지는 못했다. 검증은 같은 방식으로 다시 했다. 판정 326개(그중 id 111개)를 옛 코드와 새 코드에서 뽑아 차이 0이었다. 줄 수로는 446줄이 줄었다.

남은 dead code는 이름으로 한 번 더 찾았다

정리하는 김에 vulture와 ruff로 안 쓰이는 코드도 찾았다. 도구가 내놓은 후보를 바로 지우지 않고, 저장소 전체와 운영 데이터 디렉터리까지 이름으로 다시 grep 해서 호출처가 0인 것만 지웠다. 함수 23개, import 20개, 쓰기만 하고 읽지 않던 변수 몇 개로 317줄이었다.

호출처가 없어도 남긴 함수가 있다. 운영 중에 docker exec로 컨테이너에 들어가 손으로 부르는 도구 함수들이다. 코드 안에서는 아무도 부르지 않으니 정적 분석에는 죽은 코드로 보인다. 패키지의 __init__에서 다시 내보내는 핸들러 두 개도 같은 이유로 남겼다.

제자리에 남긴 사본들

지금 공용 모듈에 들어간 건 켜기/끄기 두 갈래와 숫자 id 두 모양이다. 뜻이 달라 남긴 숫자 id 사본들은 여전히 각 파일에 있고, 각자 이름이 같거나 비슷하다. 이 사본들을 합치려면 이름보다 빈 값, off, 숫자가 아닌 값을 받았을 때 각각 무엇을 돌려주는지를 먼저 봐야 한다. AST 대조 스크립트는 저장소에 없으니 그때는 다시 써야 하고, 운영 설정으로 옛 코드와 새 코드의 판정을 맞대는 검증도 다시 돌려야 한다.