108 lines
2.5 KiB
Markdown
108 lines
2.5 KiB
Markdown
|
# yanglint testing
|
||
|
|
|
||
|
|
Testing yanglint is divided into two ways.
|
||
|
|
It is either tested in interactive mode using the tcl command 'expect' or non-interactively, classically from the command line.
|
||
|
|
For both modes, unit testing was used using the tcl package tcltest.
|
||
|
|
|
||
|
|
## How to
|
||
|
|
|
||
|
|
The sample commands in this chapter using `tclsh` are called in the `interactive` or `non-interactive` directories.
|
||
|
|
|
||
|
|
### How to run all yanglint tests?
|
||
|
|
|
||
|
|
In the build directory designated for cmake, enter:
|
||
|
|
|
||
|
|
```
|
||
|
|
ctest -R yanglint
|
||
|
|
```
|
||
|
|
|
||
|
|
### How to run all yanglint tests that are in interactive mode?
|
||
|
|
|
||
|
|
In the interactive directory, run:
|
||
|
|
|
||
|
|
```
|
||
|
|
tclsh all.tcl
|
||
|
|
```
|
||
|
|
|
||
|
|
### How to run all yanglint tests that are in non-interactive mode?
|
||
|
|
|
||
|
|
In the non-interactive directory, run:
|
||
|
|
|
||
|
|
```
|
||
|
|
tclsh all.tcl
|
||
|
|
```
|
||
|
|
|
||
|
|
### How to run all unit-tests from .test file?
|
||
|
|
|
||
|
|
```
|
||
|
|
tclsh clear.test
|
||
|
|
```
|
||
|
|
|
||
|
|
or alternatively:
|
||
|
|
|
||
|
|
```
|
||
|
|
tclsh all.tcl -file clear.test
|
||
|
|
```
|
||
|
|
|
||
|
|
### How to run one unit-test?
|
||
|
|
|
||
|
|
```
|
||
|
|
tclsh clear.test -match clear_ietf_yang_library
|
||
|
|
```
|
||
|
|
|
||
|
|
or alternatively:
|
||
|
|
|
||
|
|
```
|
||
|
|
tclsh all.tcl -file clear.test -match clear_ietf_yang_library
|
||
|
|
```
|
||
|
|
|
||
|
|
### How to run unit-tests for a certain yanglint command?
|
||
|
|
|
||
|
|
Test names are assumed to consist of the command name:
|
||
|
|
|
||
|
|
```
|
||
|
|
tclsh all.tcl -match clear*
|
||
|
|
```
|
||
|
|
|
||
|
|
### How do I get more detailed information about 'expect' for a certain test?
|
||
|
|
|
||
|
|
In the interactive directory, run:
|
||
|
|
|
||
|
|
```
|
||
|
|
tclsh clear.test -match clear_ietf_yang_library -load "exp_internal 1"
|
||
|
|
```
|
||
|
|
|
||
|
|
### How do I get more detailed dialog between 'expect' and yanglint for a certain test?
|
||
|
|
|
||
|
|
In the interactive directory, run:
|
||
|
|
|
||
|
|
```
|
||
|
|
tclsh clear.test -match clear_ietf_yang_library -load "log_user 1"
|
||
|
|
```
|
||
|
|
|
||
|
|
### How do I suppress error message from tcltest?
|
||
|
|
|
||
|
|
Probably only possible to do via `-verbose ""`
|
||
|
|
|
||
|
|
### How can I also debug?
|
||
|
|
|
||
|
|
You can write commands `interact` and `interpreter` from 'Expect' package into some test.
|
||
|
|
However, the most useful are the `exp_internal` and `log_user`, which can also be written directly into the test.
|
||
|
|
See also the rlwrap tool.
|
||
|
|
You can also use other debugging methods used in tcl programming.
|
||
|
|
|
||
|
|
### Are the tests between interactive mode and non-interactive mode similar?
|
||
|
|
|
||
|
|
Sort of...
|
||
|
|
- regex \n must be changed to \r\n in the tests for interactive yanglint
|
||
|
|
|
||
|
|
### I would like to add a new "ly_" function.
|
||
|
|
|
||
|
|
Add it to the ly.tcl file.
|
||
|
|
If you need to call other subfunctions in it, add them to namespace ly::private.
|
||
|
|
|
||
|
|
### I would like to use function other than those prefixed with "ly_".
|
||
|
|
|
||
|
|
Look in the common.tcl file in the "uti" namespace,
|
||
|
|
which contains general tcl functions that can be used in both interactive and non-interactive tests.
|