ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

Python Import Magic

by alecthomas ST2

This Sublime Text 2 plugin attempts to automatically manage Python imports.

Details

  • 2016.03.16.23.30.19
  • github.​com
  • github.​com
  • 3 years ago
  • 16 minutes ago
  • 5 years ago

Installs

  • Total 2K
  • Win 738
  • OS X 555
  • Linux 453
Oct 16 Oct 15 Oct 14 Oct 13 Oct 12 Oct 11 Oct 10 Oct 9 Oct 8 Oct 7 Oct 6 Oct 5 Oct 4 Oct 3 Oct 2 Oct 1 Sep 30 Sep 29 Sep 28 Sep 27 Sep 26 Sep 25 Sep 24 Sep 23 Sep 22 Sep 21 Sep 20 Sep 19 Sep 18 Sep 17 Sep 16 Sep 15 Sep 14 Sep 13 Sep 12 Sep 11 Sep 10 Sep 9 Sep 8 Sep 7 Sep 6 Sep 5 Sep 4 Sep 3 Sep 2 Sep 1
Windows 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 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
OS X 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 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 1

Readme

Source
raw.​githubusercontent.​com

Sublime Text 3 - Python Import Magic image

This plugin attempts to automatically manage Python imports.

WARNING: This is a relatively complex plugin and thus may contain bugs. It may remove imports that you need. It may add imports that you don't. Use at your own risk.

It can:

  • Detect and add imports for unknown symbols.
  • Remove unused imports.
  • Order imports according to PEP8.

It currently does NOT (but support is planned):

  • Detect changes to files and update its index automatically. The current workaround is to use the command palette Python Import Magic: Reset Index.

Example

Example of Import Magic at work

Usage

There are three ways of invoking the auto-importer:

  • The hotkey: ⌘⇧I on OSX and ^⇧I on Windows and Linux.
  • Via the command palette: Python Import Magic: Update Imports.
  • Setting update_imports_on_save to true in the user settings for the package. I would not encourage use of this setting at this stage, but if you're feeling particularly brave…

Configuration

eg.

{
    "update_imports_on_save": true,
    "python_path": {
        "/Library/Python/2.7/site-packages": "S",
        "/Users/alec/Projects/SublimePythonImportMagic/.venv/lib/python2.7/site-packages": "L"
    }
}

update_imports_on_save = false

If true, update imports on each save. WARNING: This might not be a good idea.

index_filename = ".importmagic.idx"

Name of file to store index in.

python_path = {<path>: <classification>}

NOTE: Not implemented yet

Keys are the paths to search for Python modules. Values are how the path should be classified.

Paths will also be looked up in the default Sublime configuration under the key python_import_magic_python_path.

<classification> is from the following table:

Key Classification
3 Third party
S System
L Local