Pylinter Sublime Text 2/3 插件

简介

这是一个为 Sublime Text 2 和 3 开发的小插件，它允许通过 Pylint自动检查 Python 代码。

由于 Pylint 在完成任务之前可能需要一些时间（几秒钟），因此它在单独的线程中运行，这样插件就不会锁定 Sublime Text。

插件可以在保存时自动调用或通过快捷键调用。

包含对 Pylint 配置文件的支持。

注意:

** Pylint needs to be installed separately!!! **

If you have installed Pylint into a Virtualenv, you need to launch Sublime
Text from that Virtualenv for everything to work correctly. This might be
resolved in the future.

最近更改

2014-03-03

添加了对 Pylint 插件的支持。您可以使用“plugins”设置将插件模块名称的列表添加到您的配置中。

2013-11-15

对代码进行了重构以确保 Pylinter 在 ST3 中工作得更好。同时，针对在找不到 Pylint 的情况下进行错误处理的改进。

2013-09-06

改进了 Pylint 检测并修复了一个关于 Pylint 版本检查的错误。

2013-09-01

这是 Pylinter 的第一个版本，它既与 Sublime Text 2兼容也与其兼容。请随意报告任何问题。并对报告问题并供给应对 Python 3 兼容性解决方案的每个人都表示感谢。

2013-08-24

感谢 dbader 为 Pylint 1.0 支持

• Pylinter 会自动检测所使用的 Pylint 版本并兼容新的 1.0.0 版本及更旧版本。

2013-01-20

感谢 KristoforMaynard 的以下添加

• 当 message_stay 设置设置为 true 时，错误消息将在光标停留在有问题的一行上时显示。
• 可以将 disable_outline 设置为 true 以隐藏错误轮廓。
• 可以将 disable 设置分配给要忽略的错误列表。例如：["C0301", "E1011"]

2012-09-12

• Pylinter 将尝试自动找到 Pylint 的路径。

2012-09-06

• Pylinter 现在允许将特定于平台和/或主机的配置存储在单个配置文件中。这在 pylint_path 设置中特别有用。

  只需更改设置如下

  "pylint_path": "<your pylint path>"

  变为以下

  "pylint_path": {
      "#multiconf#": [
          {"os:windows": "<your windows pylint path>"},
          {"os:linux;host:<host name": "<your linux pylint path>"},
          {"os:linux;host:<other host name": "<your other linux pylint path>"}
      ]
    }
  

  更多信息，您可以查看以下代码片段。

2012-08-31

• 为不同消息类型添加了图标。通过将选项use_icons设置为true，您可以使用这些图标（图标由Yusuke Kamiyamane提供）。

2012-08-29

• 添加了一个'忽略'功能，允许轻松插入#pylint: disable=语句/注释。
• 包含了wuub的错误着色。您可以使用包含的MonokaiPylinter.tmTheme文件，或者查看它以了解如何着色不同的错误和警告。

配置

Pylinter将尝试确定Pylint的路径。如果失败，您必须提供Pylint安装中lint.py模块的完整路径！

• python_bin：要使用Pylint运行的Python可执行文件的完整路径

  （例如，当您使用virtualenv时）或如果您想使用默认的python安装，则简单使用python。

• python_path：要添加到Pylint Python路径的路径列表（可选）。

• working_dir：要从中运行Pylint的工作目录的路径（可选）。

• pylint_path：lint.py模块的完整路径。

• pylint_rc：您想要使用的Pylint配置文件的完整路径（如有）。

• run_on_save：如果此设置设置为true，每次您保存Python源代码文件时，都将调用Pylint。

• 忽略：您希望忽略的Pylint错误类型的列表。

  可能的值

  • "R"：重构，因"良好实践"度量标准违规而引发
  • "C"：编码标准违规的常规
  • "W"：提示风格问题或较小的编程问题
  • "E"：重要编程问题的错误（即最可能是bug）
  • "F"：致命错误，阻止进一步处理

• use_icons：如果您想在不显示边距点的情况下显示图标，请将其设置为true。

多配置

任何设置都可以用Multiconf结构替换。

"pylint_path": {
    "#multiconf#": [
        {"os:windows": "<your windows pylint path>"},
        {"os:linux;host:<host name": "<your linux pylint path>"},
        {"os:linux;host:<other host name": "<your other linux pylint path>"}
    ]
  }

更多信息，您可以查看以下代码片段。

项目设置

您也可以在*.sublime-project文件中存储设置。创建一个如下所示的"pylinter"部分，并覆盖任何或所有描述的设置。

{
    "folders":
    [
        {
            "path": "/N/development/fabrix"
        }
    ],
    "settings":
    {
        "pylinter":
        {
        }
    }
}

命令 & 快捷键

运行

可以按快捷键调用此插件。

• OS X：Command+Alt+z
• Linux, Windows：Control+Alt+z

添加 Config：忽略注释/语句

在包含错误代码的行的末尾添加一个'Pylint disable'注释，以便在下一次检查时被忽略。

• OS X：Command+Alt+i
• Linux, Windows：Control+Alt+i

切换标记

可以在文件中关闭和打开错误标记。

• OS X：Command+Alt+x
• Linux, Windows：Control+Alt+x

快速列表

要查看所有Pylint错误的快速列表，请使用

• OS X：Command+Alt+c
• Linux, Windows：Control+Alt+c