Supporting Python 3(支持python3)——2to3

最新推荐文章于 2024-07-15 10:52:23 发布
最新推荐文章于 2024-07-15 10:52:23 发布
阅读量624 收藏
点赞数
文章标签： python 测试 操作系统
原文链接：https://my.oschina.net/soarwilldo/blog/509030
版权

2019独角兽企业重金招聘Python工程师标准>>> hot3.png

2to3

虽然完全有可能直接在Python 3下跑你的Python 2代码并且当出现问题时马上修复它，但这很快就会变得非常乏味。你需要反每一个print语句改成print()函数，并且把每个一个“except Exception, e”改成新的“except Exception as esyntax”。这些变化用搜索和替换来做是很棘手的并且很快会推动兴奋感。幸运的是我们可以用2to3来自动执行这些无聊的变化。

使用2to3

2to3由几个部分组成。核心是lib2to3，一个包含重构Python代码支持的包。它可以分析代码并建立一个描述代码结构的解析树。你之后可以修改解析树并从它生成新的代码。在lib2to3里还有一个“固定剂（fixers）”的框架，这个框架是一个做像把print语句改成print()函数的特殊重构的模块。允许2to3转换Python 2成Python 3代码的固定剂（fixers）集合位于lib2to3.fixes。最后是可以你可以用来做转换的2to3脚本本身。

执行2to3是非常简单的。你给一个文件或者目录作为参数，它就会转换文件或者遍历目录寻找Python文件并转换它们。2to3会在输出里打印出所有的变化，但除非你使用-w标志否则它不会写到文件里。它会写进一个和原来文件名字相同的文件里并把旧文件保存在增加.bak后缀的文件里，所以如果你想要保持原来的文件名字不变你需要首先复制文件然后再转换副本。

如果在你的Python文件里有doctests，你还需要带-d选项执行第二2to3来转换doctests，并且如果你有本文doctests文件，你需要显示地在这些文件在执行。

