teuton 2.9.3 → 2.9.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3b4752e08b15fd862f420e1d48adbd9993d85d195d1b4c4e3a038fd49496c266
-  data.tar.gz: 35b22222f598310ccb28f208a56a4ae6923585815b41cceea7ed1d3546c6b914
+  metadata.gz: 3ce9e5fc4e8a37ff624e2c8dc16440236aed569cf1c6b77a49e9efbb6f2b1894
+  data.tar.gz: e2959aef5f909f245c27bf18868ffb7cfd0e7dee376da8f9620b1306f0d8b383
 SHA512:
-  metadata.gz: 94c0548eea0557f8974d2f11640aa292cb6beaa446ea11f5b8c8927f0fafd846bf03bdb7d9114c82447e149534bc350521ba3998c441996c95aecc1a07341551
-  data.tar.gz: e6086e5451d2846bde79419d8cc3cf0c6d8dd332c966e2fee3c19f54c66569cc5f3c62e8aeb108a9c6f2e6cfe63e4190d70491b5aeb99d7dbc75cfe3f07991bc
+  metadata.gz: 60567daad6f01a946b227f5eba0c63813bcb9e2d1f466e3d0fbf5407e7e3d1efa120036df6cc29f4e63f627b0e638d3334f34f0182558fb20d66d35bedf113de
+  data.tar.gz: ed5569263c61fa81b42c4764793fe4e917d4395c115b2f95c4456813c62b5e0d86e02a68e79354babc9e2bc471678d6566c032e475bd1944563817163b65ee54

data/README.md

@@ -8,10 +8,10 @@ _Create Unit Test for your machines. Test your infrastructure as code._
 
 ![logo](./docs/images/logo.png)
 
-Infrastructure test, useful for:
+The infrastructure test is useful for:
 * Sysadmin teachers who want to evaluate students remote machines.
-* Sysadmin apprentices who want to evaluate their learning process as a game.
-* Professional sysadmin who want to monitor remote machines.
+* Students who want to evaluate their learning process.
+* Professionals who want to monitor their remote machines.
 
 # Installation
 
@@ -28,7 +28,7 @@ gem install teuton
 Executing `teuton` command to run example test:
 
 ```console
-❯ teuton run examples/01-target
+> teuton run examples/01-target
 
 CASE RESULTS
 +------+-----------+-------+-------+
@@ -37,6 +37,8 @@ CASE RESULTS
 +------+-----------+-------+-------+
 ```
 
+> More information about [commands](docs/commands/README.md)
+
 # Features
 
 * Simple DSL to define your tests: `target`, `run`,`expect` and more.
@@ -67,4 +69,6 @@ CASE RESULTS
 1. Push to the branch (`git push origin my-new-feature`)
 1. Create new Pull Request.
 
