This tool prepares a report based for the given url based of on these parameters:
-
Details of the SSL Certificate
-
Cookies being used (only session cookies)
-
ADA Compliance Violations
- Alt text in all images
- Color Contrast as per w3.org
- Tabbed Navigation in a website
Chrome Web Browser is an absolute requirement for this tool to work properly.
Python Version 3.3+ is required for this tool.
Chrome Web Driver:
Download the Chrome webdriver for your specific operating system and follow the steps accordingly.
- Windows
- Create a directory name
C:\bin
- Check your chrome browser version from
Menu>Help>About Chrome
from google chrome browser.(it would be a number like 96.0.445.0 etc) - Download the chrome driver according to your chrome version from https://chromedriver.chromium.org/downloads
- Extract the zip file and copy the chromedriver.exe file to
C:\bin
- Verify setup with
chromedriver.exe -v
and check if the version mentions your google chrome version.
- Create a directory name
- Linux
- Please check your google chrome version by running
google-chrome --version
in your terminal. - Download the chrome webdriver according to the chrome version from https://chromedriver.chromium.org/downloads
- Unzip the folder and copy the
chromedriver
file to/usr/bin/chromedriver
bysudo mv chromedriver /usr/bin/chromedriver
- Run these commands to make it executable
sudo chown root:root /usr/bin/chromedriver
andsudo chmod +x /usr/bin/chromedriver
- Please ensure that you have the latest version of pip installed. If not then please install it from
sudo apt-get install python3-pip
- while running the dependency.sh file if you get an error as :
ERROR: pyopensll 21.0.0 has requirement cryptography>=3.3, but you'll have cryptography 2.8 which is incompatible
then runpip install cryptography==3.3
to resolve it.
- Please check your google chrome version by running
The python libraries required for this tool are:
requests
selenium
axe_selenium_python
bs4 ( BeautifulSoup )
pyqt5
PyQtWebEngine
validators
pysimplegui
You Can install these dependencies manually using pip or you can use the dependency scripts as mentioned below.
-
Navigate to the
windows
folder underWebActuary-main/
and run thedependencies.bat
file in order to get all the libraries being used.After this run the
begin_audit.bat
file to start the applications.'dependencies.bat' file can be used to install all the libraries required for this tool to work.
'begin_audit.bat' file is the main file that can be used to run this tool.
-
Navigate to the
linux
folder underWebActuary-main/
and run the following commands:sudo chmod +x dependencies.sh
sudo chmod +x begin_audit.sh
Run the dependencies file as
./dependencies.sh
To begin the Audit process run the begin_audit file as
./begin_audit.sh
-
Please ensure that your python installation has the python3.dll file along with it. If not you might face an error similar to this:
from PyQt5.QtWebEngineWidgets import QWebEnginePage ImportError: DLL load failed while importing QtWebEngineWidgets: The specified module could not be found.
-
For an accurate audit report kindly disable chrome extensions like darkreader that might affect the default User Interface of the webpage since most of the accessibility tests are run on the client side.
-
Also kindly disable other chrome extensions that might block the cookies and pop-ups/banners.
-
If you face an error like: This version of ChromeDriver only supports Chrome version X. Please download the suitable driver from https://chromedriver.chromium.org/downloads according to the version as seen in the error according to your operating system.
-
If the program enters the 'not responding' mode kinldy wait for a few seconds.