복잡해진 파이썬, 팀 피터스의 ‘단순함’을 다시 묻다
핵심 요약
- 팀 피터스가 쓴 ‘파이썬의 선’은 단순함과 가독성을 강조하는 19개의 격언입니다.
- 팀소트는 데이터 안에서 이미 정렬된 구간을 찾아 활용하는 정렬 알고리즘입니다.
- 타입 힌트와 비동기는 문제 해결을 돕지만, 코드를 읽는 사람이 새로 배워야 할 것도 늘어납니다.
- 단순함을 판단하려면 코드 길이보다 읽는 사람이 무엇을 이해해야 하는지 살펴봐야 합니다.
“파이썬은 읽기 쉽다”는 말을 듣고 시작해도, 타입 표기와 async, await가 섞인 코드를 만나면 멈칫할 수 있습니다. 파이썬으로 다루는 문제가 다양해지면서 복잡한 기능을 쓰면서도 읽기 쉬운 코드를 유지하는 일이 고민거리로 남습니다. 이 고민을 풀 때 ‘파이썬의 선’과 정렬 알고리즘 팀소트를 만든 팀 피터스의 생각을 참고할 만합니다.
단순함은 코드 줄 수로 결정되지 않습니다
파이썬에서 import this를 실행하면 짧은 영어 문장들이 나타납니다. 팀 피터스가 쓴 ‘파이썬의 선’, 즉 The Zen of Python입니다. 파이썬다운 코드를 고민할 때 자주 꺼내 보는 19개의 격언입니다.
그중에는 단순한 것이 복잡한 것보다 낫다는 문장이 있습니다. 바로 다음에는 복잡한 것이 뒤얽힌 것보다 낫다는 문장이 나옵니다. 가독성이 중요하다는 원칙도 담겨 있습니다.
저는 이 문장들을 함께 읽어야 한다고 봅니다. 현실의 문제가 복잡하면 코드에도 그 복잡함이 어느 정도 들어올 수밖에 없습니다. 그렇더라도 읽는 사람이 불필요하게 헤매게 만들지는 말자는 뜻으로 읽힙니다.
예를 들어 여러 조건을 한 줄에 압축하면 화면은 깔끔해집니다. 하지만 동료가 그 한 줄을 풀어 읽느라 오래 고민한다면, 줄 수를 줄여도 얻는 게 별로 없습니다. 중간 결과에 이름을 붙여 다섯 줄로 쓰는 편이 더 쉽게 읽힐 수 있습니다.
팀소트에서 사용자가 누리는 단순함
팀 피터스가 단순함을 어떻게 생각했는지는 그가 만든 팀소트(Timsort)에서도 살펴볼 수 있습니다. 이 알고리즘은 만드는 사람과 사용하는 사람이 감당하는 복잡함이 서로 다르다는 점을 보여 줍니다.
팀소트는 데이터 안에서 이미 정렬된 구간을 찾아 활용합니다. 날짜순으로 정리된 주문 목록 여러 개를 이어 붙였다고 생각해 보세요. 전체 목록의 순서는 어긋나 있어도, 각 목록 안에서는 날짜순이 그대로 유지됩니다. 팀소트는 이렇게 정렬된 구간을 활용해 정렬합니다.
알고리즘이 이 일을 처리하려면 세밀한 규칙이 필요합니다. 어느 구간을 먼저 합칠지 판단해야 하고, 다양한 입력에서도 제대로 작동해야 합니다. 그래서 구현 자체를 보면 짧고 단순하다고만 하기는 어렵습니다.
파이썬 사용자는 sorted()에 데이터와 정렬 기준을 전달하면 됩니다. 파이썬 정렬에는 안정성이라는 성질도 있습니다. 정렬 기준값이 같은 항목끼리는 기존 순서를 유지한다는 뜻입니다. 시간순으로 놓인 주문을 가격순으로 다시 정렬하면, 같은 가격의 주문들은 원래의 시간순을 유지합니다.
정렬을 구현하는 쪽에서 어려운 일을 맡아 주면, 사용하는 쪽에서는 어떻게 동작할지 쉽게 알 수 있습니다. 사용자는 내부의 세밀한 규칙을 일일이 이해할 필요가 없습니다. 팀소트처럼 내부를 정교하게 만들수록 사용하는 사람의 부담이 줄어들기도 합니다.
타입 힌트와 비동기를 쓸 때 따져 볼 것
타입 힌트는 변수나 함수가 어떤 종류의 값을 다루는지 적는 표기입니다. 함수가 문자열을 받는지, 숫자를 반환하는지 드러내면 코드를 읽는 사람이 추측할 일이 줄어듭니다.
다만 타입 표현이 길고 복잡해지면 상황이 달라집니다. 함수가 실제로 무슨 일을 하는지 파악하는 시간보다 타입 선언을 이해하는 시간이 더 길어지기도 합니다. 설명을 도우려고 넣은 정보인데, 그 정보부터 따로 풀어 읽어야 하는 겁니다.
비동기 코드도 비슷합니다. async와 await는 네트워크 응답처럼 기다리는 시간이 있는 작업을 함께 처리할 때 유용합니다. 대신 개발자는 작업이 어디서 멈추고 다시 이어지는지 이해해야 합니다. CPU 계산을 무조건 빠르게 만드는 기능도 아닙니다.
이런 기능이 있다는 이유만으로 파이썬이 단순함을 잃었다고 단정하기는 어렵습니다. 그 기능이 해결하는 문제와 추가하는 부담을 함께 따져 봐야 합니다. 외부 요청을 많이 처리하는 서버와 파일 하나를 읽는 짧은 스크립트에 같은 구조가 필요하지는 않습니다.
‘무엇을 쓰지 않을지’도 정해야 합니다
선택지가 늘어나면 개발자는 기능을 배우는 데서 그치지 않고, 어디까지 쓸지도 정해야 합니다. 이때 팀 피터스의 원칙을 떠올리면 자신의 코드를 좀 더 구체적으로 살펴볼 수 있습니다.
동료가 이 표기를 보고 덜 추측해도 될지, 구조를 이해하려면 몇 개의 파일을 오가야 할지 살펴봅니다. 평범한 조건문으로 설명할 수 있는 일을 지나치게 일반화한 것은 아닌지도 따져 봅니다.
가령 공개 함수의 입력과 반환값에 타입을 표시하면 사용법이 더 분명해질 수 있습니다. 몇 줄짜리 일회성 작업에 복잡한 타입 체계를 넣으면 관리할 대상부터 늘어납니다. 기능을 어디까지 써야 도움이 될지 판단하는 일도 읽기 쉬운 코드를 만드는 과정에 포함됩니다.
라이브러리를 만드는 사람은 내부 구현이 조금 길어지더라도 사용자의 일을 덜어 줄 수 있을지 고민해야 합니다. 사용자가 매번 처리하던 예외와 절차를 내부에서 맡아 준다면 전체적인 부담은 줄어들 수 있습니다. 팀소트에서도 이런 설계 방식을 볼 수 있습니다.
저는 팀 피터스의 원칙을 코드에 적용할 때 읽는 사람의 이해 비용부터 살펴보려 합니다. 기능을 얼마나 많이 썼는지보다 그 기능 덕분에 무엇이 쉬워졌는지 설명할 수 있어야 합니다. 지금 작성 중인 코드에서도 다음 사람이 이해하려면 얼마나 많은 내용을 추측해야 하는지 확인해 보려 합니다.
댓글
댓글을 불러오는 중...