From 15e963cee1577b8c0596a0bf8bf9c3074e68a81c Mon Sep 17 00:00:00 2001 From: Albert De La Fuente Vigliotti Date: Tue, 19 Dec 2017 17:56:59 -0200 Subject: [PATCH 1/3] Initial pipenv instructions --- docs/source/install.rst | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) diff --git a/docs/source/install.rst b/docs/source/install.rst index e95eea65..3e006b60 100644 --- a/docs/source/install.rst +++ b/docs/source/install.rst @@ -15,6 +15,9 @@ as an alternative installation method for MacOS and Linux, you can install Catalyst directly with ``pip`` (we recommend in combination with a virtual environemnt). See :ref:`Installing with pip `. +Alternatively you can install Catalyst using ``pipenv`` which is a mix of pip +and virtualenv. See :ref:`Installing with pipenv `. + Regardless of the method, each operating system (OS), has its own prerequisites, make sure to review the corresponding sections for your system: :ref:`Linux `, :ref:`MacOS ` and :ref:`Windows `. @@ -293,6 +296,38 @@ Troubleshooting ``pip`` Install sudo apt-get install python-dev +.. _pipenv: + +Installing with ``pipenv`` +------------------------- + +Installing Catalyst via ``pipenv`` is perhaps easier that installing it via +``pip`` itself but you need to install ``pipenv`` first via ``pip``. +Python package. + +.. code-block:: bash + + $ pip install pipenv + +Once ``pipenv`` is installed you can proceed + +.. code-block:: bash + + $ mkdir project + $ cd project + $ pipenv install enigma-catalyst matplotlib + +Until now the workflow compared to ``pip`` is almost identical, the difference +is that you don't need to load manually any virtualenv however you need to use +the `pipenv run` prefix to run the `catalyst` command as follows: + +.. code-block:: bash + + $ pipenv run catalyst --version + +If you want to know more about ``pipenv`` go to the `pipenv github repo`_ + +.. _`pipenv github repo`: https://github.com/pypa/pipenv .. _linux: From b1a735d83ffdb1b4ff26dc952072405adcb013f7 Mon Sep 17 00:00:00 2001 From: Albert De La Fuente Vigliotti Date: Tue, 19 Dec 2017 17:56:59 -0200 Subject: [PATCH 2/3] Initial pipenv instructions --- docs/source/install.rst | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) diff --git a/docs/source/install.rst b/docs/source/install.rst index e95eea65..1b07644e 100644 --- a/docs/source/install.rst +++ b/docs/source/install.rst @@ -15,6 +15,9 @@ as an alternative installation method for MacOS and Linux, you can install Catalyst directly with ``pip`` (we recommend in combination with a virtual environemnt). See :ref:`Installing with pip `. +Alternatively you can install Catalyst using ``pipenv`` which is a mix of pip +and virtualenv. See :ref:`Installing with pipenv `. + Regardless of the method, each operating system (OS), has its own prerequisites, make sure to review the corresponding sections for your system: :ref:`Linux `, :ref:`MacOS ` and :ref:`Windows `. @@ -293,6 +296,38 @@ Troubleshooting ``pip`` Install sudo apt-get install python-dev +.. _pipenv: + +Installing with ``pipenv`` +------------------------- + +Installing Catalyst via ``pipenv`` is perhaps easier that installing it via +``pip`` itself but you need to install ``pipenv`` first via ``pip``. + +.. code-block:: bash + + $ pip install pipenv + +Once ``pipenv`` is installed you can proceed by creating a project folder and +installing Catalyst on that project automagically as follows: + +.. code-block:: bash + + $ mkdir project + $ cd project + $ pipenv install enigma-catalyst matplotlib + +Until now the workflow compared to ``pip`` is almost identical, the difference +is that you don't need to load manually any virtualenv however you need to use +the `pipenv run` prefix to run the `catalyst` command as follows: + +.. code-block:: bash + + $ pipenv run catalyst --version + +If you want to know more about ``pipenv`` go to the `pipenv github repo`_ + +.. _`pipenv github repo`: https://github.com/pypa/pipenv .. _linux: From 99db2ca46d2308f90d3aad9b26a7f20fb4e7da62 Mon Sep 17 00:00:00 2001 From: Albert De La Fuente Vigliotti Date: Tue, 19 Dec 2017 18:24:43 -0200 Subject: [PATCH 3/3] Specify python2 --- docs/source/install.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/source/install.rst b/docs/source/install.rst index 1b07644e..13f0b115 100644 --- a/docs/source/install.rst +++ b/docs/source/install.rst @@ -315,6 +315,7 @@ installing Catalyst on that project automagically as follows: $ mkdir project $ cd project + $ pipenv --two $ pipenv install enigma-catalyst matplotlib Until now the workflow compared to ``pip`` is almost identical, the difference