mirror of
https://github.com/pdf2htmlEX/pdf2htmlEX.git
synced 2024-12-22 04:50:09 +00:00
.. | ||
browser_tests | ||
old | ||
test_output | ||
.gitattributes | ||
browser_tests.py | ||
fancy.min.css | ||
README.md | ||
start_xvfb.sh | ||
test_local_browser.py | ||
test_output.py | ||
test_remote_browser.py | ||
test.py |
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
andSAUCE_ACCESS_KEY
- Setup a HTTP server at
/
on port 8000 - Enable Sauce Connect
- See
.travis.yml
as an example
- Install
- Set
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 calledtest_issueXXX