What does "error: option –single-version-externally-managed not recognized" indicate?

Question:

I seem to have suddenly started to encounter the error error: option --single-version-externally-managed not recognized when using pip install with various packages (including PyObjC and astropy).

I’ve never seen this error before, but it’s now also showing up on travis-ci builds for which nothing has changed.

Does this error indicate an out of date distribution?

Some incorrectly specified option in setup.py?

Something else entirely?

Asked By: keflavich

||

Answers:

New Update:

Install the latest version of setuptools. If you still get the error, install wheel as well.

pip install -U setuptools
pip install -U wheel

Original Answer / More Details:

--single-version-externally-managed is an option used for Python packages instructing the setuptools module to create a Python package which can be easily managed by the host’s package manager if needed, like Yum or Apt.

If you’re seeing this message, you may have an old version of setuptools or Python. Try using Distribute, which is a newer version of setuptools and is backwards compatible. These packages may expect that you have it already.

https://pypi.python.org/pypi/distribute

Edit: At this point, distribute has been merged into the main setuptools project. Just install the latest version of setuptools. As @wynemo indicated, you may wish to use the --egg option instead, as it’s more appropriate for those doing manual installations where you’re not intending to create a system package for distribution.

Answered By: Kelketek

Add --egg option

pip install --egg SCons

I use pip version 1.4.1

Answered By: wynemo

I have this problem on my macbook also when I try to upgrade one python package.
I check pip version in OS X, it’s too old: 1.1.
I use follow cmd to upgrade pip to 1.5.6

easy_install -U pip

Then this error is fixed.

Answered By: NewPtone

Try upgrading setuptools like this:

pip install --upgrade setuptools

Answered By: sparrowt

Installing wheel resolved this issue with recent pip (I used 8.1.2):

pip install wheel
Answered By: Seth Difley

I was having this problem. It turned out it was a problem with the file permissions on my pip cache.

If you see a message at the very beginning of your pip output like

The directory '/home/ubuntu/.cache/pip/http' or its parent directory is not owned by the current user and the cache has been disabled. Please check the permissions and owner of that directory. If executing pip with sudo, you may want sudo's -H flag.
The directory '/home/ubuntu/.cache/pip' or its parent directory is not owned by the current user and caching wheels has been disabled. check the permissions and owner of that directory. If executing pip with sudo, you may want sudo's -H flag.

you might have the same problem. You can resolve it by either ensuring that you have proper file permissions on your pip cache (something like chown -R $(whoami) /home/ubuntu/.cache/pip) or, if you’re on a UNIX, you can set the pip cache location with the XDG_CACHE_HOME env var to some folder you do own.

Answered By: sans

I tried the above solutions. However, I only can resolve the problem until I do:

sudo pip3 install -U pip (for python3)

Answered By: Karim
Categories: questions Tags: , ,
Answers are sorted by their score. The answer accepted by the question owner as the best is marked with
at the top-right corner.