pip
From Gentoo Wiki
Pip is Python's package management system. It references packages available in the official Python Package Index (PyPI).
Install
Emerge
root #
emerge --ask dev-python/pip
Usage
In order for pip to operate correctly when installing new packages an active internet connection is a requirement.
Invocation
user $
pip --help
Usage: pip <command> [options] Commands: install Install packages. download Download packages. uninstall Uninstall packages. freeze Output installed packages in requirements format. list List installed packages. show Show information about installed packages. check Verify installed packages have compatible dependencies. config Manage local and global configuration. search Search PyPI for packages. cache Inspect and manage pip's wheel cache. wheel Build wheels from your requirements. hash Compute hashes of package archives. completion A helper command used for command completion. debug Show information useful for debugging. help Show help for commands. General Options: -h, --help Show help. --isolated Run pip in an isolated mode, ignoring environment variables and user configuration. -v, --verbose Give more output. Option is additive, and can be used up to 3 times. -V, --version Show version and exit. -q, --quiet Give less output. Option is additive, and can be used up to 3 times (corresponding to WARNING, ERROR, and CRITICAL logging levels). --log <path> Path to a verbose appending log. --proxy <proxy> Specify a proxy in the form [user:passwd@]proxy.server:port. --retries <retries> Maximum number of retries each connection should attempt (default 5 times). --timeout <sec> Set the socket timeout (default 15 seconds). --exists-action <action> Default action when a path already exists: (s)witch, (i)gnore, (w)ipe, (b)ackup, (a)bort. --trusted-host <hostname> Mark this host or host:port pair as trusted, even though it does not have valid or any HTTPS. --cert <path> Path to alternate CA bundle. --client-cert <path> Path to SSL client certificate, a single file containing the private key and the certificate in PEM format. --cache-dir <dir> Store the cache data in <dir>. --no-cache-dir Disable the cache. --disable-pip-version-check Don't periodically check PyPI to determine whether a new version of pip is available for download. Implied with --no-index. --no-color Suppress colored output --no-python-version-warning Silence deprecation warnings for upcoming unsupported Pythons.
Package installation
Warning
Running pip as root is not advised. It can render important system tools like emerge useless.[1]
Running pip as root is not advised. It can render important system tools like emerge useless.[1]
Important
It is important to understand that packages installed using pip will not be tracked by Portage. This is the case for installing any package through means other than the emerge command. Possible conflicts can be created when installing a Python package that is available in the Portage tree, then installing the same package using pip.
It is important to understand that packages installed using pip will not be tracked by Portage. This is the case for installing any package through means other than the emerge command. Possible conflicts can be created when installing a Python package that is available in the Portage tree, then installing the same package using pip.
--user
option to install Python packages in a user's home directory. This will avoid conflicts with Portage. Be wise and make good choices!To install a package using the pip command, where package
is the desired package:
user $
pip install <package>
To install the package in a user's home directory, be signed-in as the desired user, then issue:
user $
pip install --user <package>
This will install the package in the user's ~/.local/ directory.
Removal
To remove a package using pip:
user $
pip uninstall <package>
See also
- Application level package management — provides best practice recommendations on managing the coexistence of operating system and application level package managers on Gentoo.
- Gem — programs and libraries for the Ruby programming language.
- Portage — the official package manager and distribution system for Gentoo.
- Project:Python/Dependencies - How to turn PyPI dependencies to those of ebuild.
External resources
- Python/Virtual environment (ArchWiki article) - Isolated Python's environment, enabling sandboxed installation of packages.