/SublimeAutoPEP8

Automatically formats Python code to conform to the PEP 8 style guide using autopep8 and pep8 modules

Primary LanguagePython

Bitdeli Badge

Sublime Auto PEP8 Formatting

About

Automatically formats Python code to conform to the PEP 8 style guide using autopep8 module
Supported ST2 and ST3

Features

  • format / preview code according PEP8
  • format / preview multi-selected text
  • format / preview all python modules in folder
  • side bar menu
  • formated code while saving

Installing

With the Package Control plugin: The easiest way to install AutoPEP8 in through Package Control, which can be found at this site: http://wbond.net/sublime_packages/package_control

Once you install Package Control, restart ST2 and bring up the Command Palette (Command+Shift+P on OS X, Control+Shift+P on Linux/Windows). Select "Package Control: Install Package", wait while Package Control fetches the latest package list, then select AutoPEP8 when the list appears.

With Git: Clone the repository in your Sublime Text "Packages" directory: git clone git@github.com:wistful/SublimeAutoPEP8.git AutoPEP8

Without Git: Download the latest source from GitHub and copy to your Sublime Text "Packages" directory as AutoPEP8.

Per-project settings

{
    "settings": {
        "sublimeautopep8": {
            "max-line-length": 79,
            "format_on_save": false,
            "show_output_panel": true,
            // show panel with message: no issues to fixed
            "show_empty_panel": false,
            "max-threads": 5,
            // show Format/Preview menu items only for views
            // with syntax from `syntax_list`
            // value is base filename of the .tmLanguage syntax files
            "syntax_list": ["Python"],

            // Behaviour for right click context menu (Format/Preview PEP8)
            // "always": menu appears always, even folder doesn't contain *.py files
            // "never":  menu never appears
            // "ifneed": menu appears only if path or childs contain *.py file
            "file_menu_behaviour": "ifneed",
            "file_menu_search_depth": 3  // max search depth, uses for 'ifneed' mode
        }
    }
}

Using

  • SideBar - right click on the file(s) or folder(s)
  • Active view - right click on the view
  • Selected text - right click on the selected text
  • On Save - provide by settings: option format_on_save
  • Command Palette - bring up the Command Palette and select PEP8: Format Code or PEP8: Preview Changes
  • Hotkeys - Command/Control + Shift + 8 to format code, Command/Control + 8 to preview changes