diff --git a/depends/README.rst b/depends/README.rst index 62c101ecf..dd05b86ca 100644 --- a/depends/README.rst +++ b/depends/README.rst @@ -1,4 +1,27 @@ Depends ======= -Scripts in this directory can be used to download, build & install non-packaged dependencies; useful for testing with Travis CI. +``install_openjpeg.sh`` and ``install_webp.sh`` can be used to +download, build & install non-packaged dependencies; useful for +testing with Travis CI. + +The other scripts can be used to install all of the dependencies for +the listed operating systems/distros. The ``ubuntu_14.04.sh`` and +``debian_8.2.sh`` scripts have been tested on bare AWS images and will +install all required dependencies for the system Python 2.7 and 3.4 +for all of the optional dependencies. Git may also be required prior +to running the script to actually download Pillow. + +e.g.:: + + $ sudo apt-get install git + $ git clone https://github.com/python-pillow/Pillow.git + $ cd Pillow/depends + $ ./debian_8.2.sh + $ cd .. + $ git checkout [branch or tag] + $ virtualenv -p /usr/bin/python2.7 ~/vpy27 + $ source ~/vpy27/bin/activate + $ make install + $ make test + diff --git a/depends/debian_8.2.sh b/depends/debian_8.2.sh new file mode 100755 index 000000000..2a175098f --- /dev/null +++ b/depends/debian_8.2.sh @@ -0,0 +1,14 @@ +#!/bin/sh + +# +# Installs all of the dependencies for Pillow for Debian 8.2 +# for both system Pythons 2.7 and 3.4 +# + +sudo apt-get -y install python-dev python-setuptools \ + python3-dev python-virtualenv cmake +sudo apt-get -y install libtiff5-dev libjpeg62-turbo-dev zlib1g-dev \ + libfreetype6-dev liblcms2-dev libwebp-dev tcl8.6-dev tk8.6-dev \ + python-tk python3-tk + +./install_openjpeg.sh diff --git a/depends/ubuntu_14.04.sh b/depends/ubuntu_14.04.sh new file mode 100755 index 000000000..14b9e7066 --- /dev/null +++ b/depends/ubuntu_14.04.sh @@ -0,0 +1,14 @@ +#!/bin/sh + +# +# Installs all of the dependencies for Pillow for Ubuntu 14.04 +# for both system Pythons 2.7 and 3.4 +# + +sudo apt-get -y install python-dev python-setuptools \ + python3-dev python-virtualenv cmake +sudo apt-get -y install libtiff5-dev libjpeg8-dev zlib1g-dev \ + libfreetype6-dev liblcms2-dev libwebp-dev tcl8.6-dev tk8.6-dev \ + python-tk python3-tk + +./install_openjpeg.sh diff --git a/docs/installation.rst b/docs/installation.rst index 9b0e46bf3..052bd6539 100644 --- a/docs/installation.rst +++ b/docs/installation.rst @@ -83,6 +83,8 @@ Many of Pillow's features require external libraries: * **openjpeg** provides JPEG 2000 functionality. * Pillow has been tested with openjpeg **2.0.0** and **2.1.0**. + * Pillow does **not** support the earlier **1.5** series which ships + with Ubuntu and Debian. Once you have installed the prerequisites,run:: @@ -195,7 +197,11 @@ Linux Installation .. note:: - Most major Linux distributions, including Fedora, Debian/Ubuntu and ArchLinux include Pillow in packages that previously contained PIL e.g. ``python-imaging``. Please consider using native operating system packages first to avoid installation problems and/or missing library support later. + Most major Linux distributions, including Fedora, Debian/Ubuntu + and ArchLinux include Pillow in packages that previously contained + PIL e.g. ``python-imaging``. Please consider using native + operating system packages first to avoid installation problems + and/or missing library support later. **We do not provide binaries for Linux.** If you didn't build Python from source, make sure you have Python's development libraries installed. In Debian @@ -267,7 +273,9 @@ current versions of Linux, OS X, and Windows. | | | | | | | | | 2.7,3.2 | 2.6.1 |ppc | +----------------------------------+-------------+------------------------------+--------------------------------+-----------------------+ -| Ubuntu Linux 14.04 LTS |Yes | 2.7,3.2,3.3,3.4 | 2.3.0 |x86 | +| Ubuntu Linux 14.04 LTS |Yes | 2.7,3.4 | 3.0.0 |x86-64 | ++----------------------------------+-------------+------------------------------+--------------------------------+-----------------------+ +| Debian 8.2 Jessie |Yes | 2.7,3.4 | 3.0.0 |x86-64 | +----------------------------------+-------------+------------------------------+--------------------------------+-----------------------+ | Raspian Wheezy |Yes | 2.7,3.2 | 2.3.0 |arm | +----------------------------------+-------------+------------------------------+--------------------------------+-----------------------+ @@ -289,4 +297,8 @@ current versions of Linux, OS X, and Windows. Old Versions ------------ -You can download old distributions from `PyPI `_. Only the latest major releases for Python 2.x and 3.x are visible, but all releases are available by direct URL access e.g. https://pypi.python.org/pypi/Pillow/1.0. +You can download old distributions from `PyPI +`_. Only the latest major +releases for Python 2.x and 3.x are visible, but all releases are +available by direct URL access +e.g. https://pypi.python.org/pypi/Pillow/1.0.