怎么在isort Python 代码中的导入语句进行排序和格式化

本文涉及的产品
云数据库 Tair(兼容Redis),内存型 2GB
RDS MySQL Serverless 基础系列,0.5-2RCU 50GB
Redis 开源版,标准版 2GB
推荐场景:
搭建游戏排行榜
简介: `isort` 是一个Python工具,用于自动排序和格式化代码中的导入语句,提高代码整洁度和可读性。它支持自动排序、保留空白和注释、自定义排序规则、与多种编辑器集成以及命令行使用。安装`isort`可通过`pip install isort`,使用时可直接在Python代码中导入或通过命令行处理文件。示例展示了如何在代码中使用`isort`进行导入排序,包括基本排序、自定义设置和处理多个文件。`isort`适用于标准库、第三方库和自定义模块的导入排序,还可忽略特定导入,并能与IDE和编辑器插件集成,提升开发效率。

isort 是什么

isort,全称是 "Import Sorting",是一个 Python 工具,用来对 Python 代码中的导入语句进行排序和格式化。它可以帮助我们按照一定的规则对导入的模块进行排序,使得代码更加整洁,易于阅读和维护。

isort 的主要特点包括:

  1. 自动排序isort 可以根据配置的规则自动对导入语句进行排序。
  2. 保持空白isort 能够保持代码中的空白行和注释,不会将其误认为是导入语句。
  3. 自定义排序规则:用户可以根据自己的需求自定义排序规则。
  4. 集成支持isort 可以与多种编辑器和 IDE 集成,如 VSCode、PyCharm 等。
  5. 快捷命令isort 提供了命令行工具,可以快速地对代码进行排序。

使用 isort 可以大大提高代码的可读性和维护性,尤其是在多人协作的大型项目中,能够帮助团队保持统一的编码风格。

如何安装或者引入 isort

在Python中,为了保持代码的整洁和有序,我们通常需要对导入的模块进行排序。isort是一个非常有用的工具,它可以帮助我们自动地完成这个任务。

首先,确保你已经安装了Python环境。然后,可以通过pip命令来安装isort库。打开命令行工具,输入以下命令:

复制代码

pip install isort

安装完成后,你可以在Python代码中通过导入isort模块来使用它。导入的方法如下:

arduino

复制代码

import isort

现在,你已经成功安装并引入了isort,

isort 使用示例

Python 代码的排序是保持代码质量的一个重要方面。isort 是一个强大的Python包,它可以帮助你自动将代码中的导入语句排序并格式化,以保持一致性和可读性。

下面通过一些示例来展示 isort 的使用。

示例 1:基本使用

安装 isort 后,你可以在 Python 文件中导入它并直接使用。下面是一个简单的示例:

ini

复制代码

from isort import sort_imports

# 原始的未排序代码
code_before = """
import os
import sys
from my_module import MyClass

def my_function():
    pass
"""

# 使用 isort 排序后的代码
code_after = sort_imports(code=code_before, library_order=['my_module'])

在这个例子中,code_after 将包含排序并格式化后的导入语句。

示例 2:自定义排序

isort 允许你通过 settings 参数来自定义排序规则。例如,你可以设置特定的排序顺序或者忽略某些模块。

python

复制代码

from isort import sort_imports

# 设置自定义排序规则
settings = {
    "order": ["built_in", "stdlib", " third_party", "my_module"],
    "case_sensitive": False,
    "include_trailing_comma": True,
}

# 原始的未排序代码
code_before = """
import os
import sys
from my_module import MyClass
import another_module

def my_function():
    pass
"""

# 使用 isort 排序后的代码
code_after = sort_imports(code=code_before, settings=settings)

在这个例子中,我们设置了自定义的排序顺序,并且启用了包含尾随逗号的功能。

示例 3:对多个文件进行排序

isort 也可以对多个文件进行排序。你可以使用 --files 参数传递文件列表。

css

复制代码

isort --files my_file.py another_file.py

这将会对 my_file.pyanother_file.py 中的导入语句进行排序。

通过这些示例,你可以看到 isort 如何帮助你保持代码中导入语句的整洁和有序。这对于代码的维护和团队协作是非常有帮助的。

isort的应用场景

isort 是一个强大的 Python 代码排序和格式化工具,能够帮助开发者自动化地按照一定规则对代码中的导入语句进行排序和格式化。这有助于提高代码的可读性和一致性,也是遵循 PEP 8 风格指南的重要一步。

1. 标准库导入排序

在日常开发中,我们经常需要从 Python 的标准库中导入多个模块。使用 isort,可以确保所有的标准库导入语句都按照字母顺序排列,从而使代码更加整洁。

python

复制代码

# 示例:使用 isort 排序标准库导入
import os
import sys
import json
from datetime import datetime

# 运行 isort 后的结果
import json
import os
import sys
from datetime import datetime

2. 第三方库导入排序

对于第三方库的导入,isort 同样适用。它可以自动检测并按照字母顺序排列第三方库的导入语句,这在多人合作的项目中尤其有用,因为它有助于减少因个人编码习惯差异而产生的混乱。

python

复制代码

# 示例:使用 isort 排序第三方库导入
import requests
import numpy as np
import pandas as pd
from flask import Flask

# 运行 isort 后的结果
import numpy as np
import pandas as pd
import requests
from flask import Flask

