From 5a5364d0c109733c15cd9ce4bbc1f23a6f0c116e Mon Sep 17 00:00:00 2001 From: Pablo Hoffman Date: Tue, 16 Nov 2010 03:31:04 -0200 Subject: [PATCH] Updated documentation to point out that simplejson is now required if using Python 2.5, and to recommended switching to Python 2.6 --- docs/faq.rst | 16 +++++++++++++++- docs/intro/install.rst | 4 +++- 2 files changed, 18 insertions(+), 2 deletions(-) diff --git a/docs/faq.rst b/docs/faq.rst index 966de7456..c369cb61c 100644 --- a/docs/faq.rst +++ b/docs/faq.rst @@ -24,11 +24,25 @@ comparing `jinja2`_ to `Django`_. .. _jinja2: http://jinja.pocoo.org/2/ .. _Django: http://www.djangoproject.com +.. _faq-python-versions: + +What Python versions does Scrapy support? +----------------------------------------- + +Scrapy runs in Python 2.5, 2.6 and 2.6. But it's recommended you use Python 2.6 +or above, since the Python 2.5 standard library has a few bugs in their URL +handling libraries. Some of these Python 2.5 bugs not only affect Scrapy but +any user code, such as spiders. You can see a list of `Python 2.5 bugs that +affect Scrapy`_ in the issue tracker. + +.. _Python 2.5 bugs that affect Scrapy: http://dev.scrapy.org/query?status=accepted&status=assigned&status=new&status=reopened&order=priority&keywords=~py25-bug + Does Scrapy work with Python 3.0? --------------------------------- No, and there are no plans to port Scrapy to Python 3.0 yet. At the moment, -Scrapy works with Python 2.5, 2.6 and 2.7. +Scrapy works with Python 2.5, 2.6 and 2.7. See also: +:ref:`faq-python-versions`. Did Scrapy "steal" X from Django? --------------------------------- diff --git a/docs/intro/install.rst b/docs/intro/install.rst index 8dff1e262..1f5d9a3e0 100644 --- a/docs/intro/install.rst +++ b/docs/intro/install.rst @@ -27,17 +27,19 @@ Requirements * `libxml2`_ (versions prior to 2.6.28 are known to have problems parsing certain malformed HTML, and have also been reported to contain leaks, so 2.6.28 or above is highly recommended) +* `simplejson`_ (not required if using Python 2.6 or above) + .. _Python: http://www.python.org .. _Twisted: http://twistedmatrix.com .. _libxml2: http://xmlsoft.org .. _pywin32: http://sourceforge.net/projects/pywin32/ +.. _simplejson: http://pypi.python.org/pypi/simplejson/ .. _Zope.Interface: http://pypi.python.org/pypi/zope.interface#download .. _this Twisted bug: http://twistedmatrix.com/trac/ticket/3707 Optional: * `pyopenssl `_ (for HTTPS support, highly recommended) -* `simplejson `_ (for (de)serializing JSON) .. _intro-install-step1: