Wiki regression testing
The term Regression testing[1] 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.
