TL;DR
- The ‘ideal’ solution (Ubuntu/Debian way):
$ python -m pip uninstall pip
to uninstall the new pip 10 and retain your Ubuntu/Debian-provided patched pip 8. For a system-wide installation of modules useapt
wherever possible (unless you are in a virtualenv), more on it below. In older Ubuntu/Debian versions, always add--user
flag when using pip outside of virtualenvs (installs into~/.local/
, default in python-pip and python3-pip since 2016). - If you still want to use the new pip 10 exclusively, there are 3 quick workarounds:
- simply re-open a new bash session (a new terminal tab, or type
bash
) – and pip 10 becomes available (seepip -V
). debian’s pip 8 remains installed but is broken; or $ hash -d pip && pip -V
to refresh pip pathname in the $PATH. debian’s pip 8 remains installed but is broken; or$ sudo apt remove python-pip && hash -d pip
(for Python 3 it’s python3-pip) — to uninstall debian’s pip 8 completely, in favor of your new pip 10.
- simply re-open a new bash session (a new terminal tab, or type
Note: You will always need to add --user
flag to non-debian-provided pip 10, unless you are in a virtualenv! Your use of pip 10 system-wide, outside of virtualenv, is not really supported by Ubuntu/Debian. Never sudo pip
!
Details:
https://github.com/pypa/pip/issues/5221#issuecomment-382069604
https://github.com/pypa/pip/issues/5240#issuecomment-381673100
So, here we have Python 2.7.12 in Ubuntu 16.04 ec2 machine, and get ImportError: cannot import name main when trying to use pip. It’s caused by the pip install --upgrade pip
command: that installs the latest pip version 10 alongside Ubuntu’s default pip version from python-pip debian package from OS distribution (the system Python installation), completely bypassing Ubuntu apt
subsystem. It breaks the Ubuntu’s default pip: the debian-patched launcher script from python-pip (system-installed to /usr/bin/pip*) tries to do import main() from your newly installed pip 10 library, but with a different import path, so it fails.
This error is discussed in more detail in a developer thread of the pip issue tracker, including a few proposed solutions, such as:
- The
$ hash -d pip
command: whenhash
is invoked, the full pathname of pip is determined by searching the directories in $PATH and remembered. Any previously-remembered pathname is discarded. The-d
option causes the shell to “forget” the remembered location of the given package name; or - Similarly, you can simply re-open a new bash session (a new terminal tab) to refresh pip pathname in $PATH; or
- You could just use a versioned
pip2
command (orpip3
for Python 3) instead ofpip
to invoke the older system-installed launcher/usr/bin/pip2
, whereas any pip script located in$HOME/.local/bin
dir (pip, pip2, pip2.7) will invoke your new user-installed pip 10 version; - You can also use the versioned Python commands in combination with the
-m
switch to run the appropriate copy of pip, for example:$ python2 -m pip install --user SomePackage
# default Python 2$ python2.7 -m pip install --user SomePackage
# specifically Python 2.7
That is handy if you have several versions of Python and need an extension from PyPI, such as your MySQL-python module (MySQLdb) or a Flask-MySQL, for a specific Python version. The--user
switch is only required outside of virtualenv. - Or, uninstall one of the two pips – either user-installed or system-installed – to resolve the conflict:
$ python -m pip uninstall pip
– to remove your manually-installed pip in favour of the previously installed Ubuntu-shipped version from python-pip debian package (python3-pip for Python 3); it is slightly older, but it finds and installs latest modules from PyPI just fine, and has a working pip command in the $PATH by default; or$ sudo apt-get remove python-pip
– to uninstall Ubuntu-provided pip in favour of your latest pip 10; if it is not accessible via the shortpip
command, just add your$HOME/.local/bin
directory to your $PATH environment variable to usepip
command (see above).
Note: Ubuntu 16.04 pip v8.1.1 and the latest pip v10.0.1 produce exactly the same PyPI index search results and can pull the same module versions; - Finally, you could ignore both pips altogether in favor of APT, and install Python packages system-wide from Ubuntu repo with:
$ apt search <python-package>
# orapt-cache search
in older Ubuntu$ apt show <python-package>
# e.g. python-flask$ sudo apt install <python-package>
# orsudo apt-get install
Packages prefixed withpython-
are for Python 2; withpython3-
are for Python 3.
Standard apt-get installation method may be what you need. For example, in your case:python-mysqldb
– Python interface to MySQL <- a fork of MySQLdb == MySQL-pythonpython-flask-sqlalchemy
– SQL Alchemy supportpython-pymysql
– pure Python MySQL driver
In fact, python-packages from Ubuntu repository are preferred whenever possible, particularly in case of heavy system dependencies or when used system-wide. Of course, the amount of Python packages in Ubuntu repository (few thousand!) is relatively smaller compared to PyPI (and have only one version of them), because any OS repository is lagging slightly behind PyPI versions. But the upside of APT is that all the Ubuntu-provided packages underwent integration testing within Ubuntu, plus apt-get quickly resolves heavy dependencies like C extensions automatically. You will always get the system libraries you need as part of the apt install, but with pip you have no such guarantees.
APT may not be an option, however, if you really need only the latest (or certain older) package version, or when it can only be found at PyPI, or when modules need to be isolated; then pip is indeed more appropriate tool. If you have to usepip install
command on Ubuntu instead ofapt-get install
, please ensure it runs in an isolated virtual development environment, such as with virtualenv (sudo apt-get install python-virtualenv
), or using a built-invenv
module (available in python3 only), or at a per-user level (pip install --user
command option), but not system-wide (neversudo pip
!).
Note: Using sudo pip
command (with root access) on Ubuntu/Debian should be avoided, because it interferes with the operation of the system package manager (apt) and may affect Ubuntu OS components when a system-used python module is unexpectedly upgraded, particularly by dependencies on another pip package. It is advised to never use Pip to change system-wide Python packages, as these are managed by apt-get on Ubuntu.