diff --git a/docs/index.rst b/docs/index.rst index 329a2a38..41aa712c 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -43,12 +43,18 @@ The problems that Pipenv seeks to solve are multi-faceted: Install Pipenv Today! --------------------- +Pipenv is a python package and so can be installed using ``pip`` as you would expect. :: $ pip install pipenv ✨🍰✨ -If you have excellent taste, there's also a `fancy installation method `_. +If you have excellent taste, there are various other installation methods which +prevent pipenv and its dependencies from interfering with the rest of your +Python installation. These include +`Pipsi `_, +`Nix `_ +and `Homebrew `_. .. toctree:: :maxdepth: 2 diff --git a/docs/install.rst b/docs/install.rst index 4e82c1b6..9ee61b3f 100644 --- a/docs/install.rst +++ b/docs/install.rst @@ -59,6 +59,9 @@ If you installed Python from source, with an installer from `python.org`_, or via `Homebrew`_ you should already have pip. If you're on Linux and installed using your OS package manager, you may have to `install pip `_ separately. +If you plan to install pipenv using Homebrew you can skip this step. The +Homebrew installer takes care of pip for you. + .. _getting started tutorial: https://opentechschool.github.io/python-beginners/en/getting_started.html#what-is-python-exactly .. _python.org: https://python.org .. _Homebrew: https://brew.sh @@ -252,6 +255,23 @@ To upgrade pipenv at any time:: .. _crude_installation: +☤ Homebrew Installation of Pipenv +================================= + +Homebrew is a popular open-source package management system for macOS. + +Installing pipenv via Homebrew will keep pipenv and all of its dependencies in +an isolated virtual environment so it doesn't interfere with the rest of your +Python installation. + +Once you have installed `Homebrew `_ simply run:: + + $ brew install pipenv + +To upgrade pipenv at any time:: + + $ brew upgrade pipenv + ☤ Crude Installation of Pipenv ==============================