DLTK Validators User Guide

DLTK Validators Framework provides tools to run custom scripts on your source files and integrate these scripts into your workbench. Such scripts are commonly targeted to find and report problems in source files - so they are called "validators" or "checkers". DLTK Validators framework provides flexible yet simple way to manage checkers.

4. Type name of the validator into Validator name text field. The name may be completely arbitrary - you will use names to distinguish between validators on your list.

5. Provide a path to your script in the Command to run checker field.

On Unix/Linux: Provide a path to any file that is marked as executable.
on Windows: Provide a path to .bat file or .exe file.

You can use Browse... button to locate file on your hard drive.

6. Type arguments of your validation script into Checker arguments text field. You can use %f wildcard as a substitute for input file name.

7. Into Filename extensions text field type extensions of files on which the script must be performed. Separate extensions by commas. Use * if you want to run script on all the files.

8. We have configured the input for DLTK Validators.

Now let's configure the output. Validator is supposed generate error and/or warning reports. However to integrate these reports into workbench infrastructure DLTK validators Framework must be familiar with the format of such reports. So we provide interface for errors and warnings reports specification. Consider the following example of error report:

Error: myfile.tcl: line 16 Something wrong here

In this line we have the following tokens:

myfile.tcl name of file where error has been found

16 number of line where error is located

Something wrong here message describing the error

We assume that above mentioned tokens: file name, line number and problem message are common for problem reports. So we provide set of predefined wildcards which you can use to define set of output rules.

%f
file name
%n
line number
%m
problem message

So let's write a rule that assigns "error" to the pattern in our example: Error: %f line %n %m