teuton 3.2.1 → 3.4.0

data/docs/learn/02-target.md

@@ -1,4 +1,4 @@
-[<< back](README.md)
+[<<back](../../README.md)
 
 # Target
 
@@ -62,13 +62,13 @@ end
 Execute this command to run the test:
 
 ```
-$ teuton run examples/02-target
-
-CASE RESULTS
-+------+-----------+-------+-------+
-| CASE | MEMBERS   | GRADE | STATE |
-| 01   | anonymous | 100.0 | ✔     |
-+------+-----------+-------+-------+
+$ teuton examples/02-target       
+ 
+ ☰ CASE RESULTS
+┌──────┬───────────┬───────┬───────┐
+│ CASE │ MEMBERS   │ GRADE │ STATE │
+│ 01   │ anonymous │ 67.0  │       │
+└──────┴───────────┴───────┴───────┘
 ```
 
 Report files are created into `var/02-target/` folder:
@@ -84,45 +84,47 @@ var
 Let's see one report:
 
 ```
-$ cat var/02-target/case-01.txt
-CONFIGURATION
-+-------------+-----------+
-| tt_members  | anonymous |
-| tt_sequence | false     |
-| tt_skip     | false     |
-| tt_testname | 02-target |
-+-------------+-----------+
-
-GROUPS
-- Learn about targets
-    01 (0.0/1.0)
-        Description : Create user obiwan
-        Command     : id obiwan
-        Output      : id: «obiwan»: no existe ese usuario
-        Duration    : 0.002 (local)
-        Alterations : find(uid=) & find((obiwan)) & find(gid=) & count
-        Expected    : Greater than 0
-        Result      : 0
-    02 (1.0/1.0)
-        Description : Delete user vader
-        Command     : id vader
-        Output      : id: «vader»: no existe ese usuario
-        Duration    : 0.002 (local)
-        Alterations : Read exit code
-        Expected    : Greater than 0
-        Result      : 1
-
-RESULTS
-+--------------+---------------------------+
-| case_id      | 01                        |
-| start_time   | 2023-06-16 08:42:13 +0100 |
-| finish_time  | 2023-06-16 08:42:13 +0100 |
-| duration     | 0.004527443               |
-| unique_fault | 0                         |
-| max_weight   | 2.0                       |
-| good_weight  | 1.0                       |
-| fail_weight  | 1.0                       |
-| fail_counter | 1                         |
-| grade        | 50                        |
-+--------------+---------------------------+
-```
+$ cat var/02-target/case-01.txt 
+
+ ⚒ CONFIGURATION
+┌────────────────┬────────────────────────────────┐
+│ tt_config_path │ examples/02-target/config.yaml │
+│ tt_members     │ anonymous                      │
+│ tt_script_path │ examples/02-target/start.rb    │
+│ tt_sequence    │ false                          │
+│ tt_skip        │ false                          │
+└────────────────┴────────────────────────────────┘
+
+ ☰ GROUPS
+ ▶ Practicing targets
+   ✖ 01 (0.0/1.0)   ┌──
+        Description │ Create user obiwan
+        Command     │ id obiwan
+        Output      │ id: «obiwan»: no existe ese usuario
+        Duration    │ 0.002 (local)
+        Alterations │ find(uid=) & find((obiwan)) & find(gid=) & count
+        Expected    │ Greater than 0
+        Result      │ 0
+   ✔ 02 (2.0/2.0)   ├──
+        Description │ Delete user vader
+        Command     │ id vader
+        Output      │ id: «vader»: no existe ese usuario
+        Duration    │ 0.002 (local)
+        Alterations │ Read exit code
+        Expected    │ Greater than 0
+        Result      │ 1
+                    └──
+ 🗹 RESULTS
+┌──────────────┬───────────────────────────┐
+│ unique_fault │ 0                         │
+│ case_id      │ 01                        │
+│ start_time   │ 2026-10-26 12:20:01 +0000 │
+│ finish_time  │ 2026-10-26 12:20:01 +0000 │
+│ duration     │ 0.003806668               │
+│ max_weight   │ 3.0                       │
+│ good_weight  │ 2.0                       │
+│ fail_weight  │ 1.0                       │
+│ fail_counter │ 1                         │
+│ grade        │ 67                        │
+└──────────────┴───────────────────────────┘
+```

data/docs/learn/03-remote_hosts.md

@@ -1,4 +1,4 @@
-[<< back](README.md)
+[<<back](../../README.md)
 
 # Remote hosts
 
@@ -55,22 +55,21 @@ end
 Execution:
 
 ```
