As of 2014, users are strongly recommended to use ReportLab 3.1.6 or higher.
ReportLab PLUS packages are hosted in our private PyPi repository. Authentication is required to download - gain access by creating a reportlab.com login (it's free and only takes a few seconds).
(For previous versions of ReportLab PLUS please use the old installation instructions. Existing users should note that ReportLab 3.1+ is compatible with previous versions of RML.)
You can install direct from our PyPi repository. Ensure you have updated pip prior to running the commands. Use your reportlab.com email address and password when prompted.
pip install rlextra -i https://www.reportlab.com/pypi/
User for www.reportlab.com: email@example.com
Password: your password
Downloading rlextra-3.1.9.tar.gz (8.4MB): 7.9MB downloaded
For an automated install in a requirements file or build script, check your user name on our web site profile page, and use that (an email address would confuse pip). Note that the command must be split over two separate lines as shown below, with the extra repo AFTER rlextra, in order to work:
If you are on Windows we recommend using pip-win, a graphical version of the pip packaging tool. (Getting Python up and running on Windows can be a challenge - if you are totally new we recommend Tyler Butler's handy guide).
- Install Python 2.7 or 3.3+ from the Python.org Windows page.
- Install and run pip's Python package manager for Windows "pip-win".
pip-win offers a command line. Use it to run the following two commands in turn:
# updates pip to latest version
pip install rlextra -i https://EMAIL:PASSWORD@www.reportlab.com/pypi
# installs ReportLab PLUS & all associated packages direct from our private PyPi repository
Follow the on-screen prompts as they appear (it may cycle through a number of installations during the upgrade but stick with it).
The Python Imaging Library needs to be compiled with support for JPEG, PNG and FreeType fonts. On Windows, it's not an issue as you get a precompiled binary.
On Ubuntu 12.04 (others may vary) try
sudo apt-get install libjpeg8-dev libfreetype6-dev libpng12-dev
On Mac OS using Homebrew, try
brew install libjpeg libtiff freetype
The current set of dependencies at the time of writing is listed below. reportlab and rlextra specify their dependencies, so most installation systems will fetch them for you. You can use this in requirements files if you wish
pillow >= 2.4.0 reportlab >= 3.1.6 pyrxp >= 2.1.0 preppy >= 2.3.0 pmw >= 1.3.3 #ONLY used for Diagra charts customers rlextra >= 3.1.6
The Python installation system unfortunately doesn't have a place for documentation, tests and examples for end users. We are therefore moving all these things to a public BitBucket repository which you can browse online and clone locally to play with.
To pull this down, run this command, then look at the README
hg clone http://bitbucket.org/rptlab/rlextra-examples/
If you are stuck behind a firewall, our BitBucket page has a link (at the bottom of the left side menu) to download this in a zip file.
Please let us know your thoughts on how the package installs, any issues you run in to and how it works with your existing ReportLab apps by emailing firstname.lastname@example.org (evaluators) or email@example.com (licensed customers only)
The ReportLab team.