mirror of
https://github.com/scrapy/scrapy.git
synced 2025-02-27 14:03:40 +00:00
44c8ef2d47
In the installation guide, in the "Platform specific installation notes" section, Ubuntu and ArchLinux are currently subsections of Windows, which does not make sense imho. This commit changes the section tree from: Platform specific installation notes - Windows -- Archlinux -- Ubuntu To: Platform specific installation notes - Windows - Ubuntu - Archlinux
98 lines
2.8 KiB
ReStructuredText
98 lines
2.8 KiB
ReStructuredText
.. _intro-install:
|
|
|
|
==================
|
|
Installation guide
|
|
==================
|
|
|
|
Installing Scrapy
|
|
=================
|
|
|
|
.. note:: Check :ref:`intro-install-platform-notes` first.
|
|
|
|
The installation steps assume that you have the following things installed:
|
|
|
|
* `Python`_ 2.7
|
|
|
|
* `pip`_ and `setuptools`_ Python packages. Nowadays `pip`_ requires and
|
|
installs `setuptools`_ if not installed.
|
|
|
|
* `lxml`_. Most Linux distributions ships prepackaged versions of lxml.
|
|
Otherwise refer to http://lxml.de/installation.html
|
|
|
|
* `OpenSSL`_. This comes preinstalled in all operating systems, except Windows
|
|
where the Python installer ships it bundled.
|
|
|
|
You can install Scrapy using pip (which is the canonical way to install Python
|
|
packages).
|
|
|
|
To install using pip::
|
|
|
|
pip install Scrapy
|
|
|
|
.. _intro-install-platform-notes:
|
|
|
|
Platform specific installation notes
|
|
====================================
|
|
|
|
Windows
|
|
-------
|
|
|
|
* Install Python 2.7 from https://www.python.org/downloads/
|
|
|
|
You need to adjust ``PATH`` environment variable to include paths to
|
|
the Python executable and additional scripts. The following paths need to be
|
|
added to ``PATH``::
|
|
|
|
C:\Python27\;C:\Python27\Scripts\;
|
|
|
|
To update the ``PATH`` open a Command prompt and run::
|
|
|
|
c:\python27\python.exe c:\python27\tools\scripts\win_add2path.py
|
|
|
|
Close the command prompt window and reopen it so changes take effect, run the
|
|
following command and check it shows the expected Python version::
|
|
|
|
python --version
|
|
|
|
* Install `pywin32` from http://sourceforge.net/projects/pywin32/
|
|
|
|
Be sure you download the architecture (win32 or amd64) that matches your system
|
|
|
|
* Install `pip`_ from https://pip.pypa.io/en/latest/installing.html
|
|
|
|
Now open a Command prompt to check ``pip`` is installed correctly::
|
|
|
|
pip --version
|
|
|
|
* At this point Python 2.7 and ``pip`` package manager must be working, let's
|
|
install Scrapy::
|
|
|
|
pip install Scrapy
|
|
|
|
Ubuntu 9.10 or above
|
|
--------------------
|
|
|
|
**Don't** use the ``python-scrapy`` package provided by Ubuntu, they are
|
|
typically too old and slow to catch up with latest Scrapy.
|
|
|
|
Instead, use the official :ref:`Ubuntu Packages <topics-ubuntu>`, which already
|
|
solve all dependencies for you and are continuously updated with the latest bug
|
|
fixes.
|
|
|
|
Archlinux
|
|
---------
|
|
|
|
You can follow the generic instructions or install Scrapy from `AUR Scrapy package`::
|
|
|
|
yaourt -S scrapy
|
|
|
|
|
|
.. _Python: https://www.python.org/
|
|
.. _pip: https://pip.pypa.io/en/latest/installing.html
|
|
.. _easy_install: http://pypi.python.org/pypi/setuptools
|
|
.. _Control Panel: http://www.microsoft.com/resources/documentation/windows/xp/all/proddocs/en-us/sysdm_advancd_environmnt_addchange_variable.mspx
|
|
.. _lxml: http://lxml.de/
|
|
.. _OpenSSL: https://pypi.python.org/pypi/pyOpenSSL
|
|
.. _setuptools: https://pypi.python.org/pypi/setuptools
|
|
.. _AUR Scrapy package: https://aur.archlinux.org/packages/scrapy/
|