-$ teuton run examples/03-remote_hosts
+$ teutonx examples/03-remote_hosts 
  
-CASE RESULTS
-+------+-----------+-------+-------+
-| CASE | MEMBERS   | GRADE | STATE |
-| 01   | student_1 | 0.0   | ?     |
-| -    | -         | 0.0   | S     |
-| 03   | student_3 | 100.0 | ✔     |
-+------+-----------+-------+-------+
-
-CONN ERRORS
-+------+-----------+-------+------------------+
-| CASE | MEMBERS   | HOST  | ERROR            |
-| 01   | student_1 | host1 | host_unreachable |
-+------+-----------+-------+------------------+
-
+ CASE RESULTS
+┌──────┬───────────┬───────┬───────┐
+│ CASE │ MEMBERS   │ GRADE │ STATE │
+│ 01   │ student_1 │ 0.0   │ ?     │
+│ -    │ -         │ 0.0   │ S     │
+│ 03   │ student_3 │ 100.0 │ ✔     │
+└──────┴───────────┴───────┴───────┘
+
+ CONN ERRORS
+┌──────┬───────────┬───────┬──────────────────┐
+│ CASE │ MEMBERS   │ HOST  │ ERROR            │
+│ 01   │ student_1 │ host1 │ host_unreachable │
+└──────┴───────────┴───────┴──────────────────┘
 ```
 
 Notice that:

data/docs/learn/04-config.md

@@ -1,4 +1,4 @@
-[<< back](README.md)
+[<<back](../../README.md)
 
 # config
 
@@ -7,6 +7,8 @@ Our tests use config file to write dinamic data into separated file.
 By default, `config.yaml` is our config file. Example:
 
 ```yaml
+# File: config.yaml
+# Desc: configuration file
 global:
   tt_output_dir: var/04-config/default
 cases:
@@ -35,14 +37,14 @@ end
 ## Example
 
 ```
-$ teuton run examples/04-config
-
-CASE RESULTS
-+------+-----------+-------+-------+
-| CASE | MEMBERS   | GRADE | STATE |
-| 01   | student_1 | 100.0 | ✔     |
-| 02   | student_2 | 0.0   | ?     |
-+------+-----------+-------+-------+
+$ teuton examples/04-config 
+  
+ ☰ CASE RESULTS
+┌──────┬───────────┬───────┬───────┐
+│ CASE │ MEMBERS   │ GRADE │ STATE │
+│ 01   │ student_1 │ 100.0 │ ✔     │
+│ 02   │ student_2 │ 0.0   │ ?     │
+└──────┴───────────┴───────┴───────┘
 ```
 
 Reports:
@@ -58,44 +60,43 @@ var/04-config/default
 Let's see case 01 report.
 
 ```
-$ more var/04-config/default/case-01.txt
-
-CONFIGURATION
-+----------------+--------------------------------+
-| tt_config_path | examples/04-config/config.yaml |
-| tt_members     | student_1                      |
-| tt_output_dir  | var/04-config/default          |
-| tt_script_path | examples/04-config/start.rb    |
-| tt_sequence    | false                          |
-| tt_skip        | false                          |
-| username       | david                          |
-+----------------+--------------------------------+
-
-
-GROUPS
-- Reading params from config file
-    01 (1.0/1.0)
-        Description : Create user david
-        Command     : id david
-        Output      : uid=1000(david) gid=1000(david) grupos=1000(david),478(wheel),...
-        Duration    : 0.005 (local)
-        Alterations : find(uid=) & find((david)) & find(gid=) & count
-        Expected    : Greater than 0
-        Result      : 1
-
-RESULTS
-+--------------+---------------------------+
-| unique_fault | 0                         |
-| case_id      | 01                        |
-| start_time   | 2026-10-10 17:05:22 +0100 |
-| finish_time  | 2026-10-10 17:05:22 +0100 |
-| duration     | 0.005137538               |
-| max_weight   | 1.0                       |
-| good_weight  | 1.0                       |
-| fail_weight  | 0                         |
-| fail_counter | 0                         |
-| grade        | 100                       |
-+--------------+---------------------------+
+$ cat var/04-config/default/case-01.txt
+
+ ⚒ CONFIGURATION
+┌────────────────┬────────────────────────────────┐
+│ tt_config_path │ examples/04-config/config.yaml │
+│ tt_members     │ student_1                      │
+│ tt_output_dir  │ var/04-config/default          │
+│ tt_script_path │ examples/04-config/start.rb    │
+│ tt_sequence    │ false                          │
+│ tt_skip        │ false                          │
+│ username       │ david                          │
+└────────────────┴────────────────────────────────┘
+
+ ☰ GROUPS
+ ▶ Reading params from config file
+   ✔ 01 (1.0/1.0)   ┌──
+        Description │ Create user david
+        Command     │ id david
+        Output      │ uid=1000(david) gid=1000(david) grupos=1000(david),478(wheel),464(vboxusers),108(libvirt),107(qemu),462(vagrant),460(docker),452(ollama)
+        Duration    │ 0.012 (local)
+        Alterations │ find(uid=) & find((david)) & find(gid=) & count
+        Expected    │ Greater than 0
+        Result      │ 1
+                    └──
+ 🗹 RESULTS
+┌──────────────┬───────────────────────────┐
+│ unique_fault │ 0                         │
+│ case_id      │ 01                        │
+│ start_time   │ 2026-10-26 12:22:36 +0000 │
+│ finish_time  │ 2026-10-26 12:22:36 +0000 │
+│ duration     │ 0.012505538               │
+│ max_weight   │ 1.0                       │
+│ good_weight  │ 1.0                       │
+│ fail_weight  │ 0                         │
+│ fail_counter │ 0                         │
+│ grade        │ 100                       │
+└──────────────┴───────────────────────────┘
 ```
 
 ## Using differents configuration files
