teuton 3.2.1 → 3.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3516a5e7aa9c634173b9e5eb7861ff1714ee4e583da4bcad3c01ac8400831313
-  data.tar.gz: c551387224c5c47a545c4455a673d7401495b0a2ef000770010c8d0d3926079d
+  metadata.gz: 2ffb8159388474653ba97b292becba216b9dc0d1361c5669c1c6c3ce8fd5b678
+  data.tar.gz: 7215fb1ca9e5b350c7e46498323bca0f51cc0ad2dfcbfc517ac3f2175183dbbf
 SHA512:
-  metadata.gz: 320eb8621ce4b42c2f5316a2b8edb7a8a6ea01abf9fc2e42588df583bd3baa10a22b51b9389d829544a1fae82a84934f6e1c82d98624a6bd263a8cafb5db2678
-  data.tar.gz: 80cc780a54d6b2771904475f5cd89b6954b46c9cf9e04a173cc6dc0e996db13eb3bed7dd2c92b252ae8d58faedb16d1f361d4e151fb26f8baab4f812349086c1
+  metadata.gz: 53b34316e0dc1e8c7a2a8a042ef1694accb3ca89f3e9d193c8471104fd89de00c123f1f6a8ccbd8e2c1335e0446b11f6dcc328e7a6c28da4d7b4f89f26e1245a
+  data.tar.gz: 42fec6d0b1846cfcc73fef79731aa98966220705a76ed81a76ae3f4e9cc01a2eaa4f7e3b97c13a334b7bcf892d1947314b16417927024976623546ca41a88a33

data/README.md

@@ -46,18 +46,18 @@ end
 **Usage**: Run test with `teuton run TESTPATH`.
 
 ```console
-$ teuton run examples/02-target
+$ teutonx examples/02-target 
 ------------------------------------
-Started at 2025-12-01 18:14:44 +0000
+Started at 2026-10-21 17:05:49 +0100
 F.
 Finished in 0.005 seconds
 ------------------------------------
  
-CASE RESULTS
-+------+-----------+-------+-------+
-| CASE | MEMBERS   | GRADE | STATE |
-| 01   | anonymous | 33.0  | ?     |
-+------+-----------+-------+-------+
+ CASE RESULTS
+┌──────┬───────────┬───────┬───────┐
+│ CASE │ MEMBERS   │ GRADE │ STATE │
+│ 01   │ anonymous │ 33.0  │ ?     │
+└──────┴───────────┴───────┴───────┘
 ```
 
 **Output**: reports saved into `var/TESTNAME` folder.

data/docs/commands/README.md

@@ -5,13 +5,14 @@
 ```
 $ teuton
 Commands:
-  teuton [run] [OPTIONS] DIRECTORY   # Run test from directory
-  teuton check [OPTIONS] DIRECTORY   # Check test and config file content
-  teuton config [OPTIONS] DIRECTORY  # Suggest configuration or run server
-  teuton help [COMMAND]              # Describe available commands or one specific command
-  teuton new DIRECTORY               # Create skeleton for a new project
-  teuton readme DIRECTORY            # Show README extracted from test contents
-  teuton version                     # Show the program version
+  teuton [run] [OPTIONS] DIRECTORY  # Run test from directory
+  teuton check [OPTIONS] DIRECTORY  # Check test and config file content
+  teuton config DIRECTORY           # Suggest configuration.
+  teuton help [COMMAND]             # Describe available commands or one specific command
+  teuton new DIRECTORY              # Create skeleton for a new project
+  teuton readme DIRECTORY           # Show README extracted from test contents
+  teuton tree                       # Print a tree of all available commands
+  teuton version                    # Show the program version
 ```
 
 Available command functions:

data/docs/commands/check.md

@@ -27,11 +27,12 @@ Alias: `teuton c foo`, `teuton -c foo`, `teuton --check foo`
 ## Example
 
 ```
-$ teuton check examples/02-target
+$ teuton check examples/02-target 
+
+┌────────────────────────────┐
+│ GROUP: Learn about targets │
+└────────────────────────────┘
 
-+----------------------------+
-| GROUP: Learn about targets |
-+----------------------------+
 (001) target      Create user obiwan
       weight      2.0
       run         'id obiwan' on localhost
@@ -42,17 +43,18 @@ $ teuton check examples/02-target
       run         'id vader' on localhost
       expect_fail
 
-+--------------+-------+
-| DSL Stats    | Count |
-+--------------+-------+
-| Groups       | 1     |
-| Targets      | 2     |
-| Runs         | 2     |
-|  * localhost | 2     |
-+--------------+-------+
-[WARN] Configfile not found
-       .../examples/02-target/config.yaml
-[INFO] Recomended content:
+
+┌──────────────┬───────┐
+│ DSL Stats    │ Count │
+├──────────────┼───────┤
+│ Groups       │ 1     │
+│ Targets      │ 2     │
+│ Runs         │ 2     │
+│  * localhost │ 2     │
+└──────────────┴───────┘
+Warn | Configfile not found
+- File: ../examples/02-target/config.yaml
+Info | Recomended content:
 ---
 global:
 cases:

data/docs/commands/help.md

@@ -15,23 +15,33 @@ Alias: `teuton h`,`teuton -h`, `teuton --help`
 Commands:
   teuton [run] [OPTIONS] DIRECTORY   # Run test from directory
   teuton check [OPTIONS] DIRECTORY   # Check test and config file content
-  teuton config [OPTIONS] DIRECTORY  # Suggest configuration or run server
+  teuton config [OPTIONS] DIRECTORY  # Suggest configuration.
   teuton help [COMMAND]              # Describe available commands or one specific command
   teuton new DIRECTORY               # Create skeleton for a new project
   teuton readme DIRECTORY            # Show README extracted from test contents
+  teuton tree                        # Print a tree of all available commands
   teuton version                     # Show the program version
 ```
 
