101

I'm developing/testing a package in my local directory. I want to import it in the interpreter (v2.5), but sys.path does not include the current directory. Right now I type in sys.path.insert(0,'.'). Is there a better way?

Also, 

from . import mypackage

fails with this error:

ValueError: Attempted relative import in non-package
cweiske
  • 28,704
  • 13
  • 124
  • 186
projectshave
  • 3,432
  • 5
  • 21
  • 24

11 Answers11

51

You can use relative imports only from in a module that was in turn imported as part of a package -- your script or interactive interpreter wasn't, so of course from . import (which means "import from the same package I got imported from") doesn't work. import mypackage will be fine once you ensure the parent directory of mypackage is in sys.path (how you managed to get your current directory away from sys.path I don't know -- do you have something strange in site.py, or...?)

To get your current directory back into sys.path there is in fact no better way than putting it there.

Neuron - Freedom for Ukraine
  • 4,303
  • 4
  • 29
  • 51
Alex Martelli
  • 811,175
  • 162
  • 1,198
  • 1,373
  • Python 2.5 for Ubuntu 8.10 does not have the current directory (empty string) in sys.path for the interpreter. I didn't change anything, so it somehow got shipped that way. I just installed 3.0 and sys.path DOES have '' in sys.path. – projectshave Jul 11 '09 at 03:01
  • @projectshave, OK, Ubuntu's no doubt got their reasons! I haven't noticed that in 8.04 (what we currently use at work) but maybe I just wasn't paying enough attention. – Alex Martelli Jul 11 '09 at 03:31
  • 1
    I am partially wrong. Python invoked from a shell has the current directory in sys.path. Python invoked from Emacs does not have the current directory. Strange. – projectshave Jul 21 '09 at 16:10
  • 1
    Ah well, then it's Emacs who's got their reasons as opposed to Ubuntu's (as a vim user I don't really know;-). You can conditionally insert '.' in your sys.path iff not there of course. – Alex Martelli Jul 21 '09 at 18:25
  • @Alex Martelli: Thank you so much! I've been searching and searching for the solution to why my add-on (for Anki) needed a different import statement when being run 'locally' as a script. When I instead added a local_launch() method and imported/launched the whole thing from a script *outside* the package folder, it worked like a charm! – Jon Coombs Jan 30 '14 at 18:33
19

Keep it simple:

 try:
     from . import mymodule     # "myapp" case
 except:
     import mymodule            # "__main__" case
Community
  • 1
  • 1
Guido U. Draheim
  • 2,688
  • 1
  • 17
  • 16
  • 11
    I like this solution, it is the most simple. The only remaining question is why did the "only one way to do it" rule has been deemed optional when implementing imports ... Seriously there is about 15 ways to declare and organize the packages, all of which have drawbacks – Léo Germond May 25 '16 at 08:35
18

See the documentation for sys.path:

http://docs.python.org/library/sys.html#sys.path

To quote:

If the script directory is not available (e.g. if the interpreter is invoked interactively or if the script is read from standard input), path[0] is the empty string, which directs Python to search modules in the current directory first.

So, there's no need to monkey with sys.path if you're starting the python interpreter from the directory containing your module.

Also, to import your package, just do:

import mypackage

Since the directory containing the package is already in sys.path, it should work fine.

SpoonMeiser
  • 19,261
  • 8
  • 48
  • 65
  • 1
    It will fail if a similar file name exists somewhere else in the working env. – JAR.JAR.beans Jun 07 '16 at 12:45
  • @JAR.JAR.beans the current working directory should be the first thing in `sys.path` so files there should be found before files anywhere else in the working environment. – SpoonMeiser Jun 07 '16 at 12:59
  • 3
    Good point. That is, if we run the file from the local directory. In the case it's some other folder, and in the case a change to sys.path is needed - it means `sys.path.insert(0, new_path)` rather than `sys.path.append(new_path)`. – JAR.JAR.beans Jun 07 '16 at 13:35
16

If you want to run an unmodified python script so it imports libraries from a specific local directory you can set the PYTHONPATH environment variable - e.g. in bash:

export PYTHONPATH=/home/user/my_libs
python myscript.py

If you just want it to import from the current working directory use the . notation:

export PYTHONPATH=.
python myscript.py
Pierz
  • 5,588
  • 37
  • 55
  • Exporting PYTHONPATH includes programming outside python (e.g. in bash). Additionally, in https://docs.python.org/3/using/cmdline.html is clearly stated that "_default search path is installation dependent_". – ilias iliadis Mar 23 '18 at 07:54
12

Inside a package if there is setup.py, then better to install it

pip install -e .
Nagashayan
  • 2,119
  • 2
  • 16
  • 21
5

A simple way to make it work is to run your script from the parent directory using python's -m flag, e.g. python -m packagename.scriptname. Obviously in this situation you need an __init__.py file to turn your directory into a package.

bradley.ayers
  • 35,361
  • 14
  • 88
  • 97
4

A bit late to the party, but this is what worked for me:

>>> import sys
>>> sys.path.insert(0, '')

Apparently, if there is an empty string, Python knows that it should look in the current directory. I did not have the empty string in sys.path, which caused this error.

maninthecomputer
  • 424
  • 4
  • 8
3

Using sys.path should include current directory already.

Try:

import .

or:

from . import sth

however it may be not a good practice, so why not just use:

import mypackage
kenorb
  • 137,499
  • 74
  • 643
  • 694
sunqiang
  • 6,304
  • 1
  • 30
  • 32
  • 5
    Problem with is that it will load the package from the global python env, it might load the package/file from the local folder, but it could just as well load some other random mypackge that is in the working env. – JAR.JAR.beans Jun 07 '16 at 12:44
3

I used pathlib to add my module directory to my system path as I wanted to avoid installing the module as a package and @maninthecomputer response didn't work for me

import sys
from pathlib import Path

cwd = str(Path(__file__).parent)
sys.path.insert(0, cwd)
from my_module import my_function
rdmolony
  • 397
  • 1
  • 5
  • 14
0

Speaking for python3.. I wanted to use an improved version of a library that's installed in my environment. There are some extra print statements it makes to show that it and not the original lib is being used.

I placed the lib's folder next to the python script. Ran the script.. it ran with the local lib with the modifications.

Removed the folder and ran it again - this time it ran with the installed lib.

So, solution was simple : place the lib's folder (with same name as in your import statement) in your project folder. That does the job, at least at my end.

This is on a standard Linux Mint 20.04 system, with a python 3.8 virutal environment activated (so "(py3.8)" appears in my terminal when I'm in the virtual env)

Nikhil VJ
  • 4,205
  • 4
  • 32
  • 50
0

You can import package_name if the package is a module: this needs you have init.py under the package and things that you want to use are needed to import in the init.py

Or if you want to import class under the package, you can use from package_name import class_name

htlbydgod
  • 163
  • 1
  • 5