isort 是一个Python的实用程序/库,它会按字母顺序对导入(import)的库进行排序,并自动分组。它提供多种使用方式,包括命令行、Python调用等。
它基于Python 3.6+实现,但也支持格式化Python 2代码。
在使用 isort 格式化你的 import 之前,你的代码可能是长这样的:
from my_lib import Object import os from my_lib import Object3 from my_lib import Object2 import sys from third_party import lib15, lib1, lib2, lib3, lib4, lib5, lib6, lib7, lib8, lib9, lib10, lib11, lib12, lib13, lib14 import sys from __future__ import absolute_import from third_party import lib3 print("Hey") print("yo")
使用 isort 格式化后的代码是这样的:
from __future__ import absolute_import import os import sys from third_party import (lib1, lib2, lib3, lib4, lib5, lib6, lib7, lib8, lib9, lib10, lib11, lib12, lib13, lib14, lib15) from my_lib import Object, Object2, Object3 print("Hey") print("yo")
杂乱无章的格式瞬间变得井然有序,可见这是一款多么优秀的整理工具,下面就来介绍这个工具的安装及使用过程,及进阶用法。
1.准备
开始之前,你要确保Python和pip已经成功安装在电脑上,如果没有,请访问这篇文章:超详细Python安装指南 进行安装。
(可选1) 如果你用Python的目的是数据分析,可以直接安装Anaconda:Python数据分析与挖掘好帮手—Anaconda,它内置了Python和pip.
(可选2) 此外,推荐大家用VSCode编辑器来编写小型Python项目:Python 编程的最好搭档—VSCode 详细指南
Windows环境下打开Cmd(开始—运行—CMD),苹果系统环境下请打开Terminal(command+空格输入Terminal),输入命令安装依赖:
pip install isort
如果你需要让他支持对 requirements.txt 的整理,请这样安装:
pip install isort[requirements_deprecated_finder]
2.使用 isort 整理你的python引用
isort 有2种使用方法,一种是从命令行直接针对py文件进行整理、另一种是在Python内导入 isort 进行整理。
命令行整理
要在特定文件上运行 isort,请在命令行执行以下操作:
isort mypythonfile.py mypythonfile2.py # 或 python -m isort mypythonfile.py mypythonfile2.py
要对本文件夹递归进行isort整理,请执行以下操作:
isort . # 或 python -m isort .
要查看更改建议的而不直接应用它们,请执行以下操作:
isort mypythonfile.py --diff
如果你要对项目自动运行isort,但是希望仅在未引入语法错误的情况下应用更改:
isort --atomic .
(注意:这在默认情况下是禁用的,因为它阻止了 isort 去整理不同版本的Python代码。)
从Python内部:
import isort isort.file("pythonfile.py")
或者:
import isort sorted_code = isort.code("import b\nimport a\n")
3. 智能平衡格式化
从 isort 3.1.0 开始,添加了对平衡多行导入的支持。启用此选项后,isort 将动态地将导入长度更改为生成最平衡网格的长度,同时保持低于定义的最大导入长度。
开启了平衡导入的格式化:
from __future__ import (absolute_import, division, print_function, unicode_literals)
未开启平衡的格式化:
from __future__ import (absolute_import, division, print_function, unicode_literals)
要启用此设置, 在你的配置设置 balanced_wrapping
=True
或 通过命令行添加 -e
参数执行整理。
4.跳过某个import
要使 isort 忽略单个 import,只需在包含文本的导入行的末尾添加注释 isort:skip
,如下:
import module # isort:skip
或者:
from xyz import (abc, # isort:skip yo, hey)
要使 isort 跳过整个文件,只需添加 isort:skip_file
到文件的开头注释中:
""" my_module.py Best module ever isort:skip_file """ import b import a
这个工具还是相当方便的,尤其是针对一些杂乱无章、多年沉淀下来的项目代码的 import 进行整理的时候,它会变得非常香。有需要的小伙伴可以赶快试一下。
我们的文章到此就结束啦,如果你喜欢今天的 Python 教程,请持续关注Python实用宝典。
有任何问题,可以在公众号后台回复:加群,回答相应验证信息,进入互助群询问。
原创不易,希望你能在下面点个赞和在看支持我继续创作,谢谢!
Python实用宝典 ( pythondict.com )
不只是一个宝典
欢迎关注公众号:Python实用宝典