Fix Python – What is the use case for `pip install -e`?

Question

Asked By – jpmelos

When I need to work on one of my pet projects, I simply clone the repository as usual (git clone <url>), edit what I need, run the tests, update the setup.py version, commit, push, build the packages and upload them to PyPI.

What is the advantage of using pip install -e? Should I be using it? How would it improve my workflow?

Now we will see solution for issue: What is the use case for `pip install -e`?


Answer

I find pip install -e extremely useful when simultaneously developing a product and a dependency, which I do a lot.

Example:

You build websites using Django for numerous clients, and have also developed an in-house Django app called locations which you reuse across many projects, so you make it available on pip and version it.

When you work on a project, you install the requirements as usual, which installs locations into site packages.

But you soon discover that locations could do with some improvements.

So you grab a copy of the locations repository and start making changes. Of course, you need to test these changes in the context of a Django project.

Simply go into your project and type:

pip install -e /path/to/locations/repo

This will overwrite the directory in site-packages with a symbolic link to the locations repository, meaning any changes to code in there will automatically be reflected – just reload the page (so long as you’re using the development server).

The symbolic link looks at the current files in the directory, meaning you can switch branches to see changes or try different things etc…

The alternative would be to create a new version, push it to pip, and hope you’ve not forgotten anything. If you have many such in-house apps, this quickly becomes untenable.

This question is answered By – andyhasit

This answer is collected from stackoverflow and reviewed by FixPython community admins, is licensed under cc by-sa 2.5 , cc by-sa 3.0 and cc by-sa 4.0