-**Example**: `teuton help config`
+**Example**: `teuton help check`
+
 ```
 Usage:
-  teuton config [OPTIONS] DIRECTORY
+  teuton check [OPTIONS] DIRECTORY
 
 Options:
-  [--server], [--no-server], [--skip-server]  
+  [--onlyconfig], [--no-onlyconfig], [--skip-onlyconfig]  
+  [--color], [--no-color], [--skip-color]                 
+  [--cname=CNAME]                                         
+  [--cpath=CPATH]                                         
 
 Description:
-  config DIRECTORY, "Suggest the content of the configuration file based on the test"
+  (1) teuton check PATH/TO/DIR , Check content of start.rb and config.yaml files.
 
-  config --server DIRECTORY, "Init Config Server. Students connect and help to build config file content"
-```
+  (2) teuton check PATH/TO/DIR --cname=demo , Check content of start.rb and demo.yaml files:
+
+  (3) teuton check PATH/TO/DIR --onlyconfig , Only show config file recomendations
+
+  (4) teuton check PATH/TO/DIR/foo.rb , Check content of foo.rb and foo.yaml files.
+
+  (5) teuton check PATH/TO/DIR/foo.rb --cname=demo , Check content of foo.rb and demo.yaml files.```

data/docs/devel/todo.md

@@ -1,19 +1,16 @@
 [<< back](../../README.md)
 
-# Roadmap Teuton v3.0.0 - 2026
+# Roadmap Teuton v3.3.0 - 2026
 
 # 1. Revisar
 
 * Revisar (tests): result.grep(a).grep(b)
-* "Limpiar" las funciones "deprecated"
 * Aplicar las recomendaciones del informe de seguridad de Andrés.
 * verify get(:key) and get('key') works fine!
 * Formatter: xml
-* Revisar la utilidad de action.assets al generar README.
 
 # 2. Documentacion
 
-* Nuevo repo `teuton-book`: para documentación, tutoriales en español.
 * Documentar y hacer videos. Tener foros de la comunidad o presencia en reddit o stackoverflow.... o algo parecido???
 * Snode Dockerfile with SSH server
 * **ngrok**:

data/docs/dsl/target.md

@@ -17,17 +17,3 @@ By default weight is `1.0`, but it's posible specified other values:
 ```ruby
 target "Write here your description", weight: 2.5
 ```
-
-## [DEPRECATED] Alias
-
-`goal` keyword is an alias of `target`. So it's the same:
-
-```ruby
-target "Write here your description"
-```
-
-or
-
-```ruby
-goal "Write here your description"
-```

data/docs/install/t-node.md

@@ -106,24 +106,13 @@ CMD ["/bin/bash"]
 If you want to install Teuton by your own, or there are not installation scripts for your OS, here you have information how to install all the required packages for Teuton.
 
 Manual installation:
-1. Git installation
-    * Install Git.
-    * Run `git --version` to show current version
-1. Ruby installation
-    * Install ruby.
-    * Run `ruby -v` to show current version (2.1.3p242+)
-1. Rake installation
-    * Run `gem install rake`, then
-    * `rake --version` to show current version (10.4.2+).
-1. Download this project
-    * (a) `git clone https://github.com/dvarrui/teuton.git` or
-    * (b) Download and unzip [file](https://github.com/dvarrui/teuton-panel/archive/master.zip).
-1. Move into Teuton folder
-    * Run `cd teuton`
-1. Gems installation.
-    * `rake install`, to install required gems.
-1. Only for developers
-    * Run `rake devel:debian` or
-    * `rake devel:opensuse`, install gem for developers.
-1. Final check
-    * `rake`
+
+1. Install Git. Run `git --version` to show current version
+1. Install ruby. Run `ruby -v` to show current version (3.2.8)
+1. Install Rake (`gem install rake`), then `rake --version` to show current version (13.4.2).
+1. Clone repo `git clone https://github.com/dvarrui/teuton.git` or download and unzip.
+1. Move into Teuton folder: `cd teuton`
+1. Install gems: `rake install`. 
+1. Only Debian OS: `rake devel:debian`.
+1. Obly OpenSUSE OS: `rake devel:opensuse`.
+1. Final check: `rake`

data/docs/learn/02-target.md

@@ -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 │ 33.0  │ ?     │
+└──────┴───────────┴───────┴───────┘
 ```
 
 Report files are created into `var/02-target/` folder:
@@ -85,44 +85,46 @@ 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                        |
-+--------------+---------------------------+
+
+ 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
+ ▶ Learn about targets
+   ✖ 01 (0.0/2.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
+┌──────────────┬───────────────────────────┐
+│ unique_fault │ 0                         │
+│ case_id      │ 01                        │
+│ start_time   │ 2026-10-21 21:32:24 +0100 │
+│ finish_time  │ 2026-10-21 21:32:24 +0100 │
+│ duration     │ 0.004153712               │
+│ max_weight   │ 3.0                       │
+│ good_weight  │ 1.0                       │
+│ fail_weight  │ 2.0                       │
+│ fail_counter │ 1                         │
+│ grade        │ 33                        │
+└──────────────┴───────────────────────────┘
 ```

data/docs/learn/03-remote_hosts.md

@@ -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

@@ -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