A drop-in replacement for pip
Project description
pipim: PIP IMproved
Drop-in replacement for pip with behavior that imitates other popular languages packages managers.
Installing
pip install --user pipim
Then, if you wish for pipim to be invoked when you simply type pip
, you can
use pipim replace-pip
to create a script in ~/.local/bin/pip
that will run
pipim.
Rationale
When you work on Python projects, you often find yourself creating virtual environments, and having to manually activate them or install dependencies in them.
This is not something you typically do with other languages, where the package manager is smart enough to know if you meant to install packages at the user level or at the project level.
This is more or less in line with the Zen of Python: explicit is better than
implicit. However I grew tired of having this behavior available everywhere
except with Python, so I decided to write a simple wrapper around pip that will
use virtual environments by default, unless --user
is passed.
Features
By default, pipim will be installed as pipim
, however, you can use it as a
drop-in replacement of pip
, and the following examples assume you did.
Automatic use of virtual environments
The following commands will automatically create a virtual environment called .venv/
if one does not exist already, and then the actual commands inside of it:
pip install package1 [package2...]
pip uninstall package1 [package2...]
If you wish to work outside of a virtual environment, you can use the --user
flag. This will try to use pipus if it is
found in your PATH, and will resort to regular pip
otherwise.
Install packages from requirements.txt
If you do not specify any package, this will run pip install -r requirements.txt
in the virtual environment. As with other install commands, this will
create the venv first if it does not exist already.
Simply run:
pip
# or
pip install
Easily installs itself as a replacement
You can use pipim replace-pip
once to create a simple script in
~/.local/bin/pip
that will invoke pipim instead of pip. This will allow you to
forget about pipim and just run pip
like you always did before, except that
now it comes with extra perks ✨✨.
Run a command inside the virtual environment
pip run <command> [arguments...]
The first argument will be invoked from .venv/bin/
, everything that follows is
passed to it. For example:
pip run flask --help
Always fallback to regular pip
Every unmatched flags are passed down to pip, any unrecognized command will run pip too.
Contributing
Noticed a bug? Want to request a feature? Simply open a new Issue.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.