이 문서는 더는 지원되지 않는 이전 버전의 파이썬 용입니다. 업그레이드하고, 다음 설명서를 읽어야 합니다: 현재 안정 버전에 대한 파이썬 설명서.

# 2to3 - 파이썬 2에서 파이썬 3으로 자동 코드 변환

2to3는 파이썬 2.x 소스 코드를 유효한 파이썬 3.x 코드로 변환하기 위해 일련의 변환자(fixers)를 적용하는 프로그램입니다. 표준 라이브러리는 많은 양의 변환자를 제공하고 있어 코드 대부분을 처리할 수 있을 것입니다. 2to3에서 사용하는 모듈인 `lib2to3` 는 유연하고 제네릭합니다. 따라서 2to3 프로그램을 위해 당신만의 변환자를 작성할 수 있습니다.

## 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)` | `assertEqual(a, b)`
  `assertEquals(a, b)` | `assertEqual(a, b)`
  `failIfEqual(a, b)` | `assertNotEqual(a, b)`
  `assertNotEquals(a, b)` | `assertNotEqual(a, b)`
  `failUnless(a)` | `assertTrue(a)`
  `assert_(a)` | `assertTrue(a)`
  `failIf(a)` | `assertFalse(a)`
  `failUnlessRaises(exc, cal)` | `assertRaises(exc, cal)`
  `failUnlessAlmostEqual(a, b)` | `assertAlmostEqual(a, b)`
  `assertAlmostEquals(a, b)` | `assertAlmostEqual(a, b)`
  `failIfAlmostEqual(a, b)` | `assertNotAlmostEqual(a, b)`
  `assertNotAlmostEquals(a, b)` | `assertNotAlmostEqual(a, b)`

`basestring`

  `basestring` 을 `str` 로 변환합니다.

`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` 로 변환합니다.

`exec`

  `exec` 문장을 `exec()` 함수로 변환합니다.

`execfile`

  `execfile()` 사용을 제거합니다. `execfile()` 에 사용되는 인자는 `open()`, `compile()`, `exec()` 을 사용하도록 바뀝니다.

`exitfunc`

  `sys.exitfunc` 대입이 `atexit` 모듈을 사용하도록 바뀝니다.

`filter`

  `filter()` 함수 사용을 `list` 로 감싸도록 바꿉니다.

`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`

  표준 라이브러리에 있는 모듈의 이름 변경 사항을 처리합니다.

`imports2`

  표준 라이브러리에 있는 또 다른 모듈의 이름 변경 사항을 처리합니다. 기술적인 제한 사항 때문에 `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()` 로 변경합니다.

`long`

  `long` 을 `int` 로 바꿉니다.

`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)]` 로 변경합니다.

`print`

  `print` 구문을 `print()` 함수로 변경합니다.

`raise`

  `raise E, V` 를 `raise E(V)` 로, `raise E, V, T` 를 `raise E(V).with_traceback(T)` 로 변경합니다. 만약 `E` 가 튜플인 경우, 변환된 결과물은 동작하지 않을 것입니다. 왜냐하면 튜플이 예외를 대체하는 것은 3.0부터 사라졌기 때문입니다.

`raw_input`

  `raw_input()` 를 `input()` 로 변경합니다.

`reduce`

  `reduce()` 를 `functools.reduce()` 로 변경합니다.

`reload`

  `reload()` 를 `importlib.reload()` 로 변경합니다.

`renames`

  `sys.maxint` 를 `sys.maxsize` 로 변경합니다.

`repr`

  백틱 repr을 `repr()` 함수로 바꿉니다.

`set_literal`

  `set` 생성자를 집합 리터럴로 바꿉니다. 이 변환자는 선택적입니다.

`standarderror`

  `StandardError` 를 `Exception` 로 바꿉니다.

`sys_exc`

  더 사용되지 않을 `sys.exc_value`, `sys.exc_type`, `sys.exc_traceback` 를 `sys.exc_info()` 로 변경합니다.

`throw`

  제너레이터 `throw()` 메서드의 API 변경 사항을 반영합니다.

`tuple_params`

  묵시적으로 튜플 매개 변수를 언 패킹하는 것을 제거합니다. 이로 인해 이 변환자는 임시 변수를 추가합니다.

`types`

  `types` 모듈에서 몇몇 멤버가 삭제되어 코드가 동작하지 않던 것을 수정합니다.

`unicode`

  `unicode` 를 `str` 로 변경합니다.

`urllib`

  `urllib` 와 `urllib2` 를 `urllib` 패키지로 변경합니다.

`ws_comma`

  쉼표로 구분뒨 아이템 목록에서 필요 이상의 공백을 제거합니다. 이 변경자는 선택적입니다.

`xrange`

  `xrange()` 를 `range()` 로 바꿉니다. 기존 `range()` 를 `list` 로 감쌉니다.

`xreadlines`

  `for x in file.xreadlines()` 를 `for x in file` 로 변경합니다.

`zip`

  `zip()` 를 `list` 로 감쌉니다. 이 변환자는 `from future_builtins import zip` 가 있을 때는 비활성화됩니다.

## `lib2to3` - 2to3 라이브러리

소스 코드: Lib/lib2to3/

버전 3.10부터 폐지: 파이썬 3.9는 PEG 구문 분석기로 전환되며 (PEP 617을 참조하십시오), 파이썬 3.10에는 lib2to3의 LL(1) 구문 분석기로 구문 분석할 수 없는 새로운 언어 문법이 포함될 수 있습니다. `lib2to3` 모듈은 향후 파이썬 버전의 표준 라이브러리에서 제거될 수 있습니다. LibCST나 parso와 같은 제삼자 대안을 고려하십시오.

참고

`lib2to3` API는 미래에 크게 바뀔 수 있기 때문에 안정적이지 않다고 생각해야 합니다.