From d3c3408cd46fd735ea6b2770f7d30c9e2b1ab04b Mon Sep 17 00:00:00 2001 From: Julia Medina Date: Wed, 19 Aug 2015 03:19:27 -0300 Subject: [PATCH] Replace alternative OSX install workaround with virtualenv --- docs/intro/install.rst | 20 +++++++------------- 1 file changed, 7 insertions(+), 13 deletions(-) diff --git a/docs/intro/install.rst b/docs/intro/install.rst index 918197e43..978d89920 100644 --- a/docs/intro/install.rst +++ b/docs/intro/install.rst @@ -138,21 +138,14 @@ solutions: brew update; brew upgrade python -* *(Alternative)* Force system python to load the user installed packages - first: +* *(Optional)* Install Scrapy inside an isolated python environment. - * Update your ``PYTHONPATH`` variable (Change ``.bashrc`` to ``.zshrc`` - accordantly if you're using `zsh`_ as default shell):: + This method is a workaround for the above OS X issue, but it's an overall + good practice for managing dependencies and can complement the first method. - echo "export PYTHONPATH=/Library/Python/2.7/site-packages:$PYTHONPATH" >> ~/.bashrc - - * Reload ``.bashrc`` to ensure the changes have taken place:: - - source ~/.bashrc - - * Install ``pip``:: - - sudo easy_install pip + `virtualenv`_ is a tool you can use to create virtual environments in python. + We recommended reading a tutorial like + http://docs.python-guide.org/en/latest/dev/virtualenvs/ to get started. After any of these workarounds you should be able to install Scrapy:: @@ -168,3 +161,4 @@ After any of these workarounds you should be able to install Scrapy:: .. _AUR Scrapy package: https://aur.archlinux.org/packages/scrapy/ .. _homebrew: http://brew.sh/ .. _zsh: http://www.zsh.org/ +.. _virtualenv: https://virtualenv.pypa.io/en/latest/