Welcome!

This is the temporary home of Specular.

Specular is a suite of tools and libraries that allows testing for
accessibility from the AT (client) standpoint.

Speclenium is a daemon that when used in conjunction with Selenium, provides Selenium tests with a superset of accessibility-related functionality.

Specular is distributed as two distinct packages:

1. Speclenium server

This package provides everything needed to run Speclenium server on a target machine. The target machine will need to have the browser that is being tested installed too, of course.

When using the win32 binary, all that is needed is to double-click on speclenium.exe. When using the generic distribution, Twisted is needed in addition to Python 2.5 and it’s standard libraries.

You could get the speclenium server here:

2. Speclenium test suite

This package lives on the host computer, and it can remotely launch and run tests on remote browsers living on target machines. This is optional, both the Speclenium server, and the test suite could be on the same machine.

The test suite depends on the settings.ini file to reflect the available machines running speclenium, and the browsers on each of these machines.

The test suite consists of two tools:

  1. PyUnit tests. These are simple unit tests that check for common ARIA support. The collection of tests will soon grow. The tests could be found in the “tests” subdirectory. The “run_tests.py” script is an easy harness that allows running the test with any combination of tests and of browsers defined in “settings.ini”. Run with “–help” to see range of options.
  2. API delta tool. This tool, “quick_diff.py”, allows pointing two browsers at a URL, and spotting the differences in their accessible object hierarchies. It uses the same “settings.ini” to provide remote (or local) hosts and their installed browsers. It also allows saving a hierarchy to file for later comparison with different browsers or builds. The delta could be viewed either by a list of changes, or by a browser viewable XML file (put the output XML file in “viewdiff” for that to work). This tool is still in early stages of development, so the tree size it can handle is fairly limited, don’t point it at GMail just yet!

You could get the test suite here:

Source Code

You could get current snapshots of this tool from my Github repository.