teuton 3.2.1 → 3.3.0

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       |

data/lib/teuton/case/{action.rb → action/action.rb}

@@ -1,30 +1,38 @@
 class Case
   class Action
     attr_reader :id
-    attr_accessor :groupname, :description, :weight, :asset,
-      :command, :encoding, :host, :exec, :conn_type, :duration,
-      :result, :output, :alterations, :expected, :check
+    attr_accessor :groupname, :description, :weight,
+      :command, :encoding, :host, :exec,
+      :conn_type, :duration,
+      :result, :output,
+      :alterations, :expected, :check
+    attr_writer :score
 
-    def initialize
-      @id = 0
+    def initialize(id = 1)
+      @id = id
       @groupname = nil
       @description = "No description!"
       @weight = 1.0
+      @check = false
+      @score = nil
     end
 
-    def next
-      @id += 1
-      self
+    def score
+      return @score unless @score.nil?
+      return 0.0 if @check == false
+
+      @weight
     end
 
     def to_h
       {
         id: id,
-        groupname: groupname, description: description, weight: weight, asset: asset,
+        groupname: groupname, description: description, weight: weight,
         command: command, encoding: encoding, host: host, exec: exec,
         conn_type: conn_type, duration: duration,
         result: result, output: output,
-        alterations: alterations, expected: expected, check: check
+        alterations: alterations, expected: expected, check: check,
+        score: score
       }
     end
   end

data/lib/teuton/case/action/manager.rb

@@ -0,0 +1,63 @@
+require_relative "action"
+
+class Case
+  class ActionManager
+    OBJECTS = %i[last_target every_target all_targets].freeze
+    CONDITIONS = %i[failed is_ok].freeze
+    ACTIONS = %i[scores_to_zero stop log].freeze
+
+    attr_reader :actions, :events, :current_action
+
+    def initialize
+      @current_action = nil
+      @actions = []
+      @events = {runonce: [], repeat: []}
+      @stopped = false
+    end
+
+    def add_event(...)
+    end
+
+    def check_event(...)
+    end
+
+    def last_action
+      @actions.last
+    end
+
+    def next_action
+      if @current_action.nil?
+        @current_action = Action.new(1)
+        return @current_action
+      end
+
+      @actions << @current_action
+      @current_action = Action.new(last_action.id + 1)
+      @current_action.groupname = last_action.groupname
+      @current_action.description = last_action.description
+      @current_action
+    end
+
+    def stopped?
+      @stopped
+    end
+
+    def scores_to_zero
+      @action.each { |action| action.score = 0 }
+    end
+
+    def stop
+      @stop_test = true
+    end
+
+    def to_h
+      @actions.map { _1.to_h }
+    end
+
+    def trigger_events!
+      @events[:repeat].each do |event|
+        # TODO: Do something
+      end
+    end
+  end
+end

data/lib/teuton/case/case.rb

@@ -4,7 +4,8 @@ require_relative "../utils/project"
 require_relative "../utils/verbose"
 require_relative "../report/report"
 require_relative "dsl/all"
-require_relative "action"
+# require_relative "action/action"
+require_relative "action/manager"
 require_relative "config"
 require_relative "close"
 # require_relative "builtin/main"
@@ -16,12 +17,11 @@ class Case
   include DSL
   include Verbose
 
-  # Updated by ExecuteManager
+  # INFO: Used by ExecuteManager
   attr_accessor :action, :result, :sessions, :conn_status
-  # Readed by ExecuteManager
-  attr_reader :id, :config, :uniques, :skip
+  attr_reader :id, :config, :uniques, :skip, :action_manager
 
-  @current_case_id = "00" # First case ID value
+  @current_case_id = Project.value[:base_case_id]
 
   def self.next_id
     @current_case_id = @current_case_id.next
@@ -32,12 +32,9 @@ class Case
       local: config,
       global: Project.value[:global]
     )
-    @groups = Project.value[:groups]
     @id = Case.next_id
-
-    # Define Case Report
+    @groups = Project.value[:groups]
     @report = Report.new(@id)
-    @report.output_dir = Project.value[:output_dir]
 
     # Default configuration
     @skip = false
@@ -46,13 +43,13 @@ class Case
       @skip = true
       @skip = false if Project.value[:options]["case"].include? @id.to_i
     end
-    @verbose = Project.value[:verbose]
-
     @tempdir = File.join(Project.value[:output_dir], "tmp", @id.to_s)
+    @verbose = Project.value[:verbose]
 
     @unique_values = {}
     @result = Result.new
