DenysMedvid
/
pdf2htmlEX
mirror of https://github.com/pdf2htmlEX/pdf2htmlEX.git
1
0
Fork 0
Code Releases Activity
pdf2htmlEX/pdf2htmlEX/test
History
Stephen Gaito 4e4f152828 initial restructure of directories 2019-11-21 12:35:10 +00:00
..
browser_tests initial restructure of directories 2019-11-21 12:35:10 +00:00
old initial restructure of directories 2019-11-21 12:35:10 +00:00
test_output initial restructure of directories 2019-11-21 12:35:10 +00:00
.gitattributes initial restructure of directories 2019-11-21 12:35:10 +00:00
README.md initial restructure of directories 2019-11-21 12:35:10 +00:00
browser_tests.py initial restructure of directories 2019-11-21 12:35:10 +00:00
fancy.min.css initial restructure of directories 2019-11-21 12:35:10 +00:00
start_xvfb.sh initial restructure of directories 2019-11-21 12:35:10 +00:00
test.py.in initial restructure of directories 2019-11-21 12:35:10 +00:00
test_local_browser.py initial restructure of directories 2019-11-21 12:35:10 +00:00
test_output.py initial restructure of directories 2019-11-21 12:35:10 +00:00
test_remote_browser.py initial restructure of directories 2019-11-21 12:35:10 +00:00

README.md

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