@@ -109,38 +110,38 @@ Execute the same test but using diferents config files. Config files available:
 **Example 1**: Run test usign default config file (`config.yaml`). Output files saved in `tt_output_dir: var/04-config/defautl`.
 
 ```
-$ teuton run examples/04-config
-
-CASE RESULTS
-+------+-----------+-------+-------+
-| CASE | MEMBERS   | GRADE | STATE |
-| 01   | student_1 | 100.0 | ✔     |
-| 02   | student_2 | 0.0   | ?     |
-+------+-----------+-------+-------+
+$ teuton examples/04-config         
+ 
+ ☰ CASE RESULTS
+┌──────┬───────────┬───────┬───────┐
+│ CASE │ MEMBERS   │ GRADE │ STATE │
+│ 01   │ student_1 │ 100.0 │ ✔     │
+│ 02   │ student_2 │ 0.0   │ ?     │
+└──────┴───────────┴───────┴───────┘
 ```
 
 **Example 2**: Run test using `example/04-config/starwars.yaml` config file. Output files saved in `tt_output_dir: var/04-config/starwars`.
 
 ```
 $ teuton run --cname=starwars examples/04-config
-
-CASE RESULTS
-+------+------------+-------+-------+
-| CASE | MEMBERS    | GRADE | STATE |
-| 01   | Yoda       | 0.0   | ?     |
-| 02   | Darth Maul | 0.0   | ?     |
-+------+------------+-------+-------+
+ 
+ ☰ CASE RESULTS
+┌──────┬────────────┬───────┬───────┐
+│ CASE │ MEMBERS    │ GRADE │ STATE │
+│ 01   │ Yoda       │ 0.0   │ ?     │
+│ 02   │ Darth Maul │ 0.0   │ ?     │
+└──────┴────────────┴───────┴───────┘
 ```
 
 **Example 3**: Run test using `example/04-config/rock.yaml` config file. Output files saved in `tt_output_dir: var/04-config/rock`.
 
 ```
 $ teuton run --cpath=examples/04-config/rock.yaml examples/04-config
-
-CASE RESULTS
-+------+------------+-------+-------+
-| CASE | MEMBERS    | GRADE | STATE |
-| 01   | AC/DC band | 0.0   | ?     |
-| 02   | Muse band  | 0.0   | ?     |
-+------+------------+-------+-------+
+ 
+ ☰ CASE RESULTS
+┌──────┬────────────┬───────┬───────┐
+│ CASE │ MEMBERS    │ GRADE │ STATE │
+│ 01   │ AC/DC band │ 0.0   │ ?     │
+│ 02   │ Muse band  │ 0.0   │ ?     │
+└──────┴────────────┴───────┴───────┘
 ```

data/docs/learn/05-use.md

@@ -1,4 +1,4 @@
-[<< back](README.md)
+[<<back](../../README.md)
 
 # use
 

