Difference between revisions of "Test suite"

From Wiki
Jump to navigation Jump to search
m (A page for Taco (to be finished); should be interlinked with other pages and Categorized as well)
 
m (tidy grammar)
(7 intermediate revisions by 5 users not shown)
Line 1: Line 1:
=== Where can I find it? ===
+
== What is it? ==
  
* https://foundry.supelec.fr/projects/contexttest/
+
The test suite is a set of files that exercise many ConTeXt features and are used by Hans for testing releases.
  
=== What is it (What's the purpose)? ===
+
== Where is it? ==
  
=== Who can/should submit new tests? ===
+
They are on the PRAGMA site [http://www.pragma-ade.nl/context/latest/cont-tst.7z here as a 7zip archive].
  
* Anyone.
+
== How can they be useful? ==
* But since Hans and Taco are busy enough, users, even beginners, are the ones expected to submit new tests.
 
  
=== Who REALLY should submit new tests? ===
+
On the mailing list, Hans sometimes points one to minimal examples of a feature being asked about.  You can recursively grep through the (uncompressed) archive to find the example.  For example, I had asked about coupled problems and solutions, for which the relevant mechanism is blocks.  To quote Hans: "(there are some examples in the test suite under blocks)."  After I unpacked the archive (into <code>/tmp/doc/</code>), the following command located the examples:
  
* If a bug that you encountered gets fixed (on the mainling list).
+
<pre>
* If a new feature is implemented on your request.
+
$ grep -r -n  --include='*.tex' '\<block\>' /tmp/doc/
 
+
/tmp/doc/context/tests/mkiv/blocks/blocks-001.tex:89:\chapter{Normal block use}
=== How to submit new tests? ===
+
/tmp/doc/context/tests/mkiv/blocks/blocks-001.tex:91:    % test normal block use
 
+
/tmp/doc/context/tests/mkiv/blocks/blocks-001.tex:164:    % test nested block
* create an account on https://foundry.supelec.fr/projects/contexttest/
+
/tmp/doc/context/tests/mkiv/blocks/blocks-001.tex:171:\startquestion Is this a question in a nested block? \stopquestion
* click on <code>[Rrequest to join]</code>
+
/tmp/doc/context/tests/mkiv/blocks/blocks-001.tex:178:Here we call for the nested block:
* {{todo|write notes about installing/using svn}}
+
</pre>
 
 
=== Any easier way to do that? ===
 
 
 
* No yet, but it would be nice if a simpler way existed. Perhaps in the future ...
 
 
 
=== How can I see/compare the results and judge if they're OK? ===
 

Revision as of 14:38, 4 February 2019

What is it?

The test suite is a set of files that exercise many ConTeXt features and are used by Hans for testing releases.

Where is it?

They are on the PRAGMA site here as a 7zip archive.

How can they be useful?

On the mailing list, Hans sometimes points one to minimal examples of a feature being asked about. You can recursively grep through the (uncompressed) archive to find the example. For example, I had asked about coupled problems and solutions, for which the relevant mechanism is blocks. To quote Hans: "(there are some examples in the test suite under blocks)." After I unpacked the archive (into /tmp/doc/), the following command located the examples:

$ grep -r -n  --include='*.tex' '\<block\>' /tmp/doc/
/tmp/doc/context/tests/mkiv/blocks/blocks-001.tex:89:\chapter{Normal block use}
/tmp/doc/context/tests/mkiv/blocks/blocks-001.tex:91:    % test normal block use
/tmp/doc/context/tests/mkiv/blocks/blocks-001.tex:164:    % test nested block
/tmp/doc/context/tests/mkiv/blocks/blocks-001.tex:171:\startquestion Is this a question in a nested block? \stopquestion
/tmp/doc/context/tests/mkiv/blocks/blocks-001.tex:178:Here we call for the nested block: