Installation

This is a typical Python library and is installed using pip

pip install xhtml2pdf

Requirements

Python 3.6+

All additional requirements are listed in setup.py file and are installed automatically using the pip install xhtml2pdf method.

Development environment

1. If you don’t have it, install pip, the python package installer

   sudo easy_install pip
   

   For more information about pip refer to http://www.pip-installer.org/.

2. We recommend using virtualenv for development. It is great to have a separate environment for each project, keeping the dependencies for multiple projects separated

   sudo pip install virtualenv
   

   For more information about virtualenv refer to http://www.virtualenv.org/

3. Create a virtualenv for the project. This can be inside the project directory, but cannot be under version control

   virtualenv --distribute xhtml2pdfenv --python=python2
   

4. Activate your virtualenv

   source xhtml2pdfenv/bin/activate
   

   Later to deactivate use

   deactivate
   

5. Next step will be to install/upgrade dependencies from the requirements.txt file

   pip install -r requirements.txt
   

6. Run tests to check your configuration

   python -m unittest discover tests
   

   You should have a log with success status:

   Ran 108 tests in 1.372s
   
   OK