teuton 3.2.0 → 3.3.0

data/docs/learn/04-config.md

@@ -35,14 +35,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 +58,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.004 (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-21 21:36:41 +0100 │
+│ finish_time  │ 2026-10-21 21:36:41 +0100 │
+│ duration     │ 0.004390772               │
+│ max_weight   │ 1.0                       │
+│ good_weight  │ 1.0                       │
+│ fail_weight  │ 0                         │
+│ fail_counter │ 0                         │
+│ grade        │ 100                       │
+└──────────────┴───────────────────────────┘
 ```
 
 ## Using differents configuration files
@@ -109,38 +108,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/06-cmd_check.md

@@ -8,43 +8,45 @@
 ## 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

@@ -26,9 +26,9 @@ end
 
 Output:
 ```
-+----------------------------+
-| GROUP: Using file: network |
-+----------------------------+
+┌────────────────────────────┐
+│ GROUP: Using file: network │
+└────────────────────────────┘
 (002) target      Update computer name with get(hostname)
       weight      1.0
       run         'hostname' on host1

data/docs/learn/08-unique_values.md

@@ -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/10-debug.md

@@ -45,3 +45,39 @@ 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-21 21:50:52 +0100
+
+******************** [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=2.22 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 = 2.220/2.220/2.220/0.000 ms
+*********************************************************
+.
+******************** [DEBUG] count=1 ********************
+ 0: 1
+*********************************************************
+FFFFFF
+Finished in 35.898 seconds
+------------------------------------
+ 
+ CASE RESULTS
+┌──────┬───────────┬───────┬───────┐
+│ CASE │ MEMBERS   │ GRADE │ STATE │
+│ 01   │ student_1 │ 14.0  │ ?     │
+└──────┴───────────┴───────┴───────┘
+
+ CONN ERRORS
+┌──────┬───────────┬─────────┬───────┐
+│ CASE │ MEMBERS   │ HOST    │ ERROR │
+│ 01   │ student_1 │ windows │ error │
+└──────┴───────────┴─────────┴───────┘
+```

data/docs/learn/13-feedback.md

@@ -37,13 +37,14 @@ Executing `teuton run examples/13-feedback`, we get this output:
 
 ```
 GROUPS
-- Hide feedback messages from output
-    01 (1.0/1.0)
-        Description : Service SSH disabled
-        Command     : *********************
-        Output      : *********
-        Duration    : 0.011 (local)
-        Alterations : **********************
-        Expected    : **************
-        Result      : ********
+ ▶ Hide feedback messages from output
+   ✔ 01 (1.0/1.0)   ┌──
+        Description │ Service SSH disabled
+        Command     │ *********************
+        Output      │ *********
+        Duration    │ 0.008 (local)
+        Alterations │ **********************
+        Expected    │ **************
+        Result      │ ********
+                    └──
 ```

data/docs/learn/15-readme.md

@@ -43,8 +43,8 @@ Content of `example/15-readme/README.md` file.
 ---
 
 ```
-Date   : 2025-11-12 22:11:47 +0000
-Teuton : 2.10.7
+Date   : 2026-10-21 21:54:49 +0100
+Teuton : 3.2.1
 ```
 
 # Test: 15-readme

data/docs/learn/16-include.md

@@ -59,11 +59,11 @@ Config files into `moreconfigfiles` folder:
 If we execute the test we will see that 3 cases are processed. Which are defined in the files `file01.yaml`, `02/file02.yaml` and `file03.yml`.
 
 ```
-CASE RESULTS
-+------+---------+-------+-------+
-| CASE | MEMBERS | GRADE | STATE |
-| 01   | file02  | 0.0   | ?     |
-| 02   | file01  | 100.0 | ✔     |
-| 03   | file03  | 0.0   | ?     |
-+------+---------+-------+-------+
+ CASE RESULTS
+┌──────┬────────────┬───────┬───────┐
+│ CASE │ MEMBERS    │ GRADE │ STATE │
+│ 01   │ student_02 │ 0.0   │ ?     │
+│ 02   │ student_01 │ 100.0 │ ✔     │
+│ 03   │ student_03 │ 0.0   │ ?     │
+└──────┴────────────┴───────┴───────┘
 ```

data/docs/learn/18-log.md

@@ -53,49 +53,50 @@ end
 Content of `var/18-log/case-01.txt` file.
 
 ```txt
-CONFIGURATION
-+----------------+-----------------------------------+
-| tt_config_path | examples/18-log/config.yaml       |
-| tt_members     | TOCHANGE                          |
-| tt_script_path | examples/18-log/start.rb          |
-| tt_sequence    | false                             |
-| tt_skip        | false                             |
-| values1        | ["A1", "B1", "C1"]                |
-| values2        | {:p1=>"A2", :p2=>"B2", :p3=>"C2"} |
-+----------------+-----------------------------------+
+❯ cat var/18-log/case-01.txt 
+ CONFIGURATION
+┌────────────────┬───────────────────────────────────┐
+│ tt_config_path │ examples/18-log/config.yaml       │
+│ tt_members     │ TOCHANGE                          │
+│ tt_script_path │ examples/18-log/start.rb          │
+│ tt_sequence    │ false                             │
+│ tt_skip        │ false                             │
+│ values1        │ ["A1", "B1", "C1"]                │
+│ values2        │ {:p1=>"A2", :p2=>"B2", :p3=>"C2"} │
+└────────────────┴───────────────────────────────────┘
 
 LOGS
-    [22:35:04]  INFO: Using log messages.
-    [22:35:04]  INFO: uid=1000(david) gid=1000(david) grupos=1000(david),478(wheel),464(vboxusers),108(libvirt),107(qemu),462(vagrant),460(docker),452(ollama)
-    [22:35:04] ERROR: Problem detected!
-    [22:35:04] WARN!: This is a warning
-    [22:35:04]  INFO: Hi, there!
-    [22:35:04]  INFO: -------------
-    [22:35:04]  INFO: Array values : ["A1", "B1", "C1"]
-    [22:35:04]  INFO: Hash values  : {:p1=>"A2", :p2=>"B2", :p3=>"C2"}
-
-GROUPS
-- Learning about log messages
-    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.005 (local)
-        Alterations : find(david) & count
-        Expected    : Greater than 0
-        Result      : 1
-
-RESULTS
-+--------------+---------------------------+
-| unique_fault | 0                         |
-| case_id      | 01                        |
-| start_time   | 2026-10-12 22:35:04 +0100 |
-| finish_time  | 2026-10-12 22:35:04 +0100 |
-| duration     | 0.004786563               |
-| max_weight   | 1.0                       |
-| good_weight  | 1.0                       |
-| fail_weight  | 0                         |
-| fail_counter | 0                         |
-| grade        | 100                       |
-+--------------+---------------------------+
+   [22:00:21]  INFO| Using log messages.
+   [22:00:21]  INFO| uid=1000(david) gid=1000(david) grupos=1000(david),478(wheel),464(vboxusers),108(libvirt),107(qemu),462(vagrant),460(docker),452(ollama)
+   [22:00:21] ERROR| Problem detected!
+   [22:00:21]  WARN| This is a warning
+   [22:00:21]  INFO| Hi, there!
+   [22:00:21]  INFO| -------------
+   [22:00:21]  INFO| Array values : ["A1", "B1", "C1"]
+   [22:00:21]  INFO| Hash values  : {:p1=>"A2", :p2=>"B2", :p3=>"C2"}
+
+ GROUPS
+ ▶ Learning about log messages
+   ✔ 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.005 (local)
+        Alterations │ find(david) & count
+        Expected    │ Greater than 0
+        Result      │ 1
+                    └──
+ RESULTS
+┌──────────────┬───────────────────────────┐
+│ unique_fault │ 0                         │
+│ case_id      │ 01                        │
+│ start_time   │ 2026-10-21 21:57:57 +0100 │
+│ finish_time  │ 2026-10-21 21:57:57 +0100 │
+│ duration     │ 0.005315073               │
+│ max_weight   │ 1.0                       │
+│ good_weight  │ 1.0                       │
+│ fail_weight  │ 0                         │
+│ fail_counter │ 0                         │
+│ grade        │ 100                       │
+└──────────────┴───────────────────────────┘
 ```

data/docs/learn/23-test-code.md

@@ -43,22 +43,25 @@ Define config params:
 global:
   folder: examples/23-test-code/code
 cases:
-- tt_members: student_1
+- tt_members: student_1_python
   filename: math_1.py
-- tt_members: student_2
+- tt_members: student_2_python
   filename: math_2.py
+- tt_members: student_3_ruby
+  filename: math_3.rb
 ```
 
 * Copy students files into `code` subfolder.
 * Now run Teuton test:
 
 ```
-$ teuton examples/23-test-code
-
-CASE RESULTS
-+------+-----------+-------+-------+
-| CASE | MEMBERS   | GRADE | STATE |
-| 01   | student_1 | 100.0 | ✔     |
-| 02   | student_2 | 100.0 | ✔     |
-+------+-----------+-------+-------+
+$ teuton examples/23-test-code 
+ 
+ CASE RESULTS
+┌──────┬──────────────────┬───────┬───────┐
+│ CASE │ MEMBERS          │ GRADE │ STATE │
+│ 01   │ student_1_python │ 100.0 │ ✔     │
+│ 02   │ student_2_python │ 100.0 │ ✔     │
+│ 03   │ student_3_ruby   │ 100.0 │ ✔     │
+└──────┴──────────────────┴───────┴───────┘
 ```

data/docs/learn/24-test-sql.md

@@ -62,9 +62,9 @@ cases:
 ```
 $ teuton examples/24-test-sql                                   
 
-CASE RESULTS
-+------+-----------+-------+-------+
-| CASE | MEMBERS   | GRADE | STATE |
-| 01   | student_1 | 100.0 | ✔     |
-+------+-----------+-------+-------+
+ CASE RESULTS
+┌──────┬────────────────┬───────┬───────┐
+│ CASE │ MEMBERS        │ GRADE │ STATE │
+│ 01   │ student_1_name │ 100.0 │ ✔     │
+└──────┴────────────────┴───────┴───────┘
 ```

data/docs/learn/26-expect_sequence.md

@@ -8,7 +8,7 @@ Evaluate the occurrence of a certain sequence that takes place in different line
 
 ## Description
 
-In the classic target/run/expect, the expect statement works by locating lines from the output of the previous command that meet certain criteria.
+In the classic "target/run/expect", the expect statement works by locating lines from the output of the previous command that meet certain criteria.
 
 We can even (using regular expressions) detect if there is any line in the output where a certain sequence appears.
 

data/docs/learn/27-run_script.md

@@ -90,8 +90,11 @@ CONN ERRORS
 +------+---------+-------+------------------+
 ```
 
-Meaning of progress symbols:
-* `.`: check ok
-* `F`: check fail
-* `!`: connection fail
-* `u`: upload ok
+**Meaning of progress symbols**
+
+| Symbol | Description     |
+| ------ | --------------- |
+| `.`    | check ok        |
+| `F`    | check fail      |
+| `!`    | connection fail |
+| `u`    | upload ok       |