网站文章来源seo,可信网站认证收费吗,seo和sem,电子商城网站建设的实训内容目录 官方工具2to3工具安装参数解释基本使用工具缺陷 future工具安装参数解释基本使用工具缺陷 python-modernize工具安装参数解释基本使用工具缺陷 pyupgrade工具安装参数解释基本使用工具缺陷 对比 官方工具2to3
2to3 是Python官方提供的用于将Python 2代码转换为Python 3代… 目录 官方工具2to3工具安装参数解释基本使用工具缺陷 future工具安装参数解释基本使用工具缺陷 python-modernize工具安装参数解释基本使用工具缺陷 pyupgrade工具安装参数解释基本使用工具缺陷 对比 官方工具2to3
2to3 是Python官方提供的用于将Python 2代码转换为Python 3代码的工具。它能够自动检测Python 2代码中的语法和库差异并尝试进行相应的转换。
工具安装
2to3 是Python的一部分因此在安装Python时它会自动安装如果一些版本的python没有自带2to3工具可以使用pip命令安装
pip install 2to3要运行 2to3你可以在命令行中输入
2to3.exe --help$ 2to3.exe --help
用法2to3 [选项] 文件|目录...选项-h, --help 显示此帮助信息并退出-d, --doctests_only 仅修复文档测试-f FIX, --fixFIX 每个 FIX 指定一个转换默认全部-j PROCESSES, --processesPROCESSES并行运行 2to3-x NOFIX, --nofixNOFIX阻止运行某个转换-l, --list-fixes 列出可用的转换-p, --print-function 修改语法以使 print() 成为一个函数-e, --exec-function 修改语法以使 exec() 成为一个函数-v, --verbose 更详细的日志记录--no-diffs 不显示重构的差异-w, --write 写回修改后的文件-n, --nobackups 不为修改后的文件写备份-o OUTPUT_DIR, --output-dirOUTPUT_DIR将输出文件放在此目录中而不是覆盖输入文件。需要 -n。-W, --write-unchanged-files即使没有必要进行更改也写入文件与 --output-dir 一起使用很有用隐含 -w。--add-suffixADD_SUFFIX在所有输出文件名后附加此字符串。如果非空需要 -n。 例如--add-suffix3 将生成参数解释 -h, --help 作用显示帮助信息列出2to3工具的选项和用法说明。示例2to3 --help -d, --doctests_only 作用仅修复文档测试。这个选项用于只对文档中的测试代码进行转换。示例2to3 -d your_code.py -f FIX, --fixFIX 作用指定转换规则。可以通过这个选项来选择要应用的特定转换规则。默认情况下是应用所有的规则。示例2to3 -f all your_code.py -j PROCESSES, --processesPROCESSES 作用并行运行2to3。可以指定要同时运行的进程数量以加快转换的速度。示例2to3 -j 4 your_code.py -x NOFIX, --nofixNOFIX 作用阻止运行某个转换。可以使用这个选项来阻止特定的转换规则被应用。示例2to3 -x range your_code.py -l, --list-fixes 作用列出可用的转换规则。这个选项会显示出所有可用的转换规则的列表。示例2to3 -l -p, --print-function 作用修改语法以使 print() 成为一个函数。在Python 3中print 语句被替换为了 print() 函数。示例2to3 -p your_code.py -e, --exec-function 作用修改语法以使 exec() 成为一个函数。在Python 3中exec 语句被替换为了 exec() 函数。示例2to3 -e your_code.py -v, --verbose 作用产生更详细的日志记录。会输出更多关于转换过程的详细信息。示例2to3 -v your_code.py --no-diffs 作用不显示重构的差异。在转换过程中不会显示每个文件的改动差异。示例2to3 --no-diffs your_code.py -w, --write 作用写回修改后的文件。会直接在原文件上进行修改覆盖原来的Python 2代码。示例2to3 -w your_code.py -n, --nobackups 作用不为修改后的文件写备份。在进行转换时不会为原文件创建备份。示例2to3 -n your_code.py -o OUTPUT_DIR, --output-dirOUTPUT_DIR 作用将输出文件放在指定目录中而不是覆盖输入文件。需要搭配 -n 选项一起使用。示例2to3 -o converted_code -n your_code.py -W, --write-unchanged-files 作用即使没有必要进行更改也写入文件。这在使用 --output-dir 选项时非常有用会确保所有文件都被写入。示例2to3 -W -o converted_code -n your_code.py --add-suffixADD_SUFFIX 作用在所有输出文件名后附加指定字符串。如果指定了非空的后缀需要搭配 -n 选项一起使用。示例2to3 --add-suffix.bak -n your_code.py
基本使用 只提示不修改原脚本 $ 2to3.exe -j 4 .
RefactoringTool: Skipping optional fixer: buffer
RefactoringTool: Skipping optional fixer: idioms
RefactoringTool: Skipping optional fixer: set_literal
RefactoringTool: Skipping optional fixer: ws_comma
--- .\main.py (original).\main.py (refactored)-1 1
-print This is ingress of the project
print(This is ingress of the project)
--- .\apps\urls.py (original).\apps\urls.py (refactored)-1 1
-print this is the url file
print(this is the url file)
RefactoringTool: No files need to be modified.直接修改原脚本同时会对原脚本做备份 -w $ 2to3.exe -w .
RefactoringTool: Skipping optional fixer: buffer
RefactoringTool: Skipping optional fixer: idioms
RefactoringTool: Skipping optional fixer: set_literal
RefactoringTool: Skipping optional fixer: ws_comma
RefactoringTool: Refactored .\main.py
RefactoringTool: Refactored .\apps\urls.py
RefactoringTool: Files that were modified:
RefactoringTool: .\main.py
RefactoringTool: .\apps\urls.py
--- .\main.py (original).\main.py (refactored)-1 1
-print This is ingress of the project
print(This is ingress of the project)
--- .\apps\urls.py (original).\apps\urls.py (refactored)-1 1
-print this is the url file
print(this is the url file)一般情况下对于大项目应该并发的去转换并且应用所有过滤规则然后将原文件备份以供参考
2to3.exe -j 4 -f all -w .工具缺陷
2to3 工具是一个非常有用的工具但也有一些缺陷和注意事项 不能处理所有情况 2to3 虽然可以处理许多常见的转换但它并不能解决所有的情况。特别是对于一些复杂的代码结构或者使用了一些特殊库的情况可能需要手动进行调整。 可能会引入错误 由于自动转换过程可能涉及到复杂的代码结构和逻辑有时候可能会出现转换后引入的错误或者逻辑不符合预期。 需要人工审查 无论何时使用自动转换工具都建议在转换后对代码进行人工审查以确保其正确性。 不一定能保留所有的原始注释和格式 在转换过程中原始的注释和代码格式可能会发生变化特别是对于一些复杂的代码结构。需要在转换后进行检查和调整。 对第三方库的支持有限 2to3 主要针对标准库进行转换对于一些第三方库可能支持不完善或者需要额外的配置。 可能会产生大量的转换结果 在对大型代码库进行转换时可能会产生大量的转换结果需要耗费一定的时间和精力进行检查和调整。 可能会导致性能下降 一些复杂的转换可能会导致转换后的代码性能下降需要进行优化。 不适用于所有项目 对于一些旧的、特殊的项目可能并不适合直接使用2to3工具进行转换可能需要考虑其他迁移策略。
总的来说2to3是一个很有用的工具可以帮助自动化大部分的Python 2到Python 3的迁移工作但需要谨慎使用同时在转换后进行仔细的代码审查以确保正确性。在处理复杂或特殊情况时可能需要结合手动调整和其他工具来完成迁移工作。
future
工具安装
future 是一个用于帮助在 Python 2 代码中使用 Python 3 的特性的库。它提供了一组可以让 Python 2 代码更容易向 Python 3 迁移的工具。
可以使用pip命令安装该工具
pip install future以下是 future 库的一些主要特点和功能 兼容性 future 库可以让你在 Python 2 中使用一些 Python 3 的特性从而逐步实现向 Python 3 的平滑过渡。 提供兼容模块 future 提供了一系列的模块例如 __future__、builtins 等可以让你在 Python 2 中使用 Python 3 的一些内置函数、语法等。 简化代码 通过使用 future 提供的模块你可以更容易地编写符合 Python 3 标准的代码而不必担心在 Python 2 中的兼容性问题。 提供一些辅助函数和工具 future 还提供了一些辅助函数用于处理一些常见的迁移问题例如处理文本编码等。 支持通过命令行工具进行代码转换 futurize 是 future 库提供的一个命令行工具可以帮助你批量地将 Python 2 代码转换为兼容 Python 3 的代码。 例如可以通过以下命令将一个目录下的 Python 2 代码转换为 Python 3 futurize -f all your_code.py提供配置选项 你可以通过配置文件或命令行选项来定制转换过程例如选择要应用的 fixers 或指定转换后的输出目录。
总的来说future 是一个非常实用的库可以帮助你在 Python 2 中逐步采用 Python 3 的特性从而为将来迁移到 Python 3 打下基础。但需要注意虽然它可以简化许多工作但并不是所有的代码都可以通过 future 完全自动转换可能还需要手动进行一些调整。
参数解释
$ futurize --help
Usage: futurize [options] file|dir ...Options:-h, --help show this help message and exit-V, --version Report the version number of futurize-a, --all-imports Add all __future__ and future imports to each module-1, --stage1 Modernize Python 2 code only; no compatibility withPython 3 (or dependency on future)-2, --stage2 Take modernized (stage1) code and add a dependency onfuture to provide Py3 compatibility.-0, --both-stages Apply both stages 1 and 2-u, --unicode-literalsAdd from __future__ import unicode_literals toimplicitly convert all unadorned string literals into unicode strings-f FIX, --fixFIX Each FIX specifies a transformation; default: all.Either use -f division -f metaclass etc. or use thefully-qualified module name: -flib2to3.fixes.fix_types -flibfuturize.fixes.fix_unicode_keep_u-j PROCESSES, --processesPROCESSESRun 2to3 concurrently-x NOFIX, --nofixNOFIXPrevent a fixer from being run.-l, --list-fixes List available transformations-p, --print-function Modify the grammar so that print() is a function-v, --verbose More verbose logging--no-diffs Dont show diffs of the refactoring-w, --write Write back modified files-n, --nobackups Dont write backups for modified files.-o OUTPUT_DIR, --output-dirOUTPUT_DIRPut output files in this directory instead ofoverwriting the input files. Requires -n. For Python 2.7 only.-W, --write-unchanged-filesAlso write files even if no changes were required(useful with --output-dir); implies -w.--add-suffixADD_SUFFIXAppend this string to all output filenames. Requires-n if non-empty. For Python 2.7 only.ex: --add-suffix3 will generate .py3 files.汉化
$ futurize --help
用法: futurize [选项] 文件|目录 ...选项:-h, --help 显示此帮助信息并退出-V, --version 报告 futurize 的版本号-a, --all-imports 向每个模块添加所有的 __future__ 和 future 导入-1, --stage1 仅现代化 Python 2 代码不与 Python 3 兼容或依赖于“future”-2, --stage2 获取现代化stage1代码并添加对“future”的依赖以提供 Py3 兼容性。-0, --both-stages 应用阶段1和阶段2-u, --unicode-literals添加“from __future__ import unicode_literals”以隐式将所有未装饰的字符串文字 转换为 Unicode 字符串-f FIX, --fixFIX 每个 FIX 指定一个转换默认全部。要么使用 -f division -f metaclass 等或者使用完全限定的模块名-flib2to3.fixes.fix_types -flibfuturize.fixes.fix_unicode_keep_u-j PROCESSES, --processesPROCESSES并行运行 2to3-x NOFIX, --nofixNOFIX阻止运行某个转换。-l, --list-fixes 列出可用的转换-p, --print-function 修改语法以使 print() 成为一个函数-v, --verbose 更详细的日志记录--no-diffs 不显示重构的差异-w, --write 写回修改后的文件-n, --nobackups 不为修改后的文件写备份。-o OUTPUT_DIR, --output-dirOUTPUT_DIR将输出文件放在此目录中而不是覆盖输入文件。需要 -n。仅适用于 Python 2.7。-W, --write-unchanged-files即使没有必要进行更改也写入文件与 --output-dir 一起使用很有用隐含 -w。--add-suffixADD_SUFFIX在所有输出文件名后附加此字符串。如果非空需要 -n。仅适用于 Python 2.7。例如--add-suffix3 将生成 .py3 文件。
基本使用
futurize的代码转换方法有第1阶段和第2阶段。
stage1 在不影响Python2系统环境的范围内执行代码转换。因此stage1中转换后的代码可能无法在Python3环境中工作。 stage1的目的是在与Python2兼容的范围内执行代码转换这是完全更改Python3系列代码的第一步。通过将stage1夹在中间可以降低一次转换代码的风险。 在stage1中使用__future__模块以便甚至可以在2系列环境中实现Python 3系列中与2系列不兼容的功能。不要添加将来的模块。
stage2
在stage2中为Python3系列完全重写了代码。
基本使用 预览stage1中更改的部分不写入。 $ futurize.exe --stage1 .
RefactoringTool: Skipping optional fixer: idioms
RefactoringTool: Skipping optional fixer: ws_comma
RefactoringTool: Refactored .\main.py
RefactoringTool: Refactored .\apps\urls.py
RefactoringTool: Files that need to be modified:
RefactoringTool: .\main.py
RefactoringTool: .\apps\urls.py
--- .\main.py (original).\main.py (refactored)-1 1,2
-print This is ingress of the project
from __future__ import print_function
print(This is ingress of the project)
--- .\apps\urls.py (original).\apps\urls.py (refactored)-1 1,2
-print this is the url file
from __future__ import print_function
print(this is the url file)重写代码并生成备份文件 futurize.exe -0 -w -f all .工具缺陷
提供了兼容python2和python3的中间文件但似乎无法直接转换到python3.主要提供了对标准库的支持。
python-modernize
工具安装
python-modernize 是一个用于将 Python 2 代码现代化以兼容 Python 3 的工具。它提供了一组自动化工具可以帮助将 Python 2 代码转换成符合 Python 3 标准的形式。
可以使用pip命令安装
pip install modernize以下是 python-modernize 的一些主要特点和功能 自动转换 python-modernize 提供了一系列的 fixers转换器可以自动将 Python 2 代码转换为兼容 Python 3 的形式。 向后兼容 转换后的代码可以在 Python 2 和 Python 3 上运行从而保持向后兼容性。 提供多个 fixers python-modernize 包含许多 fixers可以用于解决各种不同的转换问题例如将 print 语句转换为 print() 函数、将除法行为从整数转换为浮点数等。 支持多个转换阶段 你可以选择性地运行不同阶段的转换从而灵活地控制代码转换的深度。 提供详细的帮助文档 python-modernize 提供了丰富的文档可以帮助你了解如何正确地使用工具。 支持通过命令行工具进行代码转换 你可以使用命令行工具来批量转换 Python 2 代码为兼容 Python 3 的形式。 例如可以通过以下命令将一个目录下的 Python 2 代码转换为 Python 3 modernize -f future your_code.py可定制性 你可以根据自己的需求选择性地应用 fixers也可以配置工具的行为。 提供备份功能 python-modernize 可以为转换后的代码创建备份以便在需要时进行恢复。
参数解释
$ modernize.exe --help
Python _ __ __ ___ __| |___ _ _ _ _ (_)______| \/ _ \/ _ / -_) _| \| |_ / -_)|_|_|_\___/\__,_\___|_| |_||_|_/__\___| 0.8.0Usage: modernize [options] file|dir ...Options:--version show programs version number and exit-h, --help show this help message and exit-v, --verbose Show more verbose logging.--no-diffs Dont show diffs of the refactoring.-l, --list-fixes List standard transformations.-d, --doctests_only Fix up doctests only.-f FIX, --fixFIX Each FIX specifies a transformation; -f defaultincludes default fixers.--fixers-here Add current working directory to python path (sofixers can be found)-j PROCESSES, --processesPROCESSESRun fissix concurrently.-x NOFIX, --nofixNOFIXPrevent a fixer from being run.-p, --print-function Modify the grammar so that print() is a function.-w, --write Write back modified files.-n, --nobackups Dont write backups for modified files.--six-unicode Wrap unicode literals in six.u().--future-unicode Use from __future__ import unicode_literals(onlyuseful for Python 2.6).--no-six Exclude fixes that depend on the six package.--enforce Returns non-zero exit code if any fixers had to beapplied. Useful for enforcing Python 3 compatibility.汉化
$ modernize.exe --help
Python _ __ __ ___ __| |___ _ _ _ _ (_)______| \/ _ \/ _ / -_) _| \| |_ / -_)|_|_|_\___/\__,_\___|_| |_||_|_/__\___| 0.8.0用法: modernize [选项] 文件|目录 ...选项:--version 显示程序版本号并退出-h, --help 显示此帮助信息并退出-v, --verbose 显示更详细的日志记录。--no-diffs 不显示重构的差异。-l, --list-fixes 列出标准的转换。-d, --doctests_only 仅修复文档测试。-f FIX, --fixFIX 每个 FIX 指定一个转换-f default 包括默认的转换器。--fixers-here 将当前工作目录添加到 Python 路径中以便找到转换器。-j PROCESSES, --processesPROCESSES并行运行 fissix。-x NOFIX, --nofixNOFIX阻止运行某个转换。-p, --print-function 修改语法以使 print() 成为一个函数。-w, --write 写回修改后的文件。-n, --nobackups 不为修改后的文件写备份。--six-unicode 将 Unicode 文字字面值包装在 six.u() 中。--future-unicode 使用 from __future__ import unicode_literals仅适用于 Python 2.6。--no-six 排除依赖于 six 包的转换。--enforce 如果需要应用任何转换则返回非零退出代码。用于强制执行 Python 3 兼容性。基本使用
当你使用 modernize.exe 工具时你可以按照以下示例来执行相应的转换操作。
显示版本号
modernize.exe --version显示帮助信息
modernize.exe --help列出可用的转换规则
modernize.exe -l仅修复文档测试
modernize.exe -d your_code.py应用所有默认的转换规则
modernize.exe -f default your_code.py并行运行转换例如使用4个进程同时转换
modernize.exe -j 4 your_code.py阻止某个转换规则的运行例如阻止运行 division 转换
modernize.exe -x division your_code.py修改语法以使 print() 成为一个函数
modernize.exe -p your_code.py写回修改后的文件
modernize.exe -w your_code.py不为修改后的文件写备份
modernize.exe -n your_code.py将Unicode文字字面值包装在 six.u() 中
modernize.exe --six-unicode your_code.py使用 from __future__ import unicode_literals仅适用于 Python 2.6
modernize.exe --future-unicode your_code.py排除依赖于 six 包的转换
modernize.exe --no-six your_code.py如果需要应用任何转换则返回非零退出代码
modernize.exe --enforce your_code.py工具缺陷
略
pyupgrade
A tool (and pre-commit hook) to automatically upgrade syntax for newer versions of the language.
工具安装
pip install pyupgrade参数解释
$ pyupgrade.exe --help
usage: pyupgrade [-h] [--exit-zero-even-if-changed] [--keep-percent-format][--keep-mock] [--keep-runtime-typing] [--py3-plus][--py36-plus] [--py37-plus] [--py38-plus] [--py39-plus][--py310-plus] [--py311-plus][filenames ...]positional arguments:filenamesoptions:-h, --help show this help message and exit--exit-zero-even-if-changed--keep-percent-format--keep-mock--keep-runtime-typing--py3-plus, --py3-only--py36-plus--py37-plus--py38-plus--py39-plus--py310-plus--py311-plus汉…化
$ pyupgrade.exe --help
用法: pyupgrade [-h] [--exit-zero-even-if-changed] [--keep-percent-format][--keep-mock] [--keep-runtime-typing] [--py3-plus][--py36-plus] [--py37-plus] [--py38-plus] [--py39-plus][--py310-plus] [--py311-plus][文件名 ...]位置参数文件名选项-h, --help 显示此帮助信息并退出--exit-zero-even-if-changed--keep-percent-format--keep-mock--keep-runtime-typing--py3-plus, --py3-only--py36-plus--py37-plus--py38-plus--py39-plus--py310-plus--py311-plus基本使用 转换单个文件 使用以下命令可以将单个 Python 文件转换为 Python 3 兼容形式 pyupgrade your_code.py这会将 your_code.py 中的 Python 2 代码转换为 Python 3 兼容的形式。 转换整个目录 如果你想批量转换一个目录下的所有 Python 文件可以使用类似以下的命令 pyupgrade your_directory/这将会逐个转换目录中的所有 Python 文件。 保留百分号格式化字符串 如果你想保留百分号格式化字符串如 %s而不转换为 f-strings可以使用 --keep-percent-format 选项 pyupgrade --keep-percent-format your_code.py保留 mock 模块 如果你使用了 mock 模块可以使用 --keep-mock 选项来保留该模块 pyupgrade --keep-mock your_code.py保留运行时类型提示 如果你想保留运行时类型提示如 # type: ignore可以使用 --keep-runtime-typing 选项 pyupgrade --keep-runtime-typing your_code.py仅转换到 Python 3 默认情况下pyupgrade 将代码转换为适用于所有 Python 3 版本的形式。如果你想只将代码转换为 Python 3可以使用 --py3-only 选项 pyupgrade --py3-only your_code.py只转换到特定 Python 3 版本 你可以使用相应的选项如 --py36-plus、--py37-plus 等来将代码转换为特定版本的 Python 3 兼容形式。 例如要将代码转换为 Python 3.6 兼容形式可以使用 pyupgrade --py36-plus your_code.py同样的方式适用于其他版本如 Python 3.7、Python 3.8 等。 设置退出代码 默认情况下如果发生了转换pyupgrade 将返回非零退出代码。你可以使用 --exit-zero-even-if-changed 选项来始终返回零退出代码。 pyupgrade --exit-zero-even-if-changed your_code.py将python2转为python3.11:
print This is ingress of the projectclass C(Base):def f(self):super(C, self).f()import functoolsfunctools.lru_cache()
def expensive():pass执行pyupgrade --py3-plus .\main.py
令我疑惑的是并没有任何事情发生
工具缺陷
文档稀缺似乎不会执行
对比
选择哪个工具来进行从 Python 2 到 Python 3 的迁移取决于你的项目特定需求以及你个人的偏好。以下是一些常用的迁移工具的特点和适用场景 2to3 官方工具2to3 是 Python 官方提供的迁移工具专门设计用于将 Python 2 代码转换为 Python 3 兼容的形式。自动化程度高2to3 可以自动识别和转换许多常见的 Python 2 到 Python 3 的语法和库的使用差异。广泛使用由于是官方工具2to3 在许多项目中得到了广泛的应用。 futurize 向前兼容性futurize 旨在提供向后兼容性使得代码可以同时在 Python 2 和 Python 3 中运行。两阶段转换可以选择将代码先转换成 Python 2/3 兼容形式阶段 1然后再添加 future 依赖以实现完全的 Python 3 兼容阶段 2。灵活性可以根据需要选择不同的转换规则。 modernize 专注于 Python 2 到 Python 3modernize 专注于将 Python 2 代码转换为 Python 3 兼容形式。通过 2to3 进行转换实际上modernize 是基于 2to3 构建的但提供了一些额外的功能和选项。 pyupgrade 简单易用pyupgrade 是一个简单、快速的工具用于将 Python 2 代码转换为 Python 3 兼容的形式。自动化程度较高pyupgrade 试图通过自动化转换来尽可能减少需要手动检查的代码。
