
어떤 프로젝트인가요
Gawain이라는 오픈소스 도구가 공개됐어요. 소개가 아주 직설적이에요. 파이썬의 모든 변수에 타입 힌트를 요구한다. 함수 인자나 반환값에만 붙이라는 게 아니라, 변수 하나하나에 전부 붙이라는 거예요.
파이썬 코드를 좀 써본 분이라면 “그건 좀 과한데?” 싶을 수도 있고, 반대로 “우리 팀에 딱 필요했던 건데?” 싶을 수도 있어요. 반응이 갈리는 지점 자체가 이 도구의 재미있는 부분이라, 기능 소개보다는 이 도구가 던지는 질문을 같이 따져보려고 해요. 설치 방법이나 세부 옵션은 저장소 README를 직접 확인하시는 걸 권해요.
타입 힌트, 어디까지가 보통인가요
타입 힌트가 뭐냐면, 변수나 함수에 “여기엔 이런 종류의 값이 들어와요”라고 적어두는 메모예요. count: int = 0처럼 쓰는데, 변수에 붙이는 문법은 파이썬 3.6에서 들어왔어요. 중요한 건 파이썬 자체는 이 메모를 실행 중에 검사하지 않는다는 점이에요. count: int = '안녕'이라고 써도 프로그램은 그냥 돌아가요. 그래서 mypy나 pyright 같은 타입 검사기를 따로 돌려서 메모와 실제 코드가 어긋나는 곳을 찾아내죠.
그런데 기존 도구들이 “반드시 적어라”고 강제하는 범위는 대부분 함수의 경계까지예요. mypy의 disallow_untyped_defs 옵션이나 Ruff의 ANN 규칙이 대표적인데, 함수 인자와 반환값에 힌트가 없으면 경고를 내요. 함수 안의 지역 변수는 건드리지 않고요. total = price * 2라고만 써도 검사기가 “price가 int니까 total도 int겠네” 하고 알아서 추론하기 때문이에요. 추론이 안 되는 경우, 예를 들어 items = []처럼 빈 리스트로 시작할 때만 mypy가 타입을 적어달라고 요구하죠.
Gawain은 이 관행에서 한 발 더 나가요. 추론할 수 있든 없든 사람이 직접 적으라는 입장이에요.
전부 적으면 뭐가 좋고 뭐가 나쁠까요
좋은 점부터 볼게요. 첫째, IDE 없이도 코드가 읽혀요. 깃허브 리뷰 화면에서는 변수 위에 마우스를 올려 추론된 타입을 볼 수 없잖아요. result = service.fetch(user_id)만 보고는 result가 뭔지 모르지만, result: list[Order] = ...라고 적혀 있으면 바로 알 수 있죠. 둘째, 의도가 계약처럼 남아요. fetch의 반환 타입이 어느 날 바뀌면, 그 값을 받는 줄에서 곧바로 불일치가 드러나요. 셋째, AI가 써준 코드를 검토할 때 도움이 돼요. 사람이 한 줄씩 짜지 않은 코드일수록 “이 변수에 뭐가 들어 있다고 가정했는지”가 겉으로 드러나 있는 편이 안전하거든요.
나쁜 점도 분명해요. name: str = 'kim'처럼 누가 봐도 뻔한 곳까지 적어야 하니 코드가 장황해져요. 리팩터링할 때 고칠 곳도 늘어나고요. 그리고 이런 규칙은 한번 켜면 팀 전체의 코딩 습관을 바꾸는 일이라, 도입 비용이 도구 설치보다 훨씬 커요.
파이썬 문법이 만드는 걸림돌
여기에 파이썬 문법 차원의 숙제가 하나 더 있어요. 사실 파이썬에는 타입 힌트를 붙일 자리가 없는 변수가 꽤 많거든요. for i in range(3):의 i에는 힌트를 직접 붙일 수 없어요. with open(path) as f:의 f도, a, b = pair 같은 언패킹도, 리스트 컴프리헨션 안의 변수도, 람다의 인자도 마찬가지예요. 반복문 변수에 굳이 적으려면 i: int처럼 위에서 미리 선언해 두고 그다음 줄에서 반복문을 써야 하죠.
그래서 “모든 변수”를 어디까지로 볼 것인지가 이런 도구의 가장 중요한 설계 결정이에요. 반복문 변수까지 미리 선언하게 만들면 일관성은 생기지만 코드가 눈에 띄게 길어지고, 예외로 빼주면 “전부”라는 말이 조금 무뎌지죠. Gawain을 써보실 분은 이 경계를 어떻게 처리하는지부터 확인해 보세요.
다른 언어들은 어느 쪽으로 가고 있나요
업계의 큰 흐름은 사실 반대 방향이에요. 자바는 버전 10에서 var를, C++은 auto를 들여와서 지역 변수 타입을 생략할 수 있게 했어요. 러스트와 Go도 함수 시그니처에는 타입을 반드시 쓰게 하면서 지역 변수는 추론에 맡기고요. “경계는 명시적으로, 내부는 추론으로”가 정적 타입 언어들이 오랜 시간에 걸쳐 도달한 합의에 가까워요. 타입스크립트의 noImplicitAny도 추론이 실패할 때만 적으라고 하지, 전부 적으라고 하지는 않죠.
그러니 Gawain은 주류를 거스르는 실험이에요. 다만 파이썬은 사정이 조금 달라요. 타입 검사가 선택 사항이라 팀마다 엄격함이 제각각이고, 검사기를 아예 안 돌리는 프로젝트도 많아요. 그런 환경에서는 “추론에 맡긴다”가 곧 “아무도 모른다”가 되기 쉬워서, 차라리 눈에 보이게 다 적자는 주장이 설 자리가 생기는 거예요.
실무에서는 어떻게 받아들이면 좋을까요
FastAPI나 Pydantic 덕분에 국내에서도 타입 힌트는 이미 익숙한 도구가 됐어요. 그래도 저라면 프로젝트 전체에 바로 켜기보다는 순서를 밟을 것 같아요. 먼저 Ruff의 ANN 규칙과 mypy strict 모드로 함수 경계부터 채우고, 그다음에 결제나 정산처럼 실수 비용이 큰 핵심 모듈에만 “변수까지 전부”를 시험해 보는 식이죠. 주니어 교육용 저장소나 AI 에이전트가 주로 코드를 쓰는 저장소도 좋은 실험 대상이에요. 반대로 탐색적인 데이터 분석 노트북에 이런 규칙을 걸면 생산성만 떨어질 가능성이 커요.
한 줄 정리: Gawain은 “추론할 수 있어도 사람이 적어야 하는가”라는 질문을 도구로 만들어 던진 프로젝트예요.
여러분 팀은 타입 힌트를 어디까지 강제하고 있나요? 지역 변수까지 전부 적는 쪽과 추론에 맡기는 쪽, 리뷰할 때 어느 코드가 더 읽기 편하셨는지 궁금해요.
🔗 출처: Hacker News