-    @action = Action.new
+    @action_manager = ActionManager.new
+    @action = @action_manager.next_action
     @uniques = []
     @sessions = {} # Store opened sessions for this case
     @conn_status = {}
@@ -65,7 +62,6 @@ class Case
   end
 
   def filename
-    # called from: close_main_report
     @report.filename
   end
 
@@ -75,6 +71,10 @@ class Case
     @report.tail[:grade]
   end
 
+  def last_action
+    @action_manager.actions.last
+  end
+
   def members
     return "-" if skip
 

data/lib/teuton/case/close.rb

@@ -5,11 +5,11 @@ class Case
     # Invoked from check_cases!
 
     fails = 0
-    uniques.each do |key|
-      next unless uniques[key].include?(id) && uniques[key].count > 1
+    uniques.each_pair do |key, values|
+      next unless values&.include?(id) && (values&.count&.> 1)
 
       fails += 1
-      log_unique_message(key, uniques[key])
+      log_unique_message(key, values)
     end
     @report.tail[:unique_fault] = fails
     @report.close

data/lib/teuton/case/dsl/all.rb

@@ -1,3 +1,4 @@
+require_relative "event"
 require_relative "expect"
 require_relative "getset"
 require_relative "host"

data/lib/teuton/case/dsl/event.rb

@@ -0,0 +1,24 @@
+module DSL
+  def event(**args, &block)
+    object = args[:on]
+    unless Case::ActionManager::OBJECTS.include? object
+      Logger.warn "Incorrect argument in event on: #{object} ..."
+      Logger.info "Valid OBJECTS: #{Case::ActionManager::OBJECTS.join(",")}"
+      return
+    end
+    condition = args[:when]
+    unless Case::ActionManager::CONDITIONS.include? condition
+      Logger.warn "Incorrect argument in event on: :#{object} when: #{condition}"
+      Logger.info "Valid CONDITIONS: #{Case::ActionManager::CONDITIONS.join(",")}"
+      return
+    end
+
+    if object == :every_target
+      @action_manager.events << {args: args, block: block}
+    else
+      # last_target, all_targets
+      log "Event triggered on: #{object}, when: #{condition} Target #{@action.id}"
+      # TODO: do something more
+    end
+  end
+end

data/lib/teuton/case/dsl/expect.rb

@@ -15,12 +15,11 @@ module DSL
     elsif input.instance_of?(String) || input.instance_of?(Regexp) || input.instance_of?(Array)
       expect_any input
     else
-      puts Rainbow("[ERROR] Case expect TypeError: <expect #{input} (#{input.class})>").bright.red
+      Logger.warn "Case expect TypeError: <expect #{input} (#{input.class})>"
     end
   end
 
   def expect2(cond, args = {})
-    @action.next
     if @result.exitcode.negative?
       # When exitcode is less than zero, it is because there has been
       # an error in the remote connection (SSH or Telnet)
@@ -33,8 +32,11 @@ module DSL
 
     @action.alterations = @result.alterations
     @action.expected = (args[:expected] || @result.expected)
+
+    @action_manager.trigger_events!
     @report.lines << @action.to_h
-    weight(1.0)
+    @action = @action_manager.next_action
+    # TODO: weight(1.0)
 
     c = Settings.letter[:fail]
     c = Settings.letter[:good] if cond

data/lib/teuton/case/dsl/log.rb

@@ -1,19 +1,15 @@
 require "rainbow"
 
 module DSL
-  ##
-  # Record log message
-  # @param text (String)
-  # @param type (Symbol) Values :info, :warn or :error
+  # type => :info, :warn or :error
   def log(text = "", type = :info)
     s = " INFO"
-    s = Rainbow("WARN!").color(:yellow) if type == :warn
+    s = Rainbow(" WARN").color(:yellow) if type == :warn
     s = Rainbow("ERROR").bg(:red) if type == :error
     t = Time.now
     f = format("%<hour>02d:%<min>02d:%<sec>02d", {hour: t.hour, min: t.min, sec: t.sec})
-    msg = "[#{f}] #{s}: #{text}"
+    msg = "[#{f}] #{s}| #{text}"
     msg = "[#{f}] #{text}" if s == ""
     @report.lines << msg
   end
-  # alias_method :msg, :log
 end

data/lib/teuton/case/dsl/macro.rb

@@ -13,7 +13,7 @@ module DSL
     unless macros[name]
       msg = "Unknown DSL keyword '#{name}'"
       log(msg, :error)
-      Logger.warn("Warn: #{msg}")
+      Logger.warn(msg)
       return
     end
     input.each_pair { |k, v| set(k, v) }