3. 自定义模块导入排序

在大型项目中,通常会有多个自定义模块。isort 可以确保你的代码中自定义模块的导入顺序是一致的,这对于维护大型项目来说非常有帮助。

python

复制代码

# 示例:使用 isort 排序自定义模块导入
from my_project.module_a import FunctionA
from my_project.module_b import FunctionB
from my_project.module_c import FunctionC

# 运行 isort 后的结果
from my_project.module_a import FunctionA
from my_project.module_b import FunctionB
from my_project.module_c import FunctionC

4. 忽略特定导入

有时候,某些导入语句可能因为特殊的业务逻辑或测试需要而不想被排序。isort 允许你通过配置文件或命令行参数来忽略特定的模块或文件。

python

复制代码

# 示例:使用 isort 忽略特定导入
import ignored_module  # noqa
import unittest

# 运行 isort 时的配置
# --skip-gitignore 忽略 .gitignore 中的模块
# --skip-file-ignore 忽略 .isort.cfg 中的忽略规则

5. 集成到 IDE 和编辑器

许多流行的 IDE 和代码编辑器(如 PyCharm, VSCode 等)都支持 isort 插件,这使得开发者在编写代码的过程中就可以实时地对导入语句进行排序和格式化,极大地提高了开发效率。

bash

复制代码

# 示例:在 IDE 中使用 isort 插件进行排序
# 选中导入语句,使用 IDE 提供的格式化功能

通过这些应用场景的展示,我们可以看到 isort 是一个非常有用的工具,它可以帮助开发者提升代码质量,节省整理代码的时间,并提高团队协作效率。


转载来源:https://juejin.cn/post/7381455296658538559

相关文章
|
2天前
|
JavaScript 前端开发 Python
用python执行js代码:PyExecJS库
文章讲述了如何使用PyExecJS库在Python环境中执行JavaScript代码,并提供了安装指南和示例代码。
22 1
用python执行js代码:PyExecJS库
|
2天前
|
Python
turtle库的几个案例进阶,代码可直接运行(python经典编程案例)
该文章展示了使用Python的turtle库进行绘图的进阶案例,包括绘制彩色圆形和复杂图案的代码示例。
26 6
turtle库的几个案例进阶,代码可直接运行(python经典编程案例)
|
2天前
|
Python
turtle库的几个简单案例,代码可直接运行(python经典编程案例)
该文章提供了多个使用Python的turtle库绘制不同图形的简单示例代码,如画三角形、正方形、多边形等,展示了如何通过turtle进行基本的绘图操作。
12 5
|
3天前
|
NoSQL MongoDB 数据库
python3操作MongoDB的crud以及聚合案例,代码可直接运行(python经典编程案例)
这篇文章提供了使用Python操作MongoDB数据库进行CRUD(创建、读取、更新、删除)操作的详细代码示例,以及如何执行聚合查询的案例。
18 6
|
1天前
|
存储 Python
深度剖析:Python里字典树Trie的构建与查询,让你的代码更优雅!
在编程的世界里,数据结构的选择往往直接决定了程序的效率和可读性。今天,我们将深入探索一种高效处理字符串搜索与匹配的数据结构——字典树(Trie),也称作前缀树或单词查找树。通过Python实现Trie树,我们将看到它如何优雅地解决一系列字符串相关的问题,并提升代码的整体质量。
8 2
|
3天前
|
数据处理 开发者 Python
代码之美:探索简洁而强大的Python编程
【8月更文挑战第56天】在编程的世界里,简洁不仅仅是一种风格,它是高效和可维护性的代名词。本文将通过Python编程语言的视角,带领读者领略代码的优雅与力量。我们将从基础语法出发,逐步深入到函数式编程、面向对象设计,以及实用的第三方库使用,揭示如何通过简洁的代码解决复杂问题。准备好让你的思维得到启发,让我们一起走进Python的世界,体验代码之美。
|
2天前
|
IDE 开发工具 Python
python3代码编程规范(命名、空格、注释、代码布局、编程建议等)
该文章详细介绍了Python3的编程规范,包括命名、空格使用、注释、代码布局等方面的最佳实践,帮助提升代码的可读性和一致性。
11 0
|
机器学习/深度学习 算法 搜索推荐
详解排序算法(Python实现)
详解排序算法(Python实现)
142 0
|
1天前
|
数据采集 人工智能 数据挖掘
Python编程入门:从基础到实战的快速指南
【9月更文挑战第25天】本文旨在为初学者提供一个简明扼要的Python编程入门指南。通过介绍Python的基本概念、语法规则以及实际案例分析,帮助读者迅速掌握Python编程的核心技能。文章将避免使用复杂的专业术语,而是采用通俗易懂的语言和直观的例子来阐述概念,确保内容的可读性和实用性。
|
1天前
|
机器学习/深度学习 人工智能 数据挖掘
探索Python编程之美:从基础到进阶
【9月更文挑战第25天】在数字时代的浪潮中,编程已成为一项宝贵的技能。本篇文章将引导你步入Python的奇妙世界,一个既适合初学者又深受资深开发者喜爱的编程语言。我们将一起揭开Python语言的基础面纱,探索它的核心概念,并通过实际示例深入理解其强大功能。无论你是编程新手还是希望提升自己的老手,这篇文章都将为你提供一条清晰的学习路径,助你在编程之旅上更进一步。