38

I'm using Visual Studio Code with the Python plugin and autopep8 with:

"editor.formatOnSave": true

I have local packages I need to import, so I have something like:

import sys
sys.path.insert(0, '/path/to/packages')
import localpackage

but when I save, Visual Studio Code/autopep8 moves all import statements before the code, so Python can't find my local package.

import sys
import localpackage
sys.path.insert(0, '/path/to/packages')

How can I tell Visual Studio Code/autopep8 that it's okay to put a statement before imports, or is there a more correct way of importing local packages?

As a workaround, it looks like it's fine if you import in an if statement:

import sys

sys.path.insert(0, '/path/to/packages')
if 'localpackage' not in sys.modules:
    import localpackage
Peter Mortensen
  • 30,738
  • 21
  • 105
  • 131
waspinator
  • 6,464
  • 11
  • 52
  • 78
  • I don't know what the flag is to autopep8, but once you find it you can specify it with `"python.formatting.autopep8Args"`. – Brett Cannon Jan 03 '19 at 23:03
  • 1
    The entry in settings.json should be `"python.formatting.autopep8Args": ["--ignore", "E402"]` (see complete answer below). – willk Jan 03 '19 at 23:35

2 Answers2

55
  1. Open settings

  2. Search for autopep8. You should see the following results:

    Enter image description here

  3. Click on "Edit in settings.json" under the first option

  4. Add the following argument to the User Settings JSON file:

    "python.formatting.autopep8Args": ["--ignore", "E402"]
    

    Enter image description here

This tells autopep8 to ignore error 402 which is: "module level import not at top of file" (here's the list of errors in pep8)

You can use this same method to change any of the autopep8 settings. For example, if you only wanted to fix indentation, you can use "python.formatting.autopep8Args": ["--select", "E1"]

The autopep8 readme has more information on the available options.

Peter Mortensen
  • 30,738
  • 21
  • 105
  • 131
willk
  • 3,727
  • 2
  • 27
  • 44
  • 1
    As a side note, I've only gotten one argument at a time to work. If I try to do something like: `"python.formatting.autopep8Args": ["--ignore", "E402", "--ignore", "E401"]` only one of the two arguments work (usually the second one). I'm not sure why this is, and if someone has a solution, it would be greatly appreciated! – willk Jan 04 '19 at 14:31
  • 3
    @wilk you need to separate them with commas like `"--ignore", "E401,E701"` – M.M Apr 13 '19 at 16:30
  • Is there something I can put in the setup.cfg? – theX Aug 30 '20 at 22:17
  • 8
    now in vscode, you need to search for autopep8, click "add item", add --ignore=E402 and click "OK". – 黄锐铭 Nov 20 '20 at 10:36
41

If you don't want to generally disable import sorting, but just disable it for specific lines, you can use the following pragmas at the end of each line:

# noqa

or

# nopep8

Like so for your example:

import sys # noqa
sys.path.insert(0, '/path/to/packages') # noqa
import localpackage
jpihl
  • 7,941
  • 3
  • 37
  • 50
leosh
  • 878
  • 9
  • 22