From acebc26435348458412ad3c98be049928baf97d0 Mon Sep 17 00:00:00 2001 From: Rory Garton-Smith Date: Sat, 30 May 2020 13:19:44 -0700 Subject: [PATCH 1/4] added pyenv --- doc/source/development/contributing.rst | 32 +++++++++++++++++++++---- 1 file changed, 28 insertions(+), 4 deletions(-) diff --git a/doc/source/development/contributing.rst b/doc/source/development/contributing.rst index d02896f777348..9ecba9dac8c7d 100644 --- a/doc/source/development/contributing.rst +++ b/doc/source/development/contributing.rst @@ -270,7 +270,7 @@ Creating a Python environment (pip) If you aren't using conda for your development environment, follow these instructions. You'll need to have at least Python 3.6.1 installed on your system. -**Unix**/**Mac OS** +**Unix**/**Mac OS with virtualenv** .. code-block:: bash @@ -286,7 +286,31 @@ You'll need to have at least Python 3.6.1 installed on your system. python -m pip install -r requirements-dev.txt # Build and install pandas - python setup.py build_ext --inplace -j 0 + python setup.py build_ext --inplace -j 4 + python -m pip install -e . --no-build-isolation --no-use-pep517 + +**Unix**/**Mac OS with pyenv** + +Consult the docs for setting up pyenv `here `__. + +.. code-block:: bash + + # Create a virtual environment + # Use an ENV_DIR of your choice. We'll use ~/Users//.pyenv/versions/pandas-dev + + pyenv virtualenv + + #For instance: + pyenv virtualenv 3.7.6 pandas-dev + + # Activate the virtualenv + pyenv global pandas-dev + + # Now install the build dependencies in the cloned pandas repo + python -m pip install -r requirements-dev.txt + + # Build and install pandas + python setup.py build_ext --inplace -j 4 python -m pip install -e . --no-build-isolation --no-use-pep517 **Windows** @@ -312,7 +336,7 @@ should already exist. python -m pip install -r requirements-dev.txt # Build and install pandas - python setup.py build_ext --inplace -j 0 + python setup.py build_ext --inplace -j 4 python -m pip install -e . --no-build-isolation --no-use-pep517 Creating a branch @@ -1278,7 +1302,7 @@ to enable easy monitoring of the performance of critical pandas operations. These benchmarks are all found in the ``pandas/asv_bench`` directory. asv supports both python2 and python3. -To use all features of asv, you will need either ``conda`` or +To use all features of asv, you will need either ``conda``, or ``virtualenv``. For more details please check the `asv installation webpage `_. From 7214b6c896ca2663fe30ecadd0b4a8c5c5dde8db Mon Sep 17 00:00:00 2001 From: Rory Garton-Smith Date: Sat, 30 May 2020 13:20:53 -0700 Subject: [PATCH 2/4] minor error --- doc/source/development/contributing.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/source/development/contributing.rst b/doc/source/development/contributing.rst index 9ecba9dac8c7d..53662de7664b8 100644 --- a/doc/source/development/contributing.rst +++ b/doc/source/development/contributing.rst @@ -1302,7 +1302,7 @@ to enable easy monitoring of the performance of critical pandas operations. These benchmarks are all found in the ``pandas/asv_bench`` directory. asv supports both python2 and python3. -To use all features of asv, you will need either ``conda``, or +To use all features of asv, you will need either ``conda`` or ``virtualenv``. For more details please check the `asv installation webpage `_. From f4547f5f4c168443971fe72921edd459531c7ed7 Mon Sep 17 00:00:00 2001 From: Rory Garton-Smith Date: Sat, 30 May 2020 13:50:50 -0700 Subject: [PATCH 3/4] fixed trailing whitespace --- doc/source/development/contributing.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/source/development/contributing.rst b/doc/source/development/contributing.rst index 53662de7664b8..9d2e08c72c715 100644 --- a/doc/source/development/contributing.rst +++ b/doc/source/development/contributing.rst @@ -299,8 +299,8 @@ Consult the docs for setting up pyenv `here `__. # Use an ENV_DIR of your choice. We'll use ~/Users//.pyenv/versions/pandas-dev pyenv virtualenv - - #For instance: + + # For instance: pyenv virtualenv 3.7.6 pandas-dev # Activate the virtualenv From 9bee3cbb6e833d4082ffbba1560a726289f30f2b Mon Sep 17 00:00:00 2001 From: Rory Garton-Smith Date: Sun, 31 May 2020 10:28:06 -0700 Subject: [PATCH 4/4] changed global to activate --- doc/source/development/contributing.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/source/development/contributing.rst b/doc/source/development/contributing.rst index 9d2e08c72c715..3022609f976c6 100644 --- a/doc/source/development/contributing.rst +++ b/doc/source/development/contributing.rst @@ -304,7 +304,7 @@ Consult the docs for setting up pyenv `here `__. pyenv virtualenv 3.7.6 pandas-dev # Activate the virtualenv - pyenv global pandas-dev + pyenv activate pandas-dev # Now install the build dependencies in the cloned pandas repo python -m pip install -r requirements-dev.txt