How to collect packages were installed with pip?

Reading time ~3 minutes

Once I start a Python’s project, I’m starting to add interesting packages with pip install .... And, usually, it’s enough until I decided to share the project with someone. And there is a question: How can I collect packages were installed and share them?

Usually, this task is solved using file called requirements.txt. The file contains a list of required Python’s packages. All the packages can be easily installed:

pip install -r requirements.txt

How to create requirements.txt?


Just run:

pip freeze > requirements.txt

The solution will generate a requirements.txt file which contains all packages installed with the pip.

$ cat requirements.txt

It works!

But… transitive dependencies of the libraries! For instance, let’s install Appium client:

$ pip install Appium-Python-Client==0.24
Collecting Appium-Python-Client==0.24
  Using cached Appium-Python-Client-0.24.tar.gz
Collecting selenium>=2.47.0 (from Appium-Python-Client==0.24)
  Using cached selenium-3.5.0-py2.py3-none-any.whl
Installing collected packages: selenium, Appium-Python-Client
  Running install for Appium-Python-Client
Successfully installed Appium-Python-Client-0.24 selenium-3.5.0

As you can see, Appium-Python-Client depends on selenium which is the transitive dependency for the Appium-Python-Client. And pip freeze will display both of them:

$ pip freeze

I don’t want to manage transitive dependencies, I would delegate it to the pip. So, how to skip them?


The pipdeptree allows to build a packages tree and identify transitive dependencies.

First of all, install:

pip install pipdeptre

Next, display your dependency tree:

$ pipdeptree --freeze

As you can see, there are two top level dependencies: Appium-Python-Client and pipdeptree. So, you can choose only required top level dependencies (I would use only Appium-Python-Client==0.24 for the project’s requirements).

But what if there are dozens of the packages and some of them are redundant dependencies (for instance, were used for investigation and aren’t required anymore)?


The pipreqs allows to generate pip requirements based on project’s imports.

First of all, install:

pip install pipreqs

Next, display the packages were used in the import statements:

$ pipreqs --print .

Great! I use just 2 two dependencies. Stop! But one of them is a transitive


As you may see, it is a small probability to generate the clean requirements.txt file using only one approach. But a combination of the pip and pipdeptree and pipreqs can do that.

Test design techniques

The list of approaches for designing a great system tests coverage.
Continue reading

A message of the commit

Published on January 23, 2018

Establishing lazy connections in Python

Published on January 09, 2018