当前位置 主页 > 网站技术 > 代码类 >

    如何将你的应用迁移到Python3的三个步骤

    栏目:代码类 时间:2019-12-22 12:06

    Python 2.x 很快就要 失去官方支持 了,尽管如此,从 Python 2 迁移到 Python 3 却并没有想象中那么难。我在上周用了一个晚上的时间将一个 3D 渲染器的前端代码及其对应的 PySide 迁移到 Python 3,回想起来,尽管在迁移过程中无可避免地会遇到一些牵一发而动全身的修改,但整个过程相比起痛苦的重构来说简直是出奇地简单。

    每个人都别无选择地有各种必须迁移的原因:或许是觉得已经拖延太久了,或许是依赖了某个在 Python 2 下不再维护的模块。但如果你仅仅是想通过做一些事情来对开源做贡献,那么把一个 Python 2 应用迁移到 Python 3 就是一个简单而又有意义的做法。

    无论你从 Python 2 迁移到 Python 3 的原因是什么,这都是一项重要的任务。按照以下三个步骤,可以让你把任务完成得更加清晰。

    1、使用 2to3

    从几年前开始,Python 在你或许还不知道的情况下就已经自带了一个名叫 2to3 的脚本,它可以帮助你实现大部分代码从 Python 2 到 Python 3 的自动转换。

    下面是一段使用 Python 2.6 编写的代码:

    #!/usr/bin/env python 
    # -*- coding: utf-8 -*- 
    mystring = u'abcdé' 
    print ord(mystring[-1]) 
    

    对其执行 2to3 脚本:

    $ 2to3 example.py 
    RefactoringTool: Refactored example.py 
    --- example.py   (original) 
    +++ example.py   (refactored) 
    @@ -1,5 +1,5 @@ 
     #!/usr/bin/env python 
     # -*- coding: utf-8 -*- 
     
    -mystring = u'abcdé' 
    -print ord(mystring[-1]) 
    +mystring = 'abcdé' 
    +print(ord(mystring[-1])) 
    RefactoringTool: Files that need to be modified: 
    RefactoringTool: example.py 
    

    在默认情况下,2to3 只会对迁移到 Python 3 时必须作出修改的代码进行标示,在输出结果中显示的 Python 3 代码是直接可用的,但你可以在 2to3 加上 -w 或者 --write 参数,这样它就可以直接按照给出的方案修改你的 Python 2 代码文件了。

    $ 2to3 -w example.py 
    [...] 
    RefactoringTool: Files that were modified: 
    RefactoringTool: example.py 
    

    2to3 脚本不仅仅对单个文件有效,你还可以把它用于一个目录下的所有 Python 文件,同时它也会递归地对所有子目录下的 Python 文件都生效。

    2、使用 Pylint 或 Pyflakes

    有一些不良的代码在 Python 2 下运行是没有异常的,在 Python 3 下运行则会或多或少报出错误,这种情况并不鲜见。因为这些不良代码无法通过语法转换来修复,所以 2to3 对它们没有效果,但一旦使用 Python 3 来运行就会产生报错。

    要找出这种问题,你需要使用 Pylint 、 Pyflakes (或 flake8 封装器)这类工具。其中我更喜欢 Pyflakes,它会忽略代码风格上的差异,在这一点上它和 Pylint 不同。尽管代码优美是 Python 的一大特点,但在代码迁移的层面上,“让代码功能保持一致”无疑比“让代码风格保持一致”重要得多。

    以下是 Pyflakes 的输出样例:

    $ pyflakes example/maths 
    example/maths/enum.py:19: undefined name 'cmp' 
    example/maths/enum.py:105: local variable 'e' is assigned to but never used 
    example/maths/enum.py:109: undefined name 'basestring' 
    example/maths/enum.py:208: undefined name 'EnumValueCompareError' 
    example/maths/enum.py:208: local variable 'e' is assigned to but never used 
    

    上面这些由 Pyflakes 输出的内容清晰地给出了代码中需要修改的问题。相比之下,Pylint 会输出多达 143 行的内容,而且多数是诸如代码缩进这样无关紧要的问题。