2to3 — Automated Python 2 to 3 code translation¶
2to3는 파이썬 2.x 소스 코드를 유효한 파이썬 3.x 코드로 변환하기 위해 일련의 변환자(fixers)를 적용하는 프로그램입니다. 표준 라이브러리는 많은 양의 변환자를 제공하고 있어 코드 대부분을 처리할 수 있을 것입니다. 2to3에서 사용하는 모듈인 lib2to3
는 유연하고 제네릭합니다. 따라서 2to3 프로그램을 위해 당신만의 변환자를 작성할 수 있습니다.
버전 3.11에서 폐지되었습니다, 버전 3.13에서 제거됩니다.: The lib2to3
module was marked pending for deprecation in Python 3.9
(raising PendingDeprecationWarning
on import) and fully deprecated
in Python 3.11 (raising DeprecationWarning
). The 2to3
tool is
part of that. It will be removed in Python 3.13.
2to3 사용법¶
파이썬 인터프리터가 설치될 때, 보통 2to3 스크립트도 같이 설치됩니다. 2to3 스크립트 파일은 파이썬 루트 디렉터리의 하위 디렉터리인 Tools/scripts
에서 찾을 수 있습니다.
2to3의 기본 인자는 변환하고자 하는 파일이나 디렉터리 리스트입니다. 디렉터리의 경우 하위 폴더의 파이썬 소스까지 적용됩니다.
샘플 파이썬 2.x 코드가 여기 있습니다. example.py
:
def greet(name):
print "Hello, {0}!".format(name)
print "What's your name?"
name = raw_input()
greet(name)
명령줄에서 2to3를 실행하면 이 코드를 파이썬 3.x 코드로 바꿀 수 있습니다:
$ 2to3 example.py
원본 파일과 변환 결과를 비교한 차이점(diff)이 출력됩니다. 2to3은 원본 소스 파일에 필요한 수정사항을 바로 적용할 수도 있습니다. (-n
옵션이 적용되지 않았다면 원본 파일에 대한 백업이 생성될 것입니다.) -w
옵션을 사용하면 바로 원본 파일이 수정됩니다.
$ 2to3 -w example.py
example.py
를 변환한 결과는 다음과 같습니다.
def greet(name):
print("Hello, {0}!".format(name))
print("What's your name?")
name = input()
greet(name)
변환 과정에서 들여쓰기와 주석은 그대로 보존됩니다.
기본적으로 2to3는 미리 정의된 변환자 를 사용하여 실행됩니다. -l
옵션을 사용하면 사용 가능한 모든 변환자를 볼 수 있습니다. 특정 변환자만 명시적으로 설정하고 싶으시면 -f
를 사용하시면 됩니다. 마찬가지로 -x
옵션으로 특정 변환자를 비활성화할 수도 있습니다. 다음 예는 imports
와 has_key
변환자만 사용한 것입니다.
$ 2to3 -f imports -f has_key example.py
다음은 apply
변환자만 빼고 모든 변환자를 실행하는 명령어입니다.
$ 2to3 -x apply example.py
몇몇 변환자는 기본적으로 실행되지 않기 때문에 명시적으로 명령줄에서 설정해야 합니다. 기본 변환자에 idioms
변환자를 추가한 예시가 여기 있습니다.
$ 2to3 -f all -f idioms example.py
모든 기본 변환자를 활성화하기 위해 all
값을 사용한 것을 주목해주세요.
때때로 2to3는 자동 변환을 하지 못하고 당신의 코드에서 수정이 필요한 부분을 찾을 수도 있습니다. 이러면 파일의 비교 결과 아래에 경고 문구를 출력할 것입니다. 당신은 이 소스코드를 3.x 버전에 맞도록 경고 사항을 수정해야 합니다.
2to3는 doctest도 수정할 수 있습니다. 이것을 활성화하기 위해서는 -d
옵션을 사용하세요. 이것은 오직 doctest만 수정한다는 것을 명심하세요. 이것을 사용하기 위해서 꼭 적합한 파이썬 모듈이 필요한 것은 아닙니다. 예를 들어 reST 문서에 있는 예와 같은 doctest도 이 옵션과 함께 수정할 수 있습니다.
-v
옵션은 변환 과정 동안 더 자세한 정보를 출력하게 해줍니다.
어떤 print 문장의 경우는 문장 또는 함수 호출로 파싱될 수 있기 때문에 2to3이 print 함수를 포함한 파일을 항상 처리할 수 있는 것은 아닙니다. 2to3이 from __future__ import print_function
이란 컴파일러 지시어를 찾았다면 2to3는 print()
를 함수로 처리하도록 내부 처리 문법을 변경할 것입니다. 이러한 변경은 -p
옵션을 가지고 직접 활성화할 수도 있습니다. 출력 문장이 이미 변경된 코드에 변환자를 실행하기 위해 -p
옵션을 사용하세요. 또한 -e
를 사용하여 exec()
를 함수로 만들 수 있습니다.
-o
또는 --output-dir
옵션을 사용하면 출력 파일이 쓰일 디렉터리를 설정할 수 있습니다. -n
옵션은 입력 파일을 덮어쓰지 않아 백업 파일이 필요 없을 때 사용할 수 있습니다.
버전 3.2.3에 추가: -o
옵션이 추가되었습니다.
-W
또는 --write-unchanged-files
옵션은 변경 사항이 없더라도 항상 출력 파일을 쓰도록 합니다. 이것을 -o
옵션과 함께 쓰면 한 디렉터리에 있는 전체 파이썬 소스 트리를 파이썬 3.x로 변환해서 다른 디렉터리로 복사할 때 유용하게 사용할 수 있습니다. 이치에 맞게 하기 위해 이 옵션은 -w
옵션을 포함하고 있습니다.
버전 3.2.3에 추가: -W
옵션이 추가되었습니다.
--add-suffix
옵션은 모든 출력 파일 이름 뒤에 추가할 문자열을 지정합니다. 다른 파일 이름으로 저장할 때 백업 파일이 필요하지 않다면 -n
옵션을 같이 사용해야 합니다. 예시:
$ 2to3 -n -W --add-suffix=3 example.py
이 명령어는 출력 파일의 이름을 example.py3
로 만들어 줍니다.
버전 3.2.3에 추가: --add-suffix
옵션이 추가되었습니다.
한 디렉터리에서 다른 디렉터리로 전체 프로젝트를 변환하고 싶을 때는 다음과 같이 하면 됩니다.
$ 2to3 --output-dir=python3-version/mycode -W -n python2-version/mycode
변환자 목록¶
변환되는 코드의 각각 단계는 변환자 안에 캡슐화되어 있습니다. 2to3 -l
명령어를 실행하면 변환자 목록을 보실 수 있습니다. 위에 적어놓은 것 과 같이, 각 변환자는 개별적으로 활성화/비활성화를 할 수 있습니다. 변환자들에 대한 자세한 설명이 아래에 있습니다.
- apply¶
apply()
사용을 제거합니다. 예를 들어apply(function, *args, **kwargs)
를function(*args, **kwargs)
로 변경합니다.
- asserts¶
폐지된
unittest
메서드 이름을 올바른 것으로 변경합니다.변경 전
변경 후
failUnlessEqual(a, b)
assertEquals(a, b)
failIfEqual(a, b)
assertNotEquals(a, b)
failUnless(a)
assert_(a)
failIf(a)
failUnlessRaises(exc, cal)
failUnlessAlmostEqual(a, b)
assertAlmostEquals(a, b)
failIfAlmostEqual(a, b)
assertNotAlmostEquals(a, b)
- buffer¶
buffer
를memoryview
로 변환합니다.memoryview
API가buffer
API와 비슷하긴 하지만 완전히 같진 않아서 이 변환자는 선택적으로 실행됩니다.
- dict¶
딕셔너리 이터레이션 메서드를 변환합니다.
dict.iteritems()
를dict.items()
로,dict.iterkeys()
를dict.keys()
로,dict.itervalues()
를dict.values()
로 변경합니다. 마찬가지로dict.viewitems()
,dict.viewkeys()
,dict.viewvalues()
를 각각dict.items()
,dict.keys()
,dict.values()
로 변경합니다. 기존의dict.items()
,dict.keys()
,dict.values()
의 사용을list
로 감싸도록 바꿉니다.
- except¶
except X, T
를except X as T
로 변환합니다.
- funcattrs¶
이름이 변경된 함수 어트리뷰트를 변환합니다. 예를 들어
my_function.func_closure
를my_function.__closure__
로 변경합니다.
- future¶
from __future__ import new_feature
구문을 제거합니다.
- getcwdu¶
os.getcwdu()
를os.getcwd()
로 변경합니다.
- has_key¶
dict.has_key(key)
를key in dict
로 바꿉니다.
- idioms¶
이 선택적인 변환자는 이디엄을 더 사용하도록 파이썬 코드를 변환해줍니다.
type(x) is SomeClass
나type(x) == SomeClass
같은 형 비교는isinstance(x, SomeClass)
로 변환합니다.while 1
는while True
로 변환합니다. 또한 이 변환자는sorted()
가 올바른 위치에 사용될 수 있도록 수정합니다. 예를 들어 다음 코드는L = list(some_iterable) L.sort()
아래와 같이 변경됩니다.
L = sorted(some_iterable)
- import¶
같은 단계 경로의 임포트를 찾아 상대 경로 임포트로 변경합니다.
- imports¶
표준 라이브러리에 있는 모듈의 이름 변경 사항을 처리합니다.
- input¶
input(prompt)
를eval(input(prompt))
로 변경합니다.
- intern¶
intern()
를sys.intern()
로 변경합니다.
- isinstance¶
isinstance()
의 두 번째 인자에서 중복된 형을 수정합니다. 예를 들어isinstance(x, (int, int))
를isinstance(x, int)
로,isinstance(x, (int, float, int))
를isinstance(x, (int, float))
로 변경합니다.
- itertools_imports¶
itertools.ifilter()
,itertools.izip()
,itertools.imap()
임포트를 제거합니다.itertools.ifilterfalse()
임포트를itertools.filterfalse()
로 바꿉니다.
- itertools¶
itertools.ifilter()
,itertools.izip()
,itertools.imap()
를 각각 그것에 맞는 내장 함수로 변경합니다.itertools.ifilterfalse()
를itertools.filterfalse()
로 변경합니다.
- map¶
map()
을list
로 감싸도록 바꿉니다.map(None, x)
를list(x)
로 바꿉니다.from future_builtins import map
를 사용하면 이 변환자가 비활성화됩니다.
- metaclass¶
구식의 메타 클래스 문법(클래스 바디에
__metaclass__ = Meta
를 사용)을 새로운 문법(class X(metaclass=Meta)
)으로 변경합니다.
- methodattrs¶
구식의 메서드 어트리뷰트 이름을 수정합니다. 예를 들어
meth.im_func
를meth.__func__
로 변경합니다.
- ne¶
구식의 부등호 문법인
<>
을!=
로 변경합니다.
- next¶
이터레이터의
next()
메서드 사용을next()
함수로 변경합니다. 또한next()
메서드를__next__()
로 바꿉니다.
- nonzero¶
Renames definitions of methods called
__nonzero__()
to__bool__()
.
- numliterals¶
8진수 리터럴을 새 문법으로 변경합니다.
- operator¶
operator
모듈에 있는 다양한 함수 호출을 그것에 대응하는 다른 함수 호출로 변경합니다.import collections.abc
와 같이 필요하다면import
구문도 추가됩니다. 다음과 같이 변경합니다.변경 전
변경 후
operator.isCallable(obj)
callable(obj)
operator.sequenceIncludes(obj)
operator.contains(obj)
operator.isSequenceType(obj)
isinstance(obj, collections.abc.Sequence)
operator.isMappingType(obj)
isinstance(obj, collections.abc.Mapping)
operator.isNumberType(obj)
isinstance(obj, numbers.Number)
operator.repeat(obj, n)
operator.mul(obj, n)
operator.irepeat(obj, n)
operator.imul(obj, n)
- paren¶
리스트 컴프리헨션 안에 괄호가 필요한 경우 추가합니다. 예를 들어
[x for x in 1, 2]
를[x for x in (1, 2)]
로 변경합니다.
- raise¶
raise E, V
를raise E(V)
로,raise E, V, T
를raise E(V).with_traceback(T)
로 변경합니다. 만약E
가 튜플인 경우, 변환된 결과물은 동작하지 않을 것입니다. 왜냐하면 튜플이 예외를 대체하는 것은 3.0부터 사라졌기 때문입니다.
- reduce¶
reduce()
를functools.reduce()
로 변경합니다.
- reload¶
reload()
를importlib.reload()
로 변경합니다.
- renames¶
sys.maxint
를sys.maxsize
로 변경합니다.
- sys_exc¶
더 사용되지 않을
sys.exc_value
,sys.exc_type
,sys.exc_traceback
를sys.exc_info()
로 변경합니다.
- throw¶
제너레이터
throw()
메서드의 API 변경 사항을 반영합니다.
- tuple_params¶
묵시적으로 튜플 매개 변수를 언 패킹하는 것을 제거합니다. 이로 인해 이 변환자는 임시 변수를 추가합니다.
- ws_comma¶
쉼표로 구분뒨 아이템 목록에서 필요 이상의 공백을 제거합니다. 이 변경자는 선택적입니다.
- xreadlines¶
for x in file.xreadlines()
를for x in file
로 변경합니다.
lib2to3
— 2to3’s library¶
소스 코드: Lib/lib2to3/
버전 3.11에서 폐지되었습니다, 버전 3.13에서 제거됩니다.: Python 3.9 switched to a PEG parser (see PEP 617) while lib2to3 is
using a less flexible LL(1) parser. Python 3.10 includes new language
syntax that is not parsable by lib2to3’s LL(1) parser (see PEP 634).
The lib2to3
module was marked pending for deprecation in Python 3.9
(raising PendingDeprecationWarning
on import) and fully deprecated
in Python 3.11 (raising DeprecationWarning
).
It will be removed from the standard library in Python 3.13.
Consider third-party alternatives such as LibCST or parso.
참고
lib2to3
API는 미래에 크게 바뀔 수 있기 때문에 안정적이지 않다고 생각해야 합니다.