pip-manager 1.0.4

pip-manager is a command line tool to make Python packages management easy.

pip-manager is a command line tool to make Python packages management easy.

Table of Contents

1. Requirements

2. Installation

3. Usage

4. Contributing

5. Support

6. License

7. Acknowledgements

1. Requirements

pip-manager works on both Python 2 and Python 3 (tested on python2.7 and python3.5+) and is Linux and Windows compatible (tested on Linux Mint 18.2 and Windows 7).

Dependencies:

pip-manager is written purely in Python and has pip as an only dependency.

IMPORTANT note for Windows users:

On Windows you have to install ported curses library (link) as native Python curses does not work there.

2. Installation

pip-manager can be easily installed using pip:

pip install -U pip-manager

or pipenv:

pipenv install pip-manager

If you want to install pip-manager system-wide just use sudo:

sudo pip install -U pip-manager

3. Usage

To run pip-manager just type pip-manager in your terminal window and hit Enter.

If you made system-wide installation, run pip-manager with:

sudo -H pip-manager

You will see something very similar to this:

pip-manager v1.0.0 (python 2.7.12)
┌─────────────────────────────────────────────────────────────────────────────┐
│Checking the newest version for cssselect                                    │
└─────────────────────────────────────────────────────────────────────────────┘

After a (hopefully) short while pip-manager will be ready to use:

pip-manager v1.0.0 (python 2.7.12)
[ ] cssselect                          1.0.1        1.0.1
[ ] cycler                             0.10.0       0.10.0
[ ] decorator                          4.0.11       4.0.11
[ ] django                             1.11.3       1.11.3
[ ] docutils                           0.13.1       0.13.1
[ ] entrypoints                        0.2.3        0.2.3
[ ] enum34                             1.1.6        1.1.6
[ ] fancycompleter                     0.7          0.7
[ ] flask                              0.10         0.12.2
[ ] functools32                        3.2.3.post2  3.2.3.post2
[ ] futures                            3.1.1        3.1.1
[ ] html5lib                           0.999999999  0.999999999
[ ] hupper                             1.0          1.0
[ ] hyperlink                          17.2.1       17.2.1
Page: 1/5
Options:
Up/Down - prev/next package
Left/Right - prev/next page
PgUp/PgDn - jump up/down by 5
Home/End - jump to top/bottom
Space - (un)select package
A - toggle all
Enter - upgrade selected
Delete - uninstall selected
Q - exit

As you can see options are displayed all the time and are pretty self-explanatory, so using pip-manager should be really simple and straightforward.

Second column shows current version installed and third column shows the newest stable version available.

It is not visible here, but if there is newer version available, it will be printed with bold font.

If newest version is already installed it will be printed greyed out.

IMPORTANT: Protected distributions

To protect yourself from accidentally removing needed distributions, you can add them to [protected] section in config.ini file (located in pip-manager installation directory).

This way you can select all packages by pressing A, uninstall them with Delete and everything except protected packages will be uninstalled.

By default pip, setuptools, wheel and pip-manager are listed in the aforementioned file. To uninstall protected distributions you have to either uninstall them manually (pip uninstall some_dist) or remove them from config.ini file.

4. Contributing

Contributions are always welcome - just:

1. Fork the project.

2. Commit your changes on a feature/fix branch.

3. Push.

4. Submit a pull request.

5. Have your changes merged :)

5. Support

If you need assistance, want to report a bug or request a feature, please raise an issue here.

6. License

pip-manager is released under the terms of the MIT License. Please refer to the LICENSE.txt file for more details.

7. Acknowledgements

Great thanks to pip creators and contributors for making life easier for the rest of us.