Python relative imports using setuptools with scripts

Question

I am transitioning to a package-based workflow for a project I've been working on. I want to be able to separate development and production environments and I think setuptools offers this possibility with some degree of ease.

I have a project structured as follows:

modulename/
    setup.py
    modulename/
         file_a.py
         script.py

In script.py, I want to import file_a.py. Currently I do this by doing import file_a.

My setup.py looks like:

from setuptools import setup, find_packages

setup(name='modulename',
  packages = find_packages(),
  package_dir = {'': '../modulename'},
  scripts = ['modulename/script.py'])

Currently, when I run script.py after doing python setup.py install, I get an error message:

SystemError: Parent module '' not loaded, cannot perform relative import

I have tried a variety of permutations of package_dir = ..., most notably package_dir = {'': 'modulename'}, but this throws another error on install, error: package directory 'modulename/modulename' does not exist

I am not sure what I am doing wrong. The documentation online for setuptools is relatively poor in dealing with situations involving relative imports. Can someone point me in the right direction?

I guess the problem is not the `setup.py`, but `script.py` running as the `__main__` module and using relative import at the same time. Take a look [here](http://stackoverflow.com/questions/16981921/relative-imports-in-python-3) — code_onkel, Sep 12 '16 at 19:57
Okay, so is the move here to keep the script outside of the package and then just use normal imports? — Alex Alifimoff, Sep 12 '16 at 20:43
Do you want to post an actual answer and I'll accept it, since this functionally solved my problem? — Alex Alifimoff, Sep 13 '16 at 15:37

score 3 · Accepted Answer · edited May 23 '17 at 12:32

3

The problem is not related with setuptools. Using relative imports inside the module being executed as __main__ does not work out of the box. There are workarounds / hacks, but the most common solutions seems to be moving the script out of the package or using absolute imports in the script file.

Take a look at Relative imports in Python 3 for the full story.

edited May 23 '17 at 12:32

Community

1
1

answered Sep 14 '16 at 06:20

code_onkel

2,759
1
16
31

Python relative imports using setuptools with scripts

1 Answers1