data/docs/learn/06-cmd_check.md

@@ -1,50 +1,52 @@
 
-[<< back](README.md)
+[<<back](../../README.md)
 
 # check test
 
-`teuton check DIRPATH` is a command function that checks syntax and show statistics.
+`teuton check DIRPATH` is a command function that checks syntax and show statistics. It is very useful for locating syntax errors in test files.
 
 ## Example
 
 ```
-$ teuton check examples/05-use     
+$ teuton check examples/05-use 
 
-+--------------------------+
-| GROUP: Using file: users |
-+--------------------------+
+┌─────────────────────────┐
+│ USE: external libraries │
+└─────────────────────────┘
+      1. examples/05-use/lib/users.rb
+      2. examples/05-use/lib/network.rb
+
+┌──────────────────────────┐
+│ GROUP: Using file: users │
+└──────────────────────────┘
 (001) target      Create user get(username)
       weight      1.0
       run         'id get(username)' on host1
       expect      ["uid=", "(get(username))", "gid="] (Array)
 
-+----------------------------+
-| GROUP: Using file: network |
-+----------------------------+
+┌────────────────────────────┐
+│ GROUP: Using file: network │
+└────────────────────────────┘
 (002) target      Update computer name with get(hostname)
       weight      1.0
       run         'hostname' on host1
       expect_one  get(hostname) (String)
 
-(003) target      Ensure DNS Server is working
+(003) target      Ensure DNS is properly configured
       weight      1.0
       run         'host www.google.es' on host1
       expect      www.google.es has address  (String)
 
-+-------------+-------+
-| DSL Stats   | Count |
-+-------------+-------+
-| Uses        | 2     |
-| Groups      | 2     |
-| Targets     | 3     |
-| Runs        | 3     |
-|  * host1    | 3     |
-| Uniques     | 0     |
-| Logs        | 0     |
-|             |       |
-| Gets        | 5     |
-|  * username | 3     |
-|  * hostname | 2     |
-| Sets        | 0     |
-+-------------+-------+
+┌─────────────┬───────┐
+│ DSL Stats   │ Count │
+├─────────────┼───────┤
+│ Uses        │ 2     │
+│ Groups      │ 2     │
+│ Targets     │ 3     │
+│ Runs        │ 3     │
+│  * host1    │ 3     │
+│ Gets        │ 5     │
+│  * username │ 3     │
+│  * hostname │ 2     │
+└─────────────┴───────┘
 ```

data/docs/learn/07-target_weight.md

@@ -1,4 +1,4 @@
-[<< back](README.md)
+[<<back](../../README.md)
 
 # Target weight
 
@@ -24,11 +24,12 @@ group "Using file: network" do
 end
 ```
 
-Output:
 ```
-+----------------------------+
-| GROUP: Using file: network |
-+----------------------------+
+$ teuton check example/07-target-weight
+...
+┌────────────────────────────┐
+│ GROUP: Using file: network │
+└────────────────────────────┘
 (002) target      Update computer name with get(hostname)
       weight      1.0
       run         'hostname' on host1
@@ -38,4 +39,5 @@ Output:
       weight      2.0
       run         'host www.google.es' on host1
       expect      www.google.es has address  (String)
+...
 ```

data/docs/learn/08-unique_values.md

@@ -1,4 +1,4 @@
-[<< back](README.md)
+[<<back](../../README.md)
 
 # Unique value
 
@@ -22,19 +22,26 @@ end
 Cheking test:
 
 ```
-$ teuton check examples/08-unique_values
+$ teuton check examples/08-unique_values 
 
-+--------------------------+
-| GROUP: Using file: users |
-+--------------------------+
+┌─────────────────────────┐
+│ USE: external libraries │
+└─────────────────────────┘
+      1. examples/08-unique_values/lib/users.rb
+      2. examples/08-unique_values/lib/network.rb
+      3. examples/08-unique_values/lib/unique.rb
+
+┌──────────────────────────┐
+│ GROUP: Using file: users │
+└──────────────────────────┘
 (001) target      Create user get(username)
       weight      1.0
       run         'id get(username)' on host1
       expect      get(username) (String)
 
-+----------------------------+
-| GROUP: Using file: network |
-+----------------------------+
+┌────────────────────────────┐
+│ GROUP: Using file: network │
+└────────────────────────────┘
 (002) target      Update computer name with get(hostname)
       weight      1.0
       run         'hostname' on host1
