Experience the next step in tabletop RPGs
What is it?
This is the Adventurer's Codex testing framework for UAT tests.
Requirements and setup
- Install python 3
- Create a virtual environment
- Install requirements
pip install -r requirements.txt - Download chrome and/or firefox webdriver (https://selenium-python.readthedocs.io/installation.html#downloading-python-bindings-for-selenium)
- Download opera webdriver https://github.com/operasoftware/operachromiumdriver/releases
- Add path of webdriver executable to PATH environment variable
Current test coverage supports Chrome, Firefox, Opera and Safari.
Usage
The script requires two paramaters:
- url
- web_driver
By default, url is https://nightly.adventurerscodex.com, and web_driver is chrome
Sample usage:
always run in verbose mode and no capture (no params will default to https://nightly.adventurerscodex.com and chrome web_driver)
py.test --verbose --capture=no --usr=username --pwd=password --token=token tests/
with csv report
py.test --verbose --capture=no --usr=username --pwd=password --token=token tests/ --csv tests.csv --csv-columns id,module,name,file,doc,status,message,browser,created_at,duration_formatted
with explicit url and web_driver
py.test --verbose --capture=no --usr=username --pwd=password --token=token --web_driver=chrome --url=https://nightly.adventurerscodex.com tests/
with opera driver
py.test --verbose --capture=no --usr=username --pwd=password --token=token --web_driver=opera --opera_binary_path=/your/driver/path
with specific test file
py.test --verbose --capture=no --usr=username --pwd=password --token=token tests/core/player_tools/test_player_wizard.py::test_attributes_required
How to contribute
- fork the repo
- navigate to the uat_docs folder and find a user story to test (focus is player tools first)
- add a test to the appropriate test file in tests/player_tools/
- if no test file exists, make a new test file (be sure that file matches the patter test_*)
- write the test (be sure to inlcude a print statement of the user story in the test, see other tests for example)
- mark the test as complete in the uat_docs folder by appending '[complete]' to the end of the user story
- make a pr
- thanks for the contribution!
