Wiki regression testing

The term Regression testing is used in Apertium to describe a way of testing a language pair, by translating a collection of "test phrases" and compare the result to the expected output. Computer engineers would call this Unit testing.

This is most useful when you are working on a young/new language pair, where you are working with rules or dictionaries and want to change a rule or word and get an overview of the consequences, and check that your changes haven't broken anything.

Most mature pairs abandon these tests (see discussion here) and use testvoc and corpus test to test improvements in the translator.

The regressions tests work by downloading a wiki page with the phrases and the expected output like the page English_and_Esperanto/Regression_tests and then running the translator.

Installation and invocation

You could simply copy the script regression-tests.sh from an existing language pair and change the names in it.

To start, type sh regression-tests.sh on a Unix box.

Troubleshooting

If you get output like: regression-tests.sh: 28: [[: not found then try bash regression-tests.sh or make the script executable (chmod a+x regression-tests.sh) and execute it by ./regression-tests.sh .

Output

For each test, the scipt prints 1) source language 2) expected (correct) output 3) actual output from Apertium. In some test scripts it will only print out the "failed" test (where the expected and actual output is diverging), and in other test scripts it will print out all of the tests, and a summary.

All printing style

Example

$ sh regression-tests.sh 
sv-da	  Jag vill gå en tur
WORKS	  Jeg vil gå en tur

sv-da	  Du vill gå en tur
WORKS	  Du vil gå en tur

 ....

sv-da	  Maten är äten
	- Maden er spist
	+ #Mad er spist

sv-da	  Äpplet är ätet
WORKS	  Æblet er spist

22 / 23
~95.65%

No-printing style

Example

en-eo	  In the 'Boards' section you can change the list of activities. 
	- En la sekcio 'Tabuloj' vi povas ŝanĝi la liston de aktivecoj. 
	+ En la 'Tabuloj' sekcio vi povas ŝanĝi la listo de aktivecoj.

en-eo	  Just untoggle them in the treeview. 
	- Simple malelektu ilin en la arbaspekto. 
	+ Nur *untoggle ilin en la *treeview.

en-eo	  You can save multiple configurations, and switch between them easily. 
	- Vi povas sekurigi multajn agordojn, kaj ŝalti inter ili facile. 
	+ Vi povas savi *multiple *configurations, kaj ŝanĝo inter ilin facile.

en-eo	  You can add multiple profiles, with different lists of boards, and different languages. 
	- Vi povas aldoni plurajn profilojn, kun diversaj listoj de tabuloj, kaj diversaj lingvoj. 
	+ Vi povas aldoni *multiple profiloj, kun diferencaj listoj de tabuloj, kaj diferencaj langoj.

See also

• Special:Search/Regression for some examples of regression tests.

See the Wikipedia article Regression testing