ctrl+shift+p filters: :st2 :st3 :win :osx :linux
浏览

Python PEP8 自动格式化

作者 StephaneBunel ALL

Python PEP8 自动格式化是一个 Sublime Text (2|3) 插件，可以交互式地按照 PEP8 （Python 代码样式指南）重新格式化 Python 源代码。

详细信息

安装

  • 总计数 154K
  • Win 74K
  • Mac 41K
  • Linux 39K
8月6日 8月5日 8月4日 8月3日 8月2日 8月1日 7月31日 7月30日 7月29日 7月28日 7月27日 7月26日 7月25日 7月24日 7月23日 7月22日 7月21日 7月20日 7月19日 7月18日 7月17日 7月16日 7月15日 7月14日 7月13日 7月12日 7月11日 7月10日 7月9日 7月8日 7月7日 7月6日 7月5日 7月4日 7月3日 7月2日 7月1日 6月30日 6月29日 6月28日 6月27日 6月26日 6月25日 6月24日 6月23日
Windows 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
Mac 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
Linux 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0

说明

源代码
bitbucket.org

Python PEP8 自动格式化

Python PEP8 自动格式化是一个 Sublime Text 插件，可以交互式地按照 PEP-8（Python 代码样式指南）重新格式化 Python 源代码。支持 Sublime Text 的 2 和 3 版本。

历史记录

之前，我在寻找一个可能的 Eclipse 替代品时，试了试 Sublime Text 2。我使用 PyDev（适用于 Python 开发者的很好的 Eclipse 插件）的主要用途之一是代码格式化功能。

在 Sublime Text 2 中，我安装了 PythonTidy，但不幸的是它对我不起作用。所以为了好玩和学会，我决定创建 Python PEP8 自动格式化，基于 autopep8 作为代码格式化工具，以及 pep8 作为代码检查器。

安装

为了避免依赖，所有必要的模块都包含在包中。

  1. 使用 Sublime Package Control

    • 使用快捷键 cmd+shift+P，然后选择 Package Control: Install Package
    • 搜索 Python PEP8 Autoformat 并安装它。

  2. 在 bitbucket 的 mercurial (hg) 仓库上

    • 打开终端，移动到 Packages 目录（使用“首选项 > 浏览包…”菜单打开的文件夹）。然后在终端中输入
    • hg clone https://bitbucket.org/StephaneBunel/pythonpep8autoformat 'Python PEP8 Autoformat'

  3. 手动

    • 下载 Python PEP8 自动格式化的 存档
    • 打开终端，移动到 Packages 目录（使用“首选项 > 浏览包…”菜单打开的文件夹）并创建一个新的名为 'Python PEP8 Autoformat' 的目录
    • 将存档内容提取到新的 'Python PEP8 Autoformat' 目录中。

设置

您可以在首选项菜单中找到设置（首选项 -> 包设置 -> Python PEP8 自动格式化 -> …）。

{
    // autoformat code on save ?
    "autoformat_on_save": false,

    // enable possibly unsafe changes (E226, E24, W6)
    // aggressive level, 0 to disable:
    "aggressive": 0,

    // list codes for fixes; used by --ignore and --select
    "list-fixes": false,

    // do not fix these errors / warnings (e.g. ["E501", E4", "W"])
    "ignore": [],

    // select errors / warnings (e.g. ["E4", "W"])
    "select": [],

    // Maximum line length
    "max-line-length": 79
}

通过编辑用户设置，您的个人喜好将确保在插件升级过程中安全保留。

缩进大小

PEP8建议使用4个空格进行缩进，但有时由于项目差异，autopep8提供了–indent-size参数。

如果您想更改缩进大小，您可以在您的包设置中添加键。默认值为4。

{
    ...

    "indent-size": 2,

    ...
}

用法

格式化应用于整个文档。

使用键盘

  • GNU/Linux: ctrl+shift+r
  • OSX: ctrl+shift+r
  • Windows: ctrl+shift+r

使用命令面板

如《Default.sublime-commands》文件中定义的

[
    { "caption": "User: Python PEP8 Autoformat", "command": "pep8_autoformat" }
]

您可以通过打开命令面板（ctrl+shift+P）并输入“auto”来格式化Python代码，直到高亮整个标题。

伴侣

Python PEP8 Autoformat的有用伴侣

许可证

版权所有 2012-2014 Stéphane Bunel

根据Apache许可证2.0版（“许可证”）；除非遵守许可证或书面同意，否则不得使用此文件。您可以在以下地址获得许可证副本：

http://www.apache.org/licenses/LICENSE-2.0

除非适用法律要求或书面同意，否则在许可证下分配的软件按“原样”基础分配，不提供任何形式的明示或暗示保证。有关许可证中规定的权限和限制的具体语言，请参阅许可证。