$ 2to3 -w .
$ 2to3 -w -d .
$ 2to3 -w -d src/mypackage/README.txt
$ 2to3 -w -d src/mypackage/tests/*.txt

在Linux和OS X下2to3脚本安装Python执行文件相同的目录下。在Windows下它被作为2to3.py安装在你的Python安装目录下的Tools\Scripts目录，并且你需要给出完整的路径：

C:\projects\mypackage> C:\Python3.3\Tools\Scripts\2to3.py -w .

如果你经常执行2to3，或者你需要把Scripts目录加进系统路径里。

明确的固定器（fixers）

默认情况下，转换会使用在lib2to3.fixers包里除了buffer、idioms、set_literal和 ws_comma外所有的固定器（fixers）。这些只有在明确地在命令行里加上时才会被使用。在这种情况下你还是需要用all来指定默认的固定器（fixers）集合：

$ 2to3 -f all -f buffer .

buffer固定器（fixers）会用memoryview类型来替换buffer类型。buffer类型在Python已经消失了并且memoryview类型不是完全兼容。所以当你做普通变化时buffer固定器（fixers）没有被包含进默认里。

另外三个固定器（fixers）会做一个格式上的变化但这不是是真正必需的。

idioms固定器（fixsers）会更新过时的风格。它会把type(x)== SomeType及其他的类型测试改成使用isinstance()，它会把在Python 1中用的旧式while 1: 改成while True:，并且它会把一些.sort()的使用改成sorted()（见使用sorted()代替 .sort()）。

set_literal固定器（fixers）会把set()构造器的调用改成使用新的集合文字（Set literals）。见集合文字（Set literals）。

ws_comma固定器（fixers）会修复代码中空白逗号及冒号。

有可能你会自己写固定器（fixers），虽然你极不可能需要这么做。更多的信息在使用你自己的固定器（fixers）扩展2to3 with 。

当在执行默认的固定器（fixers）集合时你也可以排除掉一个固定器（fixers）：

$ 2to3 -x print .

如果你不打算去支持Python 2，那么这就是所有你需要知道的2to3的内容了。你只需要执行一次2to3，然后到在常见的迁移问题里描述的修复迁移问题这个有趣的部分了。

分发包

当你写一个其他开发者在用的包或者模块时，你可能会想要继续支持Python 2。那么你需要确保Python 2和Python 3用户得到对应版本的包。如果你自己建包的网页的话，这可以很简单地在下载页记录。

大多数包通用使用distutils并上传到CheeseShop[1]，人们经常使用像easy_install或者pip这样工具从那里安装包。这些工具会下载包的最后一个版本并安装，如果你上传了Python 2和Python 3两个版本的包到CheeseShop，那么一些用户会下载错误的包并且不能安装你的包。

一个通常的解决办法是用两个独立的包名，就像mymodule和mymodule3这样，但是这样的话你就要维护两个包并且做两个发布版本。一个更好的解决办法是在一个分发文档中同时包含各版本的源树，例如src2给Python 2，src3是在Python 3下的。然后你可以在你的setup.py里根据Python的版本选择要安装哪个源树：

import sysfrom distutils.core import setup
if sys.version_info < (3,):
      package_dir = {'': 'src2'}
else:
      package_dir = {'': 'src3'}
      
setup(name='foo',
      version='1.0',
      package_dir = package_dir,
      )

这种方式所有你的模块包的用户都会下载相同的代码并且安装脚本会安装正确版本的代码。你的setup.py需要能同时在Python 2和Python 3下工作，这通常不是一个问题。看不用转换同时支持Python 2 和3来获得如何去做的帮助。

如果你有一个非常复杂的setup.py，你或许需要为每个Python版本准备一个，一个Python 2下调用setup2.py，一个Python 3下调用setup3.py。然后你写一个setup.py来根据Python版本选择正确的安装安装文件：I

import sys
if sys.version_info < (3,):
    import setup2
else:
    import setup3

在安装时执行2to3

官方的同时支持Python 2和Python 3的方式是修护一个Python 2版本的代码并用2to3工具转换成Python 3的。如果你这样做的话，似乎可以在安装转换你的发布版本。这种方式你不需要单独包甚至在发布两份代码的副本。

Distutils使用自定义的构建命令可以支持这个。在Python 3下用build_py_2to3替换build_py命令类：  

try:
   from distutils.command.build_py import build_py_2to3 \
        as build_py
except ImportError:
   from distutils.command.build_py import build_py

setup(
   ...
   cmdclass = {'build_py': build_py}
   )

然而，如果你想要用这个解决办法，你可以要从Distutils切换到Distribute，Distribute进一步扩展了这个理念并且紧密地整合进了开发过程中。

使用Distribute支持多个版本的Python

如果你想要用2to3同时支持Python 2和Python 3，那么你会发现Distribute[2]是很有帮助的。它是Distutils扩展了Phillip J. Eby的流行的Setuptools包的Python 3兼容分支。Distribute像Distutils做的那样加入了2to3的整合，所以它能为你解决发布问题，但是在你开发和测试包时它同样可以提供帮助。

当你使用2to3来同时支持Python 2和Python 3时，你需要在每一次修改时在运行测试前运行2to3。Distribute把这个过程整合进了test命令，这意味着你更新过的文件会被复制进构建并在构建目录里运行测试前使用2to3进行转换，所有的这些只要一个命令。在你修改代码后，只需要为每一个你需要支持Python版本执行python setup.py test来确保测试能跑。这使得能在一个舒服的环境里添加Python 3支持并能继续支持Python 2。

安装Distribute你需要从http://python-distribute.org/distribute_setup.py获得Distribute安装脚本并执行。然后要在所有你想要安装Distribute的Python版本下执行distribute_setup.py。Distribute主要兼容于Setuptools，所以在Python 2下你可以使用Setuptools来代替Distribute，但在Python 2下使用Distribute也一样并且这可能会更好的保持一致。

如果你在使用Distutils或者Setuptools来安装你的软件，你已经有一个setup.py。从Setuptools切换到Distribute你不需要做任何事。从Distutils切换到Distribute你需要修改导入setup()函数的地方。在Distutils里你从distutils.core导入，但在Setuptools和Distribute是从setuptools导入。

如果你没有setup.py，那么你需要创建一个。一个典型的setup.py例子就像这样：

from setuptools import setup, find_packages

readme = open('docs/README.txt', 'rt').read()
changes = open('docs/CHANGES.txt', 'rt').read()

setup(name='Supporting Python 3 examples',
      version="1.0",
      description="An example project for Supporting Python 3",
      long_description=readme + '\n' + changes,
      classifiers=[
          "Programming Language :: Python :: 2",
          "Topic :: Software Development :: Documentation"],
      keywords='python3 porting documentation examples',
      author='Lennart Regebro',
      author_email='regebro@gmail.com',
      license='GPL',
      packages=find_packages(exclude=['ez_setup']),
      include_package_data=True)

解释Distribute的所有复杂和可能的使用就超出了本书的范围了。Distribute的完整文档在http://packages.python.org/distribute。

使用Distribute运行测试

一旦你使用Distribute来打包你的模块，你就需要使用Distribute来运行你的测试。你可以添加test_suite参数到setup()调用的地方来告诉Distribute在哪能找到测试脚本。你也可以指定一个返回TestSuite类的模块、测试类或者函数来执行。经常地你可以把它设置成和基本包的名字相同。这将会让Distribute在那个包里寻找测试来运行。如果你有一个用于作为DocTests运行的单独文件，那么Distribute不会自动找到他们。在这些情况下，写一个使用所有测试返回TestSuite的函数是很容易的。

import unittest, doctest, StringIO

class TestCase1(unittest.TestCase):
    
    def test_2to3(self):
        assert True
        
def test_suite():
    suite = unittest.makeSuite(TestCase1)
    return suite

然后我们在setup()里指定这个函数：

from setuptools import setup, find_packages

readme = open('docs/README.txt', 'rt').read()
changes = open('docs/CHANGES.txt', 'rt').read()


setup(name='Supporting Python 3 examples',
      version="1.0",
      description="An example project for Supporting Python 3",
      long_description=readme + '\n' + changes,
      classifiers=[
          "Programming Language :: Python :: 2",
          "Topic :: Software Development :: Documentation"],
      keywords='python3 porting documentation examples',
      author='Lennart Regebro',
      author_email='regebro@gmail.com',
      license='GPL',
      packages=find_packages(exclude=['ez_setup']),
      include_package_data=True,
      test_suite='py3example.tests.test_suite')

现在你就可以使用python setup.py test来运行测试了。

使用Distribute运行2to3

一旦你在Python 2下做测试，你就可以把use_2to3关键字选项加进setup()里并且开始用Python 3开运行测试。也可以添加“Programming Language :: Python :: 3”到classifiers的列表里。这会告诉CheeseShop及你的用户，你支持Python 3。

from setuptools import setup, find_packages

readme = open('docs/README.txt', 'rt').read()
changes = open('docs/CHANGES.txt', 'rt').read()

setup(name='Supporting Python 3 examples',
      version="1.0",
      description="An example project for Supporting Python 3",
      long_description=readme + '\n' + changes,
      classifiers=[
          "Programming Language :: Python :: 2",
          "Programming Language :: Python :: 3",
          "Topic :: Software Development :: Documentation"],
      keywords='python3 porting documentation examples',
      author='Lennart Regebro',
      author_email='regebro@gmail.com',
      license='GPL',
      packages=find_packages(exclude=['ez_setup']),
      include_package_data=True,
      test_suite='py3example.tests.test_suite',
      use_2to3=True)

在Python 3下，测试命令现在会首先把文件复制进构建目录然后在他们上面运行2to3。之后它会从构建目录执行测试。在Python 2下use_2to3选项会被乎略。

Distribute会转换所有的Python文件及Python文件中的所有doctests，如果你的dctests位于单独的文本文件，它们就将不会被自动转换。通过把它们加进convert_2to3_doctests选项，Distribute将同样会转换它们。

使用额外的固定器（fixers），use_2to3_fixers可以设置一个包含固定器（fixers）的包的列表。这可以同时被包含于2to3的明确的固定器（fixers）及外部的固定器（fixers）使用，就像每一次你使用Zope Component Architecture时需要的固定器（fixers）。

from setuptools import setup, find_packages

readme = open('docs/README.txt', 'rt').read()
changes = open('docs/CHANGES.txt', 'rt').read()

setup(name='Supporting Python 3 examples',
      version="1.0",
      description="An example project for Supporting Python 3",
      long_description=readme + '\n' + changes,
      classifiers=[
          "Programming Language :: Python :: 2",
          "Programming Language :: Python :: 3",
          "Topic :: Software Development :: Documentation"],
      keywords='python3 porting documentation examples',
      author='Lennart Regebro',
      author_email='regebro@gmail.com',
      license='GPL',
      packages=find_packages(exclude=['ez_setup']),
      include_package_data=True,
      test_suite='py3example.tests.test_suite',
      use_2to3=True,
      convert_2to3_doctests=['doc/README.txt'],
      install_requires=['zope.fixers'],
      use_2to3_fixers=['zope.fixers'])

注意

当你修改setup.py时，可能会修改被转换的文件。最后一次运行时转换过程将会不知道哪些文件被修改了，所以不知道哪些文件在最后一次运行时被复制的文件现在需要复制并且转换。因些经常需要在修改setup.py后删除整个构建目录。

你现在应该已经准备好去偿试使用python3 setup.py test来在Python 3下执行测试了。很有可能一些测试会失败，但是只要2to3过程是工作的并测试在执行，甚至连它们也失败，那么你也走进了向支持Python 3前进的长路。现在是时候看看怎么修复这些失败的测试了，这将引导我们讨论觉的迁移问题。

附注：

[1]http://pypi.python.org/
[2]http://pypi.python.org/pypi/distribute


在湖闻樟注：

原文http://python3porting.com/2to3.html

引导页Supporting Python 3:（支持Python3）：深入指南

目录Supporting Python 3（支持Python 3）——目录


转载于:https://my.oschina.net/soarwilldo/blog/509030

weixin_34044273
关注
Kivy 模块使用python语言编译android可用的apk——第五章 分析buildozer.spec文件配置
lstef的博客
09-04 692
buildozer文件配置详解，以及如何确定依赖项，如何排除bug的技术及建议
RuntimeError: Click will abort further execution because Python was configured to use ASCII
xiaobai166的博客
11-30 745
RuntimeError: Click will abort further execution because Python was configured to use ASCII
Python3.x和Python2.x的区别
merryken的专栏
06-16 2320
这个星期开始学习Python了，因为看的书都是基于Python2.x，而且我安装的是Python3.1，所以书上写的地方好多都不适用于Python3.1，特意在Google上search了一下3.x和2.x的区别。特此在自己的空间中记录一下，以备以后查找方便，也可以分享给想学习Python的friends. 1.性能  Py3.0运行 pystone benchmark的速度比Py
使用Python内置2to3工具实现Python2.x代码向Python3.x代码的转换
Joker 007的博客
02-23 626
Python是非常热门的开发语言，并且也在不断的更新换代，而现在的Python3版本和以前的Python2有很多语法、格式存在不兼容 那有没有什么办法直接把用Python2写的代码文件直接转换成Python3的呢？ 答案自然是有的，官方已经考虑到这个问题了。Python3就自带有Python2to3工具，来解决这个问题。 下面就来介绍工具的用法吧！ 1. 首先要找到电脑中Python3.x的安装路...
Python｜pip 报错 use_2to3 is invalid 问题处理
最新发布
长行
07-15 370
参考链接：https://blog.csdn.net/u013938578/article/details/128753043。
解决python3安装库报use_2to3 is invalid的错误
qq_38723814的博客
11-16 1150
解决python3安装库报use_2to3 is invalid的错误
python 3.x 中无法导入 build_py_2to3
MrXunの博客
12-15 1447
cannot import name 'build_py_2to3' from 'distutils.command.build_py' 的解决办法
python3 2to3 模块
太阳爱编程
01-09 651
一、前言 因为种种原因，官方将在2020年1月1日停止发展python2相关模块，这就意味着所有使用Python2编写的项目都将接收不到官方的免费支持，更让人难受的是，Python3的一些细节比如包的导入，模块名等等都与Python不相同，由此而带来的最大的一个影响就是Python2向Python3的移植。为了解决这个问题，官方在我们安装Python3的同时，为提供一个2to3这个可执行文件。 ...
支持向量机算法简介以及利用以及python的实现
simonchen198774的博客
02-13 5752
支持向量机算法简介（Python） 一、支持向量机方法简介 支持向量机(SVM)是一种常见的分类方法，在机器学习领域，是一个有监督的学习模型，通常用来进行模式识别、分类以及回归分析。SVM的核心思想主要为两点： 1. 它基于结构风险最小化理论之上在特征空间中构建最优超平面，使得学习器得到全局最优化，并且在整个样本空间的期望以某个概率满足一定上界。 2. 它是针对线性可分情况进行分析...
pythonxx
FREDM1982的博客
04-20 1820
Skip to content 跳到内容 Sign up 报名 vinta vinta / awesome-python awesome-python Public 公共 A curated list of awesome Python frameworks, libraries, software and resources 一个令人敬畏的Python框架、库、软件和资源列表 awesome-python.com/ awesome-python.com/ View license 查看许可协议 124k
维特比算法 python_HMM-维特比算法理解与实现（python）
weixin_39646831的博客
12-14 720
解码问题给定观测序列 \(O=O_1O_2...O_T\)，模型 \(\lambda (A,B,\pi)\)，找到最可能的状态序列 \(I^∗=\{i^∗_1,i^∗_2,...i^∗_T\}\)近似算法在每个时刻 \(t\) 选择最可能的状态，得到对应的状态序列根据HMM-前向后向算法计算时刻 \(t\) 处于状态 \(i^*_t\) 的概率：\[i^∗_t=argmax[\gamma_t(i)...
python3软件怎么使用_Python3中的2to3转换工具使用示例
weixin_39999116的博客
11-24 107
python3与python2的还是有诸多的不同，比如说在2中:复制代码 代码如下:print "Hello,World!"raw_input()在3里面就成了:复制代码 代码如下:print ("Hello,World!")input()所以如果用的python2开发的项目要迁移到3中，就需要进行代码的转换。Python3中自带了个转换工具，下面用个最简单的例子来说说2to3转换工具。例子:(2...
python模块之lib2to3(py2转py3自动化工具)
weixin_33962923的博客
11-21 947
# -*- coding: utf-8 -*- #python 27 #xiaodeng #python模块之lib2to3(py2转py3自动化工具) #http://tieba.baidu.com/p/3939904893 #操作步骤： 1、需要转换test.py文件为py3代码 #test.py文件放置在Scripts目录下，如果test.py文件不放置在Scr...
2to3 - 自动将 Python 2 代码转为 Python 3 代码
eli的博客
12-21 970
2to3 是一个 Python 程序，它可以读取 Python 2.x 的源代码并使用一系列的修复器来将其转换为合法的 Python 3.x 代码。 标准库已包含了丰富的修复器，这足以处理几乎所有代码。 不过 2to3 的支持库lib2to3是一个很灵活通用的库，所以还可以编写你自己的 2to3 修复器。 使用 2to3 2to3 通常会作为脚本和 Python 解释器一起安装，你可以在 Python 根目录的Tools/scripts文件夹下找到它。 2to3 的基本调用参数是一个需要转...
python2到python3代码转化：2to3
weixin_40262196的博客
12-02 240
python2到python3代码转化：2to3 Windows系统上： 需要进入python3的安装目录，进入Tools/scirpt目录，找到“2to3.py”脚本。假设python3的安装目录为“C:\Users\Stary\AppData\Local\Continuum\Anaconda3”，则2to3.py文件所在路径为“C:\Users\Stary\AppData\Local\Cont...
pip 安装报错 error in anyjson setup command: use_2to3 is invalid.
qq_27371025的博客
07-18 4327
use_2to3 invalid
python3 x兼容python2 x_野子科技python3代码兼容python2
weixin_39887925的博客
11-28 253
野子电竞数据官网改版https://www.xxe.io/全新登场python3代码兼容python2的方式1.使用future特性Python的每个新版本都会增加一些新的功能，或者对原来的功能作一些改动。有些改动是不兼容旧版本的，也就是在当前版本运行正常的代码，到下一个版本运行就可能不正常了。Python提供了__future__模块，把下一个新版本的特性导入到当前版本，于是我们就可以在当前版本...
python3固定规则_Supporting Python 3(支持python3)——使用你自己的固定器扩展2to3
weixin_39996762的博客
12-08 251
使用你自己的固定器扩展2to32to3是围绕一个叫着lib2to3标准库包的封装。它包含一个代码分析器、一个用于设置修改解析树的固定器和一个巨大的固定器集合。包含在lib2to3里的固定器能做大多数可能自动完全的转换。然而在有些情况下你需要写自己的固定器。我首先想要向你保证这些情况是非常罕见的并且你不可能永远需要这一章，你跳过这一章也不会有什么不好的感觉。什么时候固定器是必须的强烈建议你添加Pyt...
pip install报错:setup command: use_2to3 is invalid
kalakala2525的博客
04-14 700
原因 use_2to3=True 表示将python2支持转化为python3支持 但是setuptools>=58的版本不支持该参数 解决 将setuptools降级 pip install setuptools==57.5.0
自支撑结构的3D打印技术
Deuss等人在2014年发表的文章《组装自我支撑结构》（Assembling Self-Supporting Structures）中探讨了这一主题。该研究团队包括来自不同机构的专家，如Mario Deuss、Daniele Panozzo、Emily Whiting、Yang Liu、...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值