DenysMedvid
/
pdf2htmlEX
mirror of https://github.com/pdf2htmlEX/pdf2htmlEX.git
1
0
Fork 0
Code Releases Activity
pdf2htmlEX/test
History
Lu Wang c1d3720036 wait for page loaded in auto tests 2015-03-17 19:07:05 +08:00
..
browser_tests update test case references 2015-03-17 17:31:19 +08:00
old working on unittest 2014-11-16 00:06:43 +08:00
test_output travis debug 2014-11-18 13:17:22 +08:00
.gitattributes improving tests 2014-11-19 00:48:18 +08:00
README.md ..[skip ci] 2015-03-17 13:50:23 +08:00
browser_tests.py wait for page loaded in auto tests 2015-03-17 19:07:05 +08:00
fancy.min.css improve test runner 2014-11-16 13:40:02 +08:00
start_xvfb.sh travis debug 2014-11-18 13:17:22 +08:00
test.py update test case references 2015-03-17 17:31:19 +08:00
test_local_browser.py wait for page loaded in auto tests 2015-03-17 19:07:05 +08:00
test_output.py imporving tests[ci skip] 2014-11-20 12:19:45 +08:00
test_remote_browser.py wait for page loaded in auto tests 2015-03-17 19:07:05 +08:00

README.md

Dependencies

  • python2 and packages
    • Python Imaging Library
    • Selenium
    • unittest
  • Firefox

Usage

  • Run all tests:
    • ./test.py
  • Run selected test suites:
    • ./test.py test_local_browser
  • Run selected test case:
    • ./test.py test_local_browser.test_basic_text
    • Or ./test.py test_basic_text
  • Environment variables:
    • Set P2H_TEST_SAVE_TMP=1 to keep the temporary files in /tmp/pdf2htmlEX_test
    • Set P2H_TEST_GEN=1 to generate new reference files
    • Set 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

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