-You can also [create issues](https://github.com/teuton-software/teuton/issues) with your requests/incidences/suggestions.
+You can also [create issues](https://github.com/teuton-software/teuton/issues) with your requests, incidences or suggestions.
+
+> Read [Spanish documentation](docs/es/README.md)

data/docs/changelog/changelog.2.md

@@ -117,3 +117,12 @@ DSL send:
          /home/username/example/foo/start.rb
          or /home/username/example/foo.rb
 ```
+
+## [2.9.3] 20250402
+
+- [FIX] Error with telnet connections.
+
+## [2.9.4] 20250410
+
+- [FIX] Improve the markdown output of the readme.
+- [FIX] Telnet exitcode

data/docs/es/README.md

@@ -0,0 +1,72 @@
+
+# TEUTON (ES) - (Documentación en progreso)
+
+[![Gem Version](https://badge.fury.io/rb/teuton.svg)](https://badge.fury.io/rb/teuton)
+![GitHub](https://img.shields.io/github/license/dvarrui/teuton)
+
+_Crear test unitarios para tus máquinas y probar tu infraestructura como si fuera código._
+
+![logo](../images/logo.png)
+
+El test de infraestructura es útil para:
+* Profesores de administración de sistemas que quieren evaluar a las máquinas remotas de los alumnos.
+* Alumnos que quieren evaluar su proceso de aprendizaje.
+* Profesionales que desean monitorizar sus máquinas remotas.
+
+# Instalación
+
+Primero es necesario tener instalado `Ruby`y a continuación instalamos Teuton con el siguiente comando:
+
+```console
+gem install teuton
+```
+
+> Para instalar Teuton sin privilegios de root: `gem install --user-install teuton`
+
+# Modo de uso
+
+Usaremos el comando `teuton` para ejecutar los tests:
+
+```console
+> teuton run examples/01-target
+
+CASE RESULTS
++------+-----------+-------+-------+
+| CASE | MEMBERS   | GRADE | STATE |
+| 01   | anonymous | 100.0 | ✔     |
++------+-----------+-------+-------+
+```
+
+> Más información sobre los [comandos](../commands/README.md)
+
+# Características
+
+* DSL sencillo para definir los tests: `target`, `run`,`expect`, etc.
+* Se usa conexiones SSH o Telnet para acceder a los dispositivos remotos.
+* Formatos de salida: `txt`, `html`, `json`, `yaml`, etc.
+* Multiplatforma.
+* [Licencia de Software Libre](LICENSE).
+
+# Documentación
+
+* [Instalación](../install/README.md)
+* [Aprender](../learn/README.md)
+* [Ejemplos](../../examples)
+* [Comandos](../commands/README.md)
+* [DSL](../dsl/README.md)
+* [Blogs y videos](../videos.md)
+
+# Contacto
+
+* **Email**: `teuton.software@protonmail.com`
+
+# Contribuciones
+
+1. Asegúrate de tener `Ruby`instalado.
+1. Haz un "fork" del proyecto.
+1. Crear tu rama "feature" (`git checkout -b my-new-feature`)
+1. Haz "commit" de tus cambios (`git commit -am 'Add some feature'`)
+1. Haz "push" a la rama (`git push origin my-new-feature`)
+1. Crear un "pull request" nuevo.
+
+También se pueden [crear issues](https://github.com/teuton-software/teuton/issues) con peticiones, incidencias o sugerencias.

data/docs/es/aprender/01-cmd_new.md

@@ -0,0 +1,27 @@
+
+[<< back](README.md)
+
+# Nuevo test
+
+Crear el esquelero para un nuevo proyecto: `teuton create foo`
+
+```
+> teuton new foo
+
+[INFO] Creating foo project skeleton
+* Create dir        => foo
+* Create file       => foo/config.yaml
+* Create file       => foo/start.rb
+```
+
+> NOTA: Lo ficheros se pueden crear manualmente.
+
+Este comando crea los siguientes ficheros:
+
+| Fichero/Directorio | Descripción      |
+| ------------------ | ---------------- |
+| foo                | Direcotrio base  |
+| foo/start.rb       | Script principal |
+| foo/config.yaml    | Fichero de configuración |
+
+Ahora es el momento de personalizar nuestros objetivos (targets).

data/docs/es/aprender/02-target.md

@@ -0,0 +1,131 @@
+[<< back](README.md)
+
+# target
+
+Un [target](../../dsl/target.md) es el objetivo que queremos evaluar. Los objetivos se definen dentro de una sección `group`.
+
+## Target definition
+
+Cada proceso de evaluación consta de 3 partes:
+
+* [target](../../dsl/target.md): Descripción del elemento que va a ser evaluado.
+* [run](../../dsl/run.md): Ejecutar el comando `id obiwan` en la máquina local.
+* [expect](../../dsl/expect.md): Verificar que el resultado del comando devuelve el valor esperado.
+
+```ruby
+group "Aprender sobre los targets" do
+
+  target "Existe el usuario <obiwan>"
+  run "id obiwan"
+  expect ["uid=", "(obiwan)", "gid="]
+
+  target "No existe el usuario <vader>"
+  run "id vader"
+  expect_fail
+end
+```
+
+> En este ejemplo estamo usando un SO GNU/Linux en la máquina local porque queremos ejecutar el comando `id obiwan`.
+
+Cuando el usuario existe, esperamos encontrar estas palabras en la salida del comando: `uid=, (obiwan), gid=`.
+
+```
+> id obiwan
+uid=1000(obiwan) gid=1000(obiwan) grupos=1000(obiwan)
+```
+
+Pero cuando el usuario no existe, se esperan una salida de error.
+
+```
+> id vader
+id: «vader»: no such user
+
+> echo $?
+1
+
+```
+
+## Section de ejecución
+
+Cuando se ejecuta el test, se procesa la sección `play`, la cual contiene las siguientes instrucciones:
+
+* [show](../../dsl/show.md): mostrar por pantalla información del proceso.
+* [export](../../dsl/export.md): generar informes de salida.
+
+```ruby
+play do
+  show
+  export
+end
+```
+
+## Ejemplo
+
+Usa este comando para ejecutar el test:
+
+```console
+> teuton run examples/02-target
+
+CASE RESULTS
++------+-----------+-------+-------+
+| CASE | MEMBERS   | GRADE | STATE |
+| 01   | anonymous | 100.0 | ✔     |
++------+-----------+-------+-------+
+```
+
+Los informes de salida se crean en la carpeta `var/02-target/`:
+
+```console
+var
+└── 02-target
+    ├── case-01.txt
+    ├── moodle.csv
+    └── resume.txt
+```
+
+Veamos el contenido:
+
+```
+> 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                        |
++--------------+---------------------------+
+```

data/docs/es/aprender/README.md

@@ -0,0 +1,36 @@
+[<< back](../README.md)
+
+# Aprender
+
+Aprender a escribir tus propios test:
+
+1. [Crear un NUEVO test](01-cmd_new.md)
+1. [Evaluating TARGET](02-target.md)
+1. [Checking REMOTE HOSTS](03-remote_hosts.md)
+1. [Reading CONFIG file](04-config.md)
+1. [Using several files](05-use.md)
+1. [CHECK test syntax](06-cmd_check.md)
+1. [Target WEIGHT](07-target_weight.md)
+1. [UNIQUE values](08-unique_values.md)
+1. [SEND report copies to remote hosts](09-send.md)
+1. [DEBUG results](10-debug.md)
+1. [Export other FORMATS](11-export.md)
+1. [PRESERVE old reports](12-preserve.md)
+1. [Hide FEEDBACK from reports](13-feedback.md)
+1. [MOODLE](14-moodle_id.md)
+1. [Build README from test](15-readme.md)
+1. [INCLUDE more configuration files](16-include.md)
+1. [ALIAS](17-alias.md)
+1. [LOG messages](18-log.md)
+1. [Don't get params, just read vars](19-read_vars.md)
+1. [MACROS](20-macros.md)
+1. [Checking exit codes](21-exit_codes.md)
+1. [RESULT object](22-result.md)
+1. [Test code](23-test-code.md)
+1. [Test SQL and database](24-test-sql.md)
+1. [expect vs result](25-expect-result.md) TODO
+1. [EXPECT_SEQUENCE](26-expect_sequence.md)
+1. [RUN_SCRIPT](27-run_script.md)
+1. [UPLOAD](28-upload.md)
+
+Mores examples at [teuton-tests](https://github.com/dvarrui/teuton-tests) GitHub repository.

data/docs/install/README.md

@@ -2,14 +2,14 @@
 
 # Installation
 
-There are 2 types of nodes/hosts, so there are 2 installations:
+There are 2 types of nodes (hosts), so there are 2 installations:
 
 | ID | Software | Description |
 | -- | -------- | ----------- |
 | **T-node** | [Teuton installation](t-node.md) | T-NODE host monitors one or severals S-NODE hosts |
 | **S-node** | [SSH server installation](s-node.md) | S-NODE hosts are monitorized by T-NODE host |
 
-Read [modes of use](modes_of_use.md) to know more about differents T-NODE/S-NODE schemes.
+> Read [modes of use](modes_of_use.md) to know more about differents T-NODE/S-NODE schemes.
 
 ## Tested OS list
 

data/docs/install/s-node.md

@@ -11,7 +11,7 @@ Install SSH server on every machine with S-NODE role.
 Run this command as `root` user:
 
 ```bash
-wget -qO- https://raw.githubusercontent.com/teuton-software/teuton/master/install/linux/linux_s-node_install.sh | bash
+wget -qO- https://raw.githubusercontent.com/teuton-software/teuton/master/install/linux/s-node_install.sh | bash
 ```
 
 **S-node Windows installation**
@@ -23,7 +23,7 @@ Requirements:
 Run this command on **PowerShell (PS)** as `Administrator` user:
 
 ```powershell
-Set-ExecutionPolicy Bypass -Scope Process -Force; iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/teuton-software/teuton/master/install/windows/windows_s-node_install.ps1'))
+Set-ExecutionPolicy Bypass -Scope Process -Force; iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/teuton-software/teuton/master/install/windows/s-node_install.ps1'))
 ```
 
 **S-node Mac OS X installation**
@@ -31,5 +31,5 @@ Set-ExecutionPolicy Bypass -Scope Process -Force; iex ((New-Object System.Net.We
 Run this command as `root` user:
 
 ```bash
-curl -sL https://raw.githubusercontent.com/teuton-software/teuton/master/install/mac/macosx_s-node_install.sh | bash
+curl -sL https://raw.githubusercontent.com/teuton-software/teuton/master/install/mac/s-node_install.sh | bash
 ```

data/docs/install/t-node.md

@@ -4,24 +4,19 @@
 
 # 1. Recommended
 
-**Installation**
-
+Installation:
 1. Install Ruby on your system.
 2. `gem install teuton`
 
 Run `teuton version` to check the installed version.
 
-**Update**
-
-`gem update teuton`.
-
-**Uninstall**
-
-`gem uninstall teuton`.
+> NOTE:
+> * Update: `gem update teuton`.
+> * Uninstall: `gem uninstall teuton`.
 
 # 2. Problems
 
-Don't find `teuton` command (OpenSUSE distro, for example), try this:
+Sometimes we don't find `teuton` command (OpenSUSE distro, for example), so try this:
 
 Option A:
 * `ruby -v`, display your current ruby version. Suppose it is "2.5".
@@ -40,7 +35,7 @@ If you don't know how to install Ruby on your system, execute this script to run
 Run this command as `root` user:
 
 ```bash
-wget -qO- https://raw.githubusercontent.com/teuton-software/teuton/master/install/linux/linux_t-node_install.sh | bash
+wget -qO- https://raw.githubusercontent.com/teuton-software/teuton/master/install/linux/t-node_install.sh | bash
 ```
 
 **T-node Windows installation**
@@ -52,7 +47,7 @@ Requirements:
 Run this command on **PowerShell (PS)** as `Administrator` user:
 
 ```powershell
-Set-ExecutionPolicy Bypass -Scope Process -Force; iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/teuton-software/teuton/master/install/windows/windows_t-node_install.ps1'))
+Set-ExecutionPolicy Bypass -Scope Process -Force; iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/teuton-software/teuton/master/install/windows/t-node_install.ps1'))
 ```
 
 **T-node Mac OS X installation**
@@ -60,7 +55,7 @@ Set-ExecutionPolicy Bypass -Scope Process -Force; iex ((New-Object System.Net.We
 Run this command as admin user (member of `admin` group):
 
 ```bash
-curl -sL https://raw.githubusercontent.com/teuton-software/teuton/master/install/mac/macosx_t-node_install.sh | bash
+curl -sL https://raw.githubusercontent.com/teuton-software/teuton/master/install/mac/t-node_install.sh | bash
 ```
 
 # 4. Vagrant/Docker

data/docs/learn/02-target.md

@@ -2,13 +2,14 @@
 
 # target
 
-A [target](../dsl/target.md) is a feature you want to check. Targets are defined into `group` sections and every evaluation has 3 parts:
+A [target](../dsl/target.md) is a feature you want to check. Targets are defined into `group` sections.
 
 ## Target definition
 
+Every evaluation has 3 parts:
 * [target](dsl/target.md): Description of the element to be tested.
 * [run](../dsl/run.md): Execute a command `id obiwan` on localhost.
-* [expect](../&dsl/expect.md): Verify that the result contains expected value.
+* [expect](../dsl/expect.md): Verify that the result contains expected value.
 
 ```ruby
 group "Learn about targets" do
@@ -28,17 +29,17 @@ end
 When the user exists, we expect this words: `uid=, (obiwan), gid=`.
 
 ```
-❯ id obiwan
+> id obiwan
 uid=1000(obiwan) gid=1000(obiwan) grupos=1000(obiwan)
 ```
 
-But when user does not exist, we expect different words: `id:, vader, no exist`.
+But when user does not exist, we expect command fail.
 
 ```
-❯ id vader
+> id vader
 id: «vader»: no such user
 
-❯ echo $?
+> echo $?
 1
 
 ```

data/lib/teuton/case/config.rb

@@ -55,7 +55,7 @@ class Case
       key2 = @ialias[words[0].to_sym]
       return "NODATA" unless key2
 
-      get("#{key2}_#{words[1]}".to_sym, level)
+      get(:"#{key2}_#{words[1]}", level)
     end
 
     def search_array_alias(keys, level)

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

@@ -23,6 +23,8 @@ module DSL
     @action_counter += 1
     @action[:id] = @action_counter
     if @result.exitcode < 0
+      # When exitcode is less than zero, it is because there has been
+      # an error in the remote connection (SSH or Telnet)
       @action[:check] = false
       @action[:result] = @action[:output]
     else

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

@@ -38,8 +38,8 @@ class ExpectSequence
 
   def find_best_state
     @states.each do |state|
-      state[:score] = (state[:steps].select { _1 }).size
-      state[:fails] = (state[:steps].select { !_1 }).size
+      state[:score] = (state[:steps].select { it }).size
+      state[:fails] = (state[:steps].select { !it }).size
       state[:ok] = (state[:fails] == 0)
     end
     best = @states[0]

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

@@ -5,7 +5,7 @@ module DSL
   def run_script(script, args = {})
     items = script.split(" ")
     if items.size == 1
-      shell = args[:shell] || (get(:shell) != "NODATA" ? get(:shell) : nil)
+      shell = args[:shell] || ((get(:shell) != "NODATA") ? get(:shell) : nil)
       script = "#{shell} #{script}" if shell
       script = "#{script} #{args[:args]} " if args[:args]
     end

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

@@ -4,6 +4,6 @@ module DSL
   def unique(key, value)
     return if value.nil?
 
-    @uniques << "#{key}=#{value}".to_sym
+    @uniques << :"#{key}=#{value}"
   end
 end

data/lib/teuton/case/execute/execute_base.rb

@@ -38,8 +38,12 @@ class ExecuteBase
   def encode_and_split(encoding, text)
     # Convert text to UTF-8 deleting unknown chars
     text ||= "" # Ensure text is not nil
-    flag = [:default, "UTF-8"].include? encoding
-    return text.encode("UTF-8", invalid: :replace).split("\n") if flag
+
+    # TODO: text.gsub!('\r', '')
+    if [:default, "UTF-8"].include? encoding
+      text.encode!("UTF-8", invalid: :replace, undef: :replace, replace: "")
+      return text.split("\n")
+    end
 
     # Convert text from input ENCODING to UTF-8
     ec = Encoding::Converter.new(encoding.to_s, "UTF-8")
@@ -47,9 +51,9 @@ class ExecuteBase
       text = ec.convert(text)
     rescue => e
       puts "[ERROR] #{e}: Declare text encoding..."
-      puts "        run 'command', on: :host, :encoding => 'ISO-8859-1'"
+      puts "        run 'command', on: :host, encoding: 'ISO-8859-1'"
     end
 
-    text.split("\n")
+    text.split("\n").compact
   end
 end

data/lib/teuton/case/execute/execute_manager.rb

@@ -31,8 +31,8 @@ class ExecuteManager
   end
 
   def run_on(host)
-    protocol = config.get("#{host}_protocol".to_sym)
-    ip = config.get("#{host}_ip".to_sym)
+    protocol = config.get(:"#{host}_protocol")
+    ip = config.get(:"#{host}_ip")
 
     if protocol.to_s.downcase == "local" || host.to_s == "localhost"
       # Protocol force => local

data/lib/teuton/case/execute/execute_ssh.rb

@@ -9,24 +9,24 @@ class ExecuteSSH < ExecuteBase
   def call(input_hostname)
     action[:conn_type] = :ssh
     hostname = input_hostname.to_s
-    ip = config.get("#{hostname}_ip".to_sym).to_s
-    username = config.get("#{hostname}_username".to_sym).to_s
-    password = config.get("#{hostname}_password".to_sym).to_s
-    port = config.get("#{hostname}_port".to_sym).to_i
+    ip = config.get(:"#{hostname}_ip").to_s
+    username = config.get(:"#{hostname}_username").to_s
+    password = config.get(:"#{hostname}_password").to_s
+    port = config.get(:"#{hostname}_port").to_i
     port = 22 if port.zero?
 
-    unless config.get("#{hostname}_route".to_sym) == "NODATA"
+    unless config.get(:"#{hostname}_route") == "NODATA"
       # Reconfigure command with gateway. Example host1_route: IP.
       # hostname2 = hostname ¿not used?
       ip2 = ip
       username2 = username
       password2 = password
       command2 = action[:command]
-      hostname = config.get("#{hostname}_route".to_sym)
-      ip = config.get("#{hostname}_ip".to_sym).to_s
-      username = config.get("#{hostname}_username".to_sym).to_s
-      password = config.get("#{hostname}_password".to_sym).to_s
-      ostype = config.get("#{hostname}_ostype".to_sym).to_s
+      hostname = config.get(:"#{hostname}_route")
+      ip = config.get(:"#{hostname}_ip").to_s
+      username = config.get(:"#{hostname}_username").to_s
+      password = config.get(:"#{hostname}_password").to_s
+      ostype = config.get(:"#{hostname}_ostype").to_s
 
       action[:command] = if ostype.downcase.start_with? "win"
         "echo y | plink #{username2}@#{ip2} -ssh -pw #{password2} \"#{command2}\""
@@ -89,6 +89,5 @@ class ExecuteSSH < ExecuteBase
     end
     result.exitcode = exitcode
     result.content = encode_and_split(action[:encoding], text)
-    result.content.compact!
   end
 end

data/lib/teuton/case/execute/execute_telnet.rb

@@ -1,7 +1,7 @@
 require "net/telnet"
-require "rainbow"
+# require "rainbow"
 require_relative "../../utils/project"
-require_relative "../../utils/verbose"
+# require_relative "../../utils/verbose"
 require_relative "execute_base"
 
 class ExecuteTelnet < ExecuteBase
@@ -9,48 +9,55 @@ class ExecuteTelnet < ExecuteBase
     action[:conn_type] = :telnet
     hostname = input_hostname.to_s
     ip = config.get((hostname + "_ip").to_sym)
-    username = config.get((hostname + "_username").to_sym).to_s
-    password = config.get((hostname + "_password").to_sym).to_s
+    port = config.get((hostname + "_port").to_sym)
+    mode = true
+    if port.to_i == 0
+      port = "23"
+      mode = false
+    end
     text = ""
+    exitcode = -1
     begin
       if sessions[hostname].nil? || sessions[hostname] == :ok
         h = Net::Telnet.new(
           "Host" => ip,
+          "Port" => port,
+          "Telnetmode" => mode,
           "Timeout" => 30,
-          "Prompt" => /login|teuton|[$%#>]|PC1>/
+          "Prompt" => /login|teuton|[$%#>]/
         )
         # "Prompt" => Regexp.new(username[1, 40]))
         # "Prompt" => /[$%#>] \z/n)
-        h.login(username, password)
+        unless mode
+          username = config.get((hostname + "_username").to_sym).to_s
+          password = config.get((hostname + "_password").to_sym).to_s
+          h.login(username, password)
+        end
         h.cmd(action[:command]) { |i| text << i }
         h.close
         sessions[hostname] = :ok
+        exitcode = 0
       else
-        text = "TELNET: NO CONNECTION!"
+        text = "Telnet: NO CONNECTION!"
       end
     rescue Net::OpenTimeout
       sessions[hostname] = :nosession
       conn_status[hostname] = :open_timeout
-      # verbose Rainbow(Application.instance.letter[:error]).red.bright
       log(" ExceptionType=<Net::OpenTimeout> doing <telnet #{ip}>", :error)
       log(" └── Revise host IP!", :warn)
     rescue Net::ReadTimeout
       sessions[hostname] = :nosession
       conn_status[hostname] = :read_timeout
-      # verbose Rainbow(Application.instance.letter[:error]).red.bright
       log(" ExceptionType=<Net::ReadTimeout> doing <telnet #{ip}>", :error)
     rescue => e
       sessions[hostname] = :nosession
       conn_status[hostname] = :error
-      # verbose Rainbow(Application.instance.letter[:error]).red.bright
       log(" ExceptionType=<#{e.class}> doing telnet on <#{username}@#{ip}>" \
           " exec: #{action[:command]}", :error)
       log(" └── username=<#{username}>, password=<#{password}>," \
           " ip=<#{ip}>, HOSTID=<#{hostname}>", :warn)
     end
-    output = encode_and_split(action[:encoding], text)
-    result.exitcode = -1
-    result.content = output
-    result.content.compact!
+    result.exitcode = exitcode
+    result.content = encode_and_split(action[:encoding], text)
   end
 end

data/lib/teuton/case/host.rb

@@ -34,11 +34,11 @@ class Case
 
     def init(id)
       @id = id.to_sym
-      @ip = @config.get("#{@id}_ip".to_sym).to_s
-      @username = @config.get("#{@id}_username".to_sym).to_s
-      @password = @config.get("#{@id}_password".to_sym).to_s
+      @ip = @config.get(:"#{@id}_ip").to_s
+      @username = @config.get(:"#{@id}_username").to_s
+      @password = @config.get(:"#{@id}_password").to_s
 
-      @protocol = @config.get("#{@id}_protocol".to_sym).to_s.downcase
+      @protocol = @config.get(:"#{@id}_protocol").to_s.downcase
       if @protocol == "nodata"
         @protocol = if @ip == "localhost" || @ip.start_with?("127.0.0.")
           "local"
@@ -47,12 +47,12 @@ class Case
         end
       end
 
-      @port = @config.get("#{@id}_port".to_sym).to_i
+      @port = @config.get(:"#{@id}_port").to_i
       if @port.zero?
         default = {"local" => 0, "ssh" => 22, "telnet" => 23}
         @port = default[@protocol]
       end
-      @route = @config.get("#{@id}_route".to_sym)
+      @route = @config.get(:"#{@id}_route")
     end
 
     def init_default

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

@@ -6,7 +6,7 @@ require_relative "run"
 module CheckDSL
   def log(text = "", type = :info)
     @stats[:logs] += 1
-    prefix = type == :info ? "" : "#{type.to_s.upcase}: "
+    prefix = (type == :info) ? "" : "#{type.to_s.upcase}: "
     Logger.info "      log         #{prefix}" + text.to_s
   end
 

data/lib/teuton/check/show.rb

@@ -61,7 +61,7 @@ class ShowCheck
       end
       if Project.value[:macros].size.positive?
         st.add_row ["Macros", Project.value[:macros].size]
-        Project.value[:macros].each_key { st.add_row ["", _1] }
+        Project.value[:macros].each_key { st.add_row ["", it] }
       end
       st.add_row ["Groups", @stats[:groups]]
       st.add_row ["Targets", @stats[:targets]]
@@ -87,11 +87,11 @@ class ShowCheck
 
       if @stats[:sets].size.positive?
         st.add_row ["Sets", @stats[:sets].size]
-        @stats[:sets].each { st.add_row ["", _1] }
+        @stats[:sets].each { st.add_row ["", it] }
       end
       if @stats[:uploads].size.positive?
         st.add_row ["Uploads", @stats[:uploads].size]
-        @stats[:uploads].each { st.add_row ["", _1] }
+        @stats[:uploads].each { st.add_row ["", it] }
       end
     end
     Logger.info my_screen_table.to_s + "\n"
@@ -114,7 +114,7 @@ class ShowCheck
         script_vars << k.to_s + "_password"
       end
     end
-    @stats[:gets].keys.each { script_vars << _1 }
+    @stats[:gets].keys.each { script_vars << it }
     script_vars
   end
 end

data/lib/teuton/deprecated/runner.rb

@@ -9,8 +9,8 @@ class Case
   # READ: @config
   # WRITE: @action, @result, @session
   def run_cmd_on(host)
-    protocol = @config.get("#{host}_protocol".to_sym)
-    ip = @config.get("#{host}_ip".to_sym)
+    protocol = @config.get(:"#{host}_protocol")
+    ip = @config.get(:"#{host}_ip")
 
     if protocol.to_s.downcase == "local" || host.to_s == "localhost"
       # Protocol force => local
@@ -59,24 +59,24 @@ class Case
   def run_cmd_remote_ssh(input_hostname)
     @action[:conn_type] = :ssh
     hostname = input_hostname.to_s
-    ip = @config.get("#{hostname}_ip".to_sym).to_s
-    username = @config.get("#{hostname}_username".to_sym).to_s
-    password = @config.get("#{hostname}_password".to_sym).to_s
-    port = @config.get("#{hostname}_port".to_sym).to_i
+    ip = @config.get(:"#{hostname}_ip").to_s
+    username = @config.get(:"#{hostname}_username").to_s
+    password = @config.get(:"#{hostname}_password").to_s
+    port = @config.get(:"#{hostname}_port").to_i
     port = 22 if port.zero?
 
-    unless @config.get("#{hostname}_route".to_sym) == "NODATA"
+    unless @config.get(:"#{hostname}_route") == "NODATA"
       # Reconfigure command with gateway. Example host1_route: IP.
       # hostname2 = hostname ¿not used?
       ip2 = ip
       username2 = username
       password2 = password
       command2 = @action[:command]
-      hostname = @config.get("#{hostname}_route".to_sym)
-      ip = @config.get("#{hostname}_ip".to_sym).to_s
-      username = @config.get("#{hostname}_username".to_sym).to_s
-      password = @config.get("#{hostname}_password".to_sym).to_s
-      ostype = @config.get("#{hostname}_ostype".to_sym).to_s
+      hostname = @config.get(:"#{hostname}_route")
+      ip = @config.get(:"#{hostname}_ip").to_s
+      username = @config.get(:"#{hostname}_username").to_s
+      password = @config.get(:"#{hostname}_password").to_s
+      ostype = @config.get(:"#{hostname}_ostype").to_s
 
       @action[:command] = if ostype.downcase.start_with? "win"
         "echo y | plink #{username2}@#{ip2} -ssh -pw #{password2} \"#{command2}\""

data/lib/teuton/readme/dsl/getset.rb

@@ -14,11 +14,11 @@ module ReadmeDSL
   def gett(value)
     a = get(value)
     if @cases_params.include? value
-      "[#{value}](#required-params)"
+      "[" + value + "](#required-params)"
     elsif @setted_params[value]
-      "[#{value}](#created-params)"
+      "[" + value + "](#created-params)"
     elsif @global_params.include? value
-      "[#{a}](#global-params)"
+      "[" + a + "](#global-params)"
     end
     a
   end

data/lib/teuton/readme/dsl/run.rb

@@ -2,21 +2,21 @@ module ReadmeDSL
   def goto(host = :localhost, args = {})
     unless host == :localhost
       b = {}
-      a = "#{host}_ip".to_sym
+      a = :"#{host}_ip"
       if @config[:global][a].nil? && !@setted_params.include?(a)
         @cases_params << a
       end
       b[:ip] = @config[:global][a] if @config[:global][a]
       b[:ip] = @setted_params[a] if @setted_params[a]
 
-      a = "#{host}_username".to_sym
+      a = :"#{host}_username"
       if @config[:global][a].nil? && !@setted_params.include?(a)
         @cases_params << a
       end
       b[:username] = @config[:global][a] if @config[:global][a]
       b[:username] = @setted_params[a] if @setted_params[a]
 
-      a = "#{host}_password".to_sym
+      a = :"#{host}_password"
       if @config[:global][a].nil? && !@setted_params.include?(a)
         @cases_params << a
       end

data/lib/teuton/readme/readme.rb

@@ -71,8 +71,8 @@ class Readme
     unless @required_hosts.empty?
       puts Lang.get(:hosts)
       puts "\n"
-      puts "| ID | Host | Configuration |"
-      puts "| --- | --- | --- |"
+      puts "| ID  | Host | Configuration |"
+      puts "| --- | ---- | ------------- |"
       @required_hosts.each_pair do |k, v|
         c = []
         v.each_pair { |k2, v2| c << "#{k2}=#{v2}" }
@@ -123,15 +123,15 @@ class Readme
       puts Lang.get(:global_params)
       puts "\n"
       puts "| Param | Value |"
-      puts "| --- | --- |"
+      puts "| ----- | ----- |"
       @global_params.each_pair { |k, v| puts "|#{k}|#{v}|" }
     end
     if @setted_params.size.positive?
       puts Lang.get(:created_params)
       puts "\n"
-      puts "| Param | Value |"
-      puts "| --- | --- |"
-      @setted_params.each_pair { |k, v| puts "|#{k}|#{v}|" }
+      puts "| Param |"
+      puts "| ----- |"
+      @setted_params.each_pair { |k, v| puts "|#{k}|" }
     end
   end
 end

data/lib/teuton/report/formatter/default/array.rb

@@ -3,7 +3,7 @@ require_relative "../../../utils/project"
 
 class ArrayFormatter < BaseFormatter
   def initialize(report)
-    super(report)
+    super
     @data = {}
   end
 

data/lib/teuton/report/formatter/default/html.rb

@@ -3,7 +3,7 @@ require_relative "yaml"
 
 class HTMLFormatter < YAMLFormatter
   def initialize(report)
-    super(report)
+    super
     @ext = "html"
     @data = {}
     basedir = File.join(File.dirname(__FILE__), "..", "..", "..")

data/lib/teuton/report/formatter/default/json.rb

@@ -1,9 +1,10 @@
-require "json/pure"
+# require "json/pure"
+require "json"
 require_relative "array"
 
 class JSONFormatter < ArrayFormatter
   def initialize(report)
-    super(report)
+    super
     @ext = "json"
   end
 

data/lib/teuton/report/formatter/default/xml.rb

@@ -3,7 +3,7 @@ require_relative "../../../version"
 
 class XMLFormatter < BaseFormatter
   def initialize(report)
-    super(report)
+    super
     @ext = "xml"
   end
 

data/lib/teuton/report/formatter/default/yaml.rb

@@ -3,7 +3,7 @@ require_relative "array"
 
 class YAMLFormatter < ArrayFormatter
   def initialize(report)
-    super(report)
+    super
     @ext = "yaml"
   end
 

data/lib/teuton/report/formatter/moodle_csv_formatter.rb

@@ -2,7 +2,7 @@ require_relative "resume/array"
 
 class MoodleCSVFormatter < ResumeArrayFormatter
   def initialize(report)
-    super(report)
+    super
     @ext = "csv"
     @data = {}
   end

data/lib/teuton/report/formatter/resume/array.rb

@@ -3,7 +3,7 @@ require_relative "../../../utils/project"
 
 class ResumeArrayFormatter < BaseFormatter
   def initialize(report)
-    super(report)
+    super
     @data = {}
   end
 

data/lib/teuton/report/formatter/resume/html.rb

@@ -4,7 +4,7 @@ require_relative "yaml"
 
 class ResumeHTMLFormatter < ResumeYAMLFormatter
   def initialize(report)
-    super(report)
+    super
     @ext = "html"
     @data = {}
     basedir = File.join(File.dirname(__FILE__), "..", "..", "..")

data/lib/teuton/report/formatter/resume/json.rb

@@ -1,9 +1,10 @@
-require "json/pure"
+# require "json/pure"
+require "json"
 require_relative "array"
 
 class ResumeJSONFormatter < ResumeArrayFormatter
   def initialize(report)
-    super(report)
+    super
     @ext = "json"
     @data = {}
   end

data/lib/teuton/report/formatter/resume/yaml.rb

@@ -2,7 +2,7 @@ require_relative "array"
 
 class ResumeYAMLFormatter < ResumeArrayFormatter
   def initialize(report)
-    super(report)
+    super
     @ext = "yaml"
     @data = {}
   end

data/lib/teuton/report/report.rb

@@ -28,7 +28,7 @@ class Report
     report = Report.new
     attrs = %i[id filename output_dir head lines tail format]
     attrs.each do |attr|
-      attr_set = "#{attr}=".to_sym
+      attr_set = :"#{attr}="
       report.send(attr_set, send(attr).clone)
     end
 
@@ -42,7 +42,7 @@ class Report
 
   def export_resume(options)
     format = options[:format]
-    @format = "resume_#{format}".to_sym
+    @format = :"resume_#{format}"
     options[:format] = @format
     filepath = File.join(@output_dir, @filename)
     Formatter.call(self, options, filepath)

data/lib/teuton/utils/configfile_reader.rb

@@ -1,5 +1,6 @@
+# require "json/pure"
+require "json"
 require "yaml"
-require "json/pure"
 
 ##
 # Functions that read data from ConfigFile using YAML or JSON formats

data/lib/teuton/version.rb

@@ -1,5 +1,5 @@
 module Teuton
-  VERSION = "2.9.3"
+  VERSION = "2.9.5"
   APPNAME = "teuton"
   GEMNAME = "teuton"
   DOCKERNAME = "dvarrui/#{GEMNAME}"

data/lib/teuton.rb

@@ -22,7 +22,6 @@ module Teuton
   end
 
   def self.run(projectpath, options = {})
-    # Application.instance.add_input_params(projectpath, options)
     Project.add_input_params(projectpath, options)
     require_dsl_and_script("teuton/case_manager/dsl") # Define DSL
   end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: teuton
 version: !ruby/object:Gem::Version
-  version: 2.9.3
+  version: 2.9.5
 platform: ruby
 authors:
 - David Vargas Ruiz
 bindir: bin
 cert_chain: []
-date: 2025-04-02 00:00:00.000000000 Z
+date: 2025-05-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rainbow
@@ -43,14 +43,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '7.2'
+        version: '7.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '7.2'
+        version: '7.3'
 - !ruby/object:Gem::Dependency
   name: net-telnet
   requirement: !ruby/object:Gem::Requirement
@@ -99,14 +99,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '4.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '4.0'
 description: |2
     Intrastructure test, useful for:
     (1) Sysadmin teachers to evaluate students remote machines.
@@ -142,6 +142,10 @@ extra_rdoc_files:
 - docs/dsl/set.md
 - docs/dsl/show.md
 - docs/dsl/target.md
+- docs/es/README.md
+- docs/es/aprender/01-cmd_new.md
+- docs/es/aprender/02-target.md
+- docs/es/aprender/README.md
 - docs/es/exit_code.md
 - docs/es/guess_os.md
 - docs/ideas/Challenge-Server-Project.md
@@ -207,6 +211,10 @@ files:
 - docs/dsl/set.md
 - docs/dsl/show.md
 - docs/dsl/target.md
+- docs/es/README.md
+- docs/es/aprender/01-cmd_new.md
+- docs/es/aprender/02-target.md
+- docs/es/aprender/README.md
 - docs/es/exit_code.md
 - docs/es/guess_os.md
 - docs/ideas/Challenge-Server-Project.md