testilo 16.1.0 → 17.0.0

package/README.md

@@ -27,6 +27,18 @@ Testilo can be installed wherever Node.js (version 14 or later) is installed. Th
 
 The reason for Testilo being an independent package, rather than part of Testaro, is that Testilo can be installed on any host, while Testaro can run successfully only on a Windows or Macintosh workstation (and perhaps on some workstations with Ubuntu operating systems). Testaro runs tests similar to those that a human accessibility tester would run, using whatever browsers, input devices, system settings, simulated and attached devices, and assistive technologies tests may require. Thus, Testaro is limited to functionalities that require workstation attributes. For maximum flexibility in the management of Testaro jobs, all other functionalities are located outside of Testaro. You could have software such as Testilo running on a server, communicating with multiple workstations running Testaro. The workstations could receive job orders from the server and return job results to the server for further processing.
 
+## Configuration
+
+Environment variables for Testilo can be specified in a `.env` file. An example:
+
+```bash
+FUNCTIONDIR=../testdir/procs
+JOBDIR=../testdir/jobs
+REPORTDIR=../testdir/reports
+REQUESTER=a11ymgr@a11yorg.com
+SPECDIR=../testdir/specs
+```
+
 ## Job preparation
 
 ### Introduction
@@ -332,12 +344,11 @@ This is a valid Testaro job.
 
 If, however, you requested a merger **with** isolation, then Testilo would take cognizance of the fact that an `axe` test act is a target-modifying act. Testilo would therefore act as if another instance of the placeholder had been located in the script after the `axe` test act. So, copies of the same 6 acts that precede the `axe` test act would be inserted **after** the `axe` test act, too.
 
-Of the 10 tools providing tests for Testaro, 6 are target-modifying:
+Of the 8 tools providing tests for Testaro, 4 are target-modifying:
 - `axe`
-- `continuum`
 - `htmlcs`
 - `ibm`
-- `wave`
+- `testaro`
 
 #### Invocation
 
@@ -630,7 +641,7 @@ node call credit legislators 23pl
 
 When a user invokes `credit` in this example, the `call` module:
 - gets all the reports in the `scored` subdirectory of the `process.env.REPORTDIR` directory whose file names begin with `23pl`.
-- writes the credit report as JSON file named `legislators.json` to the `credit` subdirectory of the `process.env.REPORTDIR` directory.
+- writes the credit report as a JSON file named `legislators.json` to the `credit` subdirectory of the `process.env.REPORTDIR` directory.
 
 The third argument to `call` (`23pl` in this example) is optional. If it is omitted, `call` will get and `credit()` will tabulate all the reports in the `scored` directory.
 

package/call.js

@@ -66,7 +66,7 @@ const callScript = async (scriptID, classificationID = null, ... issueIDs) => {
   const scriptObj = script(scriptID, issues, ... issueIDs);
   // Save the script.
   const scriptJSON = JSON.stringify(scriptObj, null, 2);
-  await fs.writeFile(`${specDir}/scripts/${scriptID}.json`, scriptJSON);
+  await fs.writeFile(`${specDir}/scripts/${scriptID}.json`, `${scriptJSON}\n`);
   console.log(`Script ${scriptID} created and saved in ${specDir}/scripts`);
 };
 // Fulfills a merging request.
@@ -82,7 +82,7 @@ const callMerge = async (scriptID, batchID, requester, withIsolation, todo) => {
   const destination = todo === 'true' ? 'todo' : 'pending';
   for (const job of jobs) {
     const jobJSON = JSON.stringify(job, null, 2);
-    await fs.writeFile(`${jobDir}/${destination}/${job.id}.json`, jobJSON);
+    await fs.writeFile(`${jobDir}/${destination}/${job.id}.json`, `${jobJSON}\n`);
   }
   const {timeStamp} = jobs[0];
   console.log(
@@ -102,7 +102,7 @@ const callSeries = async (idStart, count, interval) => {
     const jobSeries = series(job, Number.parseInt(count), Number.parseInt(interval));
     // Save the jobs.
     for (const item of jobSeries) {
-      await fs.writeFile(`${jobDir}/todo/${item.id}.json`, JSON.stringify(item, null, 2));
+      await fs.writeFile(`${jobDir}/todo/${item.id}.json`, `${JSON.stringify(item, null, 2)}\n`);
     }
     console.log(`Series of ${jobSeries.length} jobs generated and saved in ${jobDir}/todo`);
   }
@@ -141,7 +141,9 @@ const callScore = async (scorerID, selector = '') => {
     // For each scored report:
     for (const report of reports) {
       // Save it.
-      await fs.writeFile(`${scoredReportDir}/${report.id}.json`, JSON.stringify(report, null, 2));
+      await fs.writeFile(
+        `${scoredReportDir}/${report.id}.json`, `${JSON.stringify(report, null, 2)}\n`
+      );
     };
     console.log(`Reports scored and saved in ${scoredReportDir}`);
     }
@@ -277,7 +279,7 @@ else if (fn === 'compare' && fnArgs.length > 1 && fnArgs.length < 4) {
     console.log('Execution completed');
   });
 }
-else if (fn === 'credit' && fnArgs.length === 2) {
+else if (fn === 'credit' && fnArgs.length > 0 && fnArgs.length < 3) {
   callCredit(... fnArgs)
   .then(() => {
     console.log('Execution completed');

package/merge.js

@@ -18,7 +18,6 @@ const stdRequester = process.env.REQUESTER;
 // Tools that alter the page.
 const contaminantNames = new Set([
   'axe',
-  'continuum',
   'htmlcs',
   'ibm'
 ]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "testilo",
-  "version": "16.1.0",
+  "version": "17.0.0",
   "description": "Prepares and processes Testaro reports",
   "main": "aim.js",
   "scripts": {

package/procs/score/tic33.js

@@ -7283,6 +7283,11 @@ exports.issues = {
           quality: 1,
           what: 'Left angle bracket is followed by a question mark'
         },
+        '^Bad character . after <. Probable cause: Unescaped <. Try escaping it as &lt;.*$': {
+          variable: true,
+          quality: 1,
+          what: 'Left angle bracket is followed by an invalid character'
+        },
         'Almost standards mode doctype. Expected <!DOCTYPE html>.': {
           variable: false,
           quality: 1,