Python 2와 Python 3, 무엇이 ‘하위 호환되지 않음’을 의미할까요?

오래된 Python 2 스크립트를 Python 3 환경에서 실행하려다 당황하신 적이 있나요? Wikipedia에 따르면 Python 3.0은 이전 버전과 완전히 하위 호환되지 않는 주요 개정판으로, 새로운 의미론과 변경된 구문을 포함한다고 명시되어 있습니다. 많은 개발자들이 “단순히 print 문법처럼 구문만 바뀐 건가?”, “아니면 유니코드 처리 방식처럼 더 깊은 근본적인 변화가 있었던 건가?”라는 의문을 가집니다. 이 글에서는 Python 2와 Python 3 간의 ‘하위 호환성 없음’이 정확히 무엇을 의미하는지 파헤치고, 여러분의 코드를 성공적으로 마이그레이션하기 위한 전략을 제시합니다.

1. 에러 발생 상황

개발자가 Python 2로 작성된 레거시 코드, 특히 오랫동안 유지보수되지 않았거나 특정 라이브러리에 의존하는 스크립트를 Python 3 인터프리터에서 실행하려고 할 때 흔히 발생합니다. 이 과정에서 SyntaxError, TypeError, ImportError 등 다양한 유형의 에러가 발생하며, 이는 Python 버전 간의 근본적인 차이 때문에 나타납니다.

예를 들어, Python 2 스크크립트의 print 문을 Python 3에서 실행하면 다음과 같은 에러를 볼 수 있습니다.

# Python 2 코드 예시
print "Hello, World!"

이 코드를 Python 3에서 실행하면 SyntaxError: Missing parentheses in call to 'print'와 같은 오류가 발생합니다. 이는 단순한 문법 변경의 한 예시일 뿐, 더 깊은 변화들이 존재합니다.

2. 명확한 발생 원인

Python 2와 Python 3의 ‘하위 호환성 없음’은 단순히 몇몇 문법이 바뀐 것을 넘어, 언어의 핵심적인 부분에서 철학적이고 구조적인 변화가 있었음을 의미합니다.

가. 단순한 문법 변화를 넘어선 근본적인 차이

• print 문 vs. print() 함수:

  Python 2에서 print는 문(statement)이었지만, Python 3에서는 필수적으로 괄호를 사용해야 하는 함수(function)로 변경되었습니다.

  # Python 2
  print "Hello"
  print "Hello", "World" # 공백으로 구분
  print ("Hello") # 괄호가 있어도 동작
  
  # Python 3
  print("Hello")
  print("Hello", "World") # 튜플로 인식하지 않고 여러 인자로 인식
  # print "Hello" # SyntaxError 발생

• 정수 나눗셈:

  Python 2에서는 / 연산자가 두 정수에 대해 정수 나눗셈을 수행했습니다. Python 3에서는 /가 항상 부동 소수점 나눗셈을 수행하며, 정수 나눗셈을 원하면 //를 사용해야 합니다.

  # Python 2
  print 5 / 2   # 결과: 2
  print 5.0 / 2 # 결과: 2.5
  
  # Python 3
  print(5 / 2)   # 결과: 2.5
  print(5 // 2)  # 결과: 2

• range(), map(), filter() 등:

  Python 2에서는 이러한 함수들이 즉시 리스트를 반환했지만, Python 3에서는 메모리 효율성을 위해 이터레이터(iterator)를 반환합니다. 리스트가 필요하면 명시적으로 list()로 감싸야 합니다.

  # Python 2
  print range(3) # 결과: [0, 1, 2]
  
  # Python 3
  print(range(3)) # 결과: range(0, 3)
  print(list(range(3))) # 결과: [0, 1, 2]

나. 유니코드 처리 방식의 변화

가장 중요한 변화 중 하나로, Python 3는 유니코드를 기본으로 채택하여 문자열 처리 방식이 완전히 달라졌습니다.

• Python 2: 기본 문자열 타입은 str(바이트 시퀀스)였고, 유니코드 문자열은 별도의 unicode 타입으로 명시적으로 다루어야 했습니다. 이로 인해 인코딩/디코딩 오류가 자주 발생했습니다.
• Python 3: 기본 문자열 타입은 str(유니코드 텍스트)이며, bytes 타입이 별도로 존재하여 원시 바이트 데이터를 다룹니다. 모든 텍스트 처리는 유니코드를 기반으로 하며, 파일 I/O나 네트워크 통신 시 명시적인 인코딩(.encode()) 및 디코딩(.decode())이 필요합니다.

# Python 2 (Encoding/Decoding이 명시적이지 않아 문제 발생 가능성 높음)
s = "안녕"
print type(s) #  (바이트)
u = u"안녕"
print type(u) # 

# Python 3 (모든 텍스트는 유니코드 str)
s = "안녕"
print(type(s)) #  (유니코드)
b = s.encode('utf-8')
print(type(b)) # 
print(b.decode('utf-8')) # "안녕"

다. 예외 처리 구문

예외(Exception)를 포착하는 구문도 변경되었습니다.

# Python 2
try:
    # ...
except Exception, e:
    print e

# Python 3
try:
    # ...
except Exception as e:
    print(e)

라. 모듈 이름 변경 및 재구성

많은 표준 라이브러리 모듈의 이름이 변경되거나 여러 모듈로 재구성되었습니다. 예를 들어 urllib, urllib2, urlparse, robotparser는 Python 3에서 urllib 패키지 아래의 urllib.request, urllib.parse, urllib.error 등으로 통합되었습니다.

3. 해결 방법 및 코드 예시

Python 2 코드를 Python 3으로 마이그레이션하는 것은 단순히 몇 줄을 수정하는 것 이상의 노력이 필요할 수 있지만, 다음 전략들을 통해 체계적으로 접근할 수 있습니다.

가. 2to3 툴 사용

Python 공식 배포판에 포함된 2to3 툴은 많은 Python 2 코드를 Python 3 문법으로 자동 변환해 줍니다. 특히 print 문, 예외 처리 구문 등 비교적 간단한 문법 변화는 이 툴로 쉽게 해결할 수 있습니다.

# 변환될 스크립트가 있는 디렉토리에서 실행
2to3 -w your_script.py # -w 옵션은 원본 파일을 덮어씁니다 (백업 권장)
2to3 -w -n my_project/ # my_project 디렉토리 내의 모든 Python 파일을 변환 (-n은 백업 파일을 생성하지 않음)

하지만 2to3는 모든 변경 사항을 처리하지 못하며, 특히 유니코드 처리나 복잡한 모듈 재구성과 같은 깊은 변화는 수동 수정이 필요합니다.

나. 유니코드 처리의 명확화

Python 3에서는 모든 텍스트를 str(유니코드)로, 바이너리 데이터를 bytes로 명확히 구분해야 합니다.

• 파일을 열 때는 항상 encoding 파라미터를 지정합니다.

# Python 2 (암시적 인코딩으로 인한 문제 발생 가능성)
f = open('data.txt', 'r')
content = f.read()

# Python 3 (명시적인 인코딩 지정)
with open('data.txt', 'r', encoding='utf-8') as f:
    content = f.read() # content는 str (유니코드 텍스트)

# bytes 데이터를 다룰 때
binary_data = b"hello" # bytes 리터럴
text_data = binary_data.decode('utf-8') # bytes -> str
re_encoded = text_data.encode('utf-8') # str -> bytes

다. 모듈 임포트 및 함수 호출 수정

변경되거나 재구성된 모듈을 사용하는 경우, 새로운 이름과 구조에 맞춰 import 문과 함수 호출 방식을 수정해야 합니다.

# Python 2
import urllib2
response = urllib2.urlopen('http://example.com')

# Python 3
import urllib.request
response = urllib.request.urlopen('http://example.com')

라. 가상 환경 및 의존성 관리

Python 2와 Python 3 프로젝트를 동시에 관리해야 한다면 virtualenv 또는 conda와 같은 가상 환경 도구를 사용하여 각 프로젝트별 Python 버전과 라이브러리 의존성을 분리하는 것이 필수적입니다.

# Python 3 가상 환경 생성 및 활성화
python3 -m venv myenv3
source myenv3/bin/activate
pip install -r requirements.txt

4. 향후 예방을 위한 팁

Python 2는 2020년 1월 1일부로 공식적인 지원이 종료되었습니다. 따라서 새로운 프로젝트는 무조건 Python 3으로 시작하는 것이 바람직하며, 기존 Python 2 코드도 가능한 한 빨리 Python 3으로 마이그레이션하는 것을 권장합니다.

• 새 프로젝트는 Python 3으로 시작: 보안 업데이트 및 새로운 기능 추가가 중단된 Python 2를 사용하는 것은 이제 피해야 합니다.
• six 라이브러리 활용: 만약 Python 2와 Python 3 모두에서 동작하는 코드를 작성해야 한다면, six 라이브러리를 사용하여 호환성 계층을 제공할 수 있습니다.
• 지속적인 코드 업데이트: 사용 중인 라이브러리 및 프레임워크의 최신 버전을 유지하고, 변경 사항에 대한 문서를 주기적으로 확인하세요.
• 강력한 테스트 코드 작성: 마이그레이션 과정에서 예상치 못한 문제가 발생할 수 있으므로, 기능 및 통합 테스트를 철저히 작성하여 코드 변경 후에도 애플리케이션이 정상 작동하는지 확인하는 것이 중요합니다.

Python 2와 Python 3 간의 차이를 이해하고 적절한 마이그레이션 전략을 적용한다면, ‘하위 호환성 없음’이라는 장벽을 넘어 더욱 현대적이고 안전하며 효율적인 Python 개발 환경을 구축할 수 있을 것입니다.