@@ -45,28 +52,23 @@ $ teuton check examples/08-unique_values
       run         'host www.google.es' on host1
       expect      www.google.es has address  (String)
 
-+-------------------------------+
-| GROUP: Unique value: hostname |
-+-------------------------------+
+┌───────────────────────────────┐
+│ GROUP: Unique value: hostname │
+└───────────────────────────────┘
       run         'hostname -f' on host1
-    ! Unique      value for <Host name>
+      unique      value for <Host name>
 
-+-------------+-------+
-| DSL Stats   | Count |
-+-------------+-------+
-| Groups      | 3     |
-| Targets     | 3     |
-| Runs        | 4     |
-|  * host1    | 4     |
-| Uniques     | 1     |
-| Logs        | 1     |
-|             |       |
-| Gets        | 5     |
-|  * username | 3     |
-|  * hostname | 2     |
-| Sets        | 0     |
-+-------------+-------+
-+----------------------+
-| Revising CONFIG file |
-+----------------------+
+┌─────────────┬───────┐
+│ DSL Stats   │ Count │
+├─────────────┼───────┤
+│ Uses        │ 3     │
+│ Groups      │ 3     │
+│ Targets     │ 3     │
+│ Runs        │ 4     │
+│  * host1    │ 4     │
+│ Uniques     │ 1     │
+│ Gets        │ 5     │
+│  * username │ 3     │
+│  * hostname │ 2     │
+└─────────────┴───────┘
 ```

data/docs/learn/09-send.md

@@ -1,6 +1,6 @@
-[<< back](README.md)
+[<<back](../../README.md)
 
-# Send
+# send
 
 `send` is a keyword used to copy the output report into remote host.
 

data/docs/learn/10-debug.md

@@ -1,4 +1,4 @@
-[<< back](README.md)
+[<<back](../../README.md)
 
 # debug
 
@@ -45,3 +45,40 @@ end
 ```
 
 `result.debug` it's usefull when you are verifying command output captured by Teuton.
+
+## Output example
+
+```
+$ teuton examples/10-debug 
+
+------------------------------------
+Started at 2026-10-26 16:30:56 +0000
+
+******************** [DEBUG] count=6 ********************
+ 0: PING 192.168.1.1 (192.168.1.1) 56(84) bytes de datos.
+ 1: 64 bytes desde 192.168.1.1: icmp_seq=1 ttl=64 tiempo=5.11 ms
+ 2: 
+ 3: --- 192.168.1.1 estadísticas ping ---
+ 4: 1 paquetes transmitidos, 1 recibidos, 0% packet loss, time 0ms
+ 5: rtt min/avg/max/mdev = 5.106/5.106/5.106/0.000 ms
+*********************************************************
+.
+******************** [DEBUG] count=1 ********************
+ 0: 1
+*********************************************************
+.FFFFF
+Finished in 1.431 seconds
+------------------------------------
+ 
+ ☰ CASE RESULTS
+┌──────┬───────────┬───────┬───────┐
+│ CASE │ MEMBERS   │ GRADE │ STATE │
+│ 01   │ student_1 │ 29.0  │ ?     │
+└──────┴───────────┴───────┴───────┘
+
+ 🗲 CONN ERRORS
+┌──────┬───────────┬─────────┬───────┐
+│ CASE │ MEMBERS   │ HOST    │ ERROR │
+│ 01   │ student_1 │ windows │ error │
+└──────┴───────────┴─────────┴───────┘
+```

data/docs/learn/11-export.md

@@ -1,4 +1,4 @@
-[<< back](README.md)
+[<<back](../../README.md)
 
 # export
 

data/docs/learn/12-preserve.md

@@ -1,4 +1,4 @@
-[<< back](README.md)
+[<<back](../../README.md)
 
 # preserve
 
@@ -31,11 +31,11 @@ Example, executing `teuton run example/12-preserve` twice:
 ```
 var
 └── 12-preserve
-    ├── 20200519-113035
+    ├── 20200519-163035
     │   ├── case-01.txt
     │   ├── moodle.csv
     │   └── resume.txt
-    ├── 20200519-123039
+    ├── 20200519-173039
     │   ├── case-01.txt
     │   ├── moodle.csv
     │   └── resume.txt
@@ -44,4 +44,4 @@ var
     └── resume.txt
 ```
 
-The first time test was launched at 11:30, and second at 12:30 the same day.
+The first time test was launched at 16:30, and second at 17:30 the same day.