### Dependencies

- python2 and packages
  - Python Imaging Library
  - Selenium
  - unittest
- Firefox
  - firefoxdriver

### Usage
- Run all tests:
  - python test_output.py
  - python test_local_browser.py
- Environment variables:
  - `export P2H_TEST_GEN=1` to generate new reference files (when done, `unset P2H_TEST_GEN`)
  - `export P2H_TEST_REMOTE=1` to test different browsers using Sauce Labs
    - Install `sauceclient` for Python
    - Set correct values for `SAUCE_USERNAME` and `SAUCE_ACCESS_KEY`
    - Setup a HTTP server at `/` on port 8000
    - Enable Sauce Connect
    - See `.travis.yml` as an example
    - python test_remote_browser.py

### Add new test cases

- Make sure you have the proper copyrights.
- Using meaningful file names, a description of the file, or issueXXX.pdf.
- Make each test case minimal:
  - One page only, unless the test case is about multiple pages.
  - Grayscale only, unless the test case is about colors.
  - Remove unnecessary elements.
- [Optional] Include the source files that the PDF file is generated from.
- Add the new PDF file to the correct folder in `test/`, and add a new function in the corresponding Python file
- Run `P2H_TEST_GEN=1 test/test.py test_issueXXX` to generate the reference, assuming that the new function is called `test_issueXXX`