teuton 2.4.1 → 2.4.3

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: teuton
 version: !ruby/object:Gem::Version
-  version: 2.4.1
+  version: 2.4.3
 platform: ruby
 authors:
 - David Vargas Ruiz
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-01-21 00:00:00.000000000 Z
+date: 2023-02-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: colorize
@@ -150,18 +150,17 @@ extra_rdoc_files:
 - docs/commands/example_check.md
 - docs/commands/example_run.md
 - docs/dsl/README.md
-- docs/dsl/definition/expect.md
-- docs/dsl/definition/group.md
-- docs/dsl/definition/result.md
-- docs/dsl/definition/run_local.md
-- docs/dsl/definition/run_remote.md
-- docs/dsl/definition/target.md
-- docs/dsl/execution/export.md
-- docs/dsl/execution/play.md
-- docs/dsl/execution/send.md
-- docs/dsl/execution/show.md
-- docs/dsl/setting/get.md
-- docs/dsl/setting/set.md
+- docs/dsl/expect.md
+- docs/dsl/export.md
+- docs/dsl/get.md
+- docs/dsl/group.md
+- docs/dsl/play.md
+- docs/dsl/result.md
+- docs/dsl/run.md
+- docs/dsl/send.md
+- docs/dsl/set.md
+- docs/dsl/show.md
+- docs/dsl/target.md
 - docs/es/exit_code.md
 - docs/es/guess_os.md
 - docs/ideas/Challenge-Server-Project.md
@@ -174,22 +173,30 @@ extra_rdoc_files:
 - docs/install/s-node.md
 - docs/install/t-node.md
 - docs/install/vagrant_docker.md
-- docs/learn/01-target.md
-- docs/learn/02-config.md
+- docs/learn/01-cmd_new.md
+- docs/learn/02-target.md
 - docs/learn/03-remote_hosts.md
-- docs/learn/04-new_test.md
+- docs/learn/04-config.md
 - docs/learn/05-use.md
-- docs/learn/06-debug.md
-- docs/learn/07-log.md
-- docs/learn/08-readme.md
-- docs/learn/09-preserve.md
-- docs/learn/10-result.md
-- docs/learn/11-moodle_id.md
-- docs/learn/12-get_vars.md
-- docs/learn/13-include.md
-- docs/learn/14-alias.md
-- docs/learn/16-exit_codes.md
-- docs/learn/17-hide-feedback.md
+- docs/learn/06-cmd_check.md
+- docs/learn/07-target_weight.md
+- docs/learn/08-unique_values.md
+- docs/learn/09-send.md
+- docs/learn/10-debug.md
+- docs/learn/11-export.md
+- docs/learn/12-preserve.md
+- docs/learn/13-feedback.md
+- docs/learn/14-moodle_id.md
+- docs/learn/15-readme.md
+- docs/learn/16-include.md
+- docs/learn/17-alias.md
+- docs/learn/18-log.md
+- docs/learn/19-read_vars.md
+- docs/learn/20-macros.md
+- docs/learn/21-exit_codes.md
+- docs/learn/22-result.md
+- docs/learn/23-test-code.md
+- docs/learn/24-test-sql.md
 - docs/learn/README.md
 - docs/learn/videos.md
 - docs/videos.md
@@ -209,18 +216,17 @@ files:
 - docs/commands/example_check.md
 - docs/commands/example_run.md
 - docs/dsl/README.md
-- docs/dsl/definition/expect.md
-- docs/dsl/definition/group.md
-- docs/dsl/definition/result.md
-- docs/dsl/definition/run_local.md
-- docs/dsl/definition/run_remote.md
-- docs/dsl/definition/target.md
-- docs/dsl/execution/export.md
-- docs/dsl/execution/play.md
-- docs/dsl/execution/send.md
-- docs/dsl/execution/show.md
-- docs/dsl/setting/get.md
-- docs/dsl/setting/set.md
+- docs/dsl/expect.md
+- docs/dsl/export.md
+- docs/dsl/get.md
+- docs/dsl/group.md
+- docs/dsl/play.md
+- docs/dsl/result.md
+- docs/dsl/run.md
+- docs/dsl/send.md
+- docs/dsl/set.md
+- docs/dsl/show.md
+- docs/dsl/target.md
 - docs/es/exit_code.md
 - docs/es/guess_os.md
 - docs/ideas/Challenge-Server-Project.md
@@ -233,22 +239,30 @@ files:
 - docs/install/s-node.md
 - docs/install/t-node.md
 - docs/install/vagrant_docker.md
-- docs/learn/01-target.md
-- docs/learn/02-config.md
+- docs/learn/01-cmd_new.md
+- docs/learn/02-target.md
 - docs/learn/03-remote_hosts.md
-- docs/learn/04-new_test.md
+- docs/learn/04-config.md
 - docs/learn/05-use.md
-- docs/learn/06-debug.md
-- docs/learn/07-log.md
-- docs/learn/08-readme.md
-- docs/learn/09-preserve.md
-- docs/learn/10-result.md
-- docs/learn/11-moodle_id.md
-- docs/learn/12-get_vars.md
-- docs/learn/13-include.md
-- docs/learn/14-alias.md
-- docs/learn/16-exit_codes.md
-- docs/learn/17-hide-feedback.md
+- docs/learn/06-cmd_check.md
+- docs/learn/07-target_weight.md
+- docs/learn/08-unique_values.md
+- docs/learn/09-send.md
+- docs/learn/10-debug.md
+- docs/learn/11-export.md
+- docs/learn/12-preserve.md
+- docs/learn/13-feedback.md
+- docs/learn/14-moodle_id.md
+- docs/learn/15-readme.md
+- docs/learn/16-include.md
+- docs/learn/17-alias.md
+- docs/learn/18-log.md
+- docs/learn/19-read_vars.md
+- docs/learn/20-macros.md
+- docs/learn/21-exit_codes.md
+- docs/learn/22-result.md
+- docs/learn/23-test-code.md
+- docs/learn/24-test-sql.md
 - docs/learn/README.md
 - docs/learn/videos.md
 - docs/videos.md

data/docs/dsl/definition/run_local.md

@@ -1,33 +0,0 @@
-[<< back](../README.md)
-
-1. [Description](#description)
-2. [Usage](#usage)
-3. [Alias](#alias)
-4. [Example](#example)
-
-## Description
-
-Execute command on localhost and save output into result object.
-
-## Usage
-
-```ruby
-run "id COMMAND"
-```
-
-## Alias
-
-In fact it's the same as doing next:
-
-```ruby
-run "COMMAND", on: :localhost
-```
-
-## Example
-
-```ruby
-run "id david"
-```
-
-* This instruction execute "id david" command on local machine, and save results into **result** object.
-* Local machine is where the `Teuton` program is running.

data/docs/dsl/definition/target.md

@@ -1,40 +0,0 @@
-[<< back](../README.md)
-
-1. [Description](#description)
-2. [Usage](#usage)
-4. [Weight](#weight)
-
-## Description
-
-`target` instruction is used to begin new target/goal definition, and sets its description.
-
-## Usage
-
-```ruby
-target "Write here your description"
-```
-
-* Define target description. Use your own words to describe it, so everybody could understand what is going to be measured.
-* This text will be shown into reports to help us understand output information easily.
-
-## Weight
-
-By default weight is 1.0, but it's posible specified other value:
-
-```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/learn/02-config.md

@@ -1,117 +0,0 @@
-[<< back](README.md)
-
-# Example: config
-
-_It's good idea save variables into config file._
-
-Learn:
-* How to use config file.
-* How to use params defined into config files.
-
-## Config file
-
-By default, `config.yaml` is our default config file. Example:
-
-```yaml
----
-global:
-cases:
-- tt_members: Student-name-1
-  username: root
-- tt_members: Student-name-2
-  username: david
-```
-
-> **How to choose another config file?** Read this [document](../commands/example_run.md#3-choosing-config-file).
-
-## Definition section
-
-By default, `start.rb` it's our main execution file. Example:
-
-```ruby
-group "Reading params from config file" do
-
-  target "Create user #{get(:username)}"
-  run "id #{get(:username)}"
-  expect get(:username)
-
-end
-```
-
-In this section, we define targets using `target`, `run`, `expect` and `get` keywords.
-
-* **get** keyword read params from configuration file. It's posible personalize tests with diferent values for every case.
-
-## Execution section
-
-Main execution block:
-
-```ruby
-play do
-  show
-  export
-end
-```
-
-This example run test and show (`show` keyword) output on screen:
-
-```console
-> teuton run examples/02-config
-
-CASE RESULTS
-+------+----------------+-------+-------+
-| CASE | MEMBERS        | GRADE | STATE |
-| 01   | Student-name-1 | 100.0 | ✔     |
-| 02   | Student-name-2 | 0.0   | ?     |
-+------+----------------+-------+-------+
-```
-
-## Results
-
-Output reports are saved into `var/02-config/` directory. Detail output report is created for every case.
-
-```
-var/02-config
-├── case-01.txt
-├── case-02.txt
-├── moodle.csv
-└── resume.txt
-```
-
-Let's see `export` keyword output for case 01.
-
-```
-> more var/02-config/case-01.txt
-CONFIGURATION
-+-------------+----------------+
-| tt_members  | Student-name-1 |
-| tt_sequence | false          |
-| tt_skip     | false          |
-| tt_testname | 02-config      |
-| username    | root           |
-+-------------+----------------+
-
-GROUPS
-- Reading params from config file
-    01 (1.0/1.0)
-        Description : Create user root
-        Command     : id root
-        Duration    : 0.002 (local)
-        Alterations : find(root) & count
-        Expected    : Greater than 0 (String)
-        Result      : 1 (Integer)
-
-RESULTS
-+--------------+---------------------------+
-| case_id      | 01                        |
-| start_time   | 2022-12-24 13:33:49 +0000 |
-| finish_time  | 2022-12-24 13:33:49 +0000 |
-| duration     | 0.001777756               |
-| unique_fault | 0                         |
-| max_weight   | 1.0                       |
-| good_weight  | 1.0                       |
-| fail_weight  | 0.0                       |
-| fail_counter | 0                         |
-| grade        | 100                       |
-+--------------+---------------------------+
-```

data/docs/learn/04-new_test.md

@@ -1,87 +0,0 @@
-
-[<< back](README.md)
-
-# Example: 04-new_test
-
-Steps:
-1. Create skeleton
-2. Personalize targets
-3. Personalize configuration file
-4. Run the challenge
-
-## STEP 1: Create skeleton
-
-Create skeleton for a new project: `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: It is posible to create these files by hand.
-
-This command will create:
-
-| File/Directory  | Description    |
-| --------------- | -------------- |
-| foo             | Base directory |
-| foo/start.rb    | Main Script    |
-| foo/config.yaml | YAML configuration file |
-
----
-
-## STEP 2: Personalize targets
-
-Write your own targets using the keywords: `target`, `run` and `expect`. Let's see:
-
-```ruby
-group "Create new test" do
-  target "Exist </home/vader> directory"
-  run "file /home/vader", on: :host1
-  expect_none "No such file or directory"
-end
-```
-
-The above example checks if exists '/home/david' directory, into *host1* device.
-
-> Let's see the keywords used:
->
-> * `target "Exist </home/vader> directory"`, Describe the target with our words, so every one could easily understand what we are trying
-to check.
-> * `run "file /home/vader", on: :host1`, : Execute the command into the remote machine (host1).
-> * `  expect_none "No such file or directory"`: Compare command ouput with our expectations.
-
-## STEP 3: Personalize Configfile
-
-Use a YAML file (`foo/config.yaml`) or JSON for your own configurations. In this example, the file contains params used by our challenge (script).
-
-**Example**:
-
-```yaml
----
-:global:
-  :host1_username: root
-:cases:
-- :tt_members: student-name-01
-  :host1_ip: 1.1.1.1
-  :host1_password: root-password-student-01
-- :tt_members: student-name-02
-  :host1_ip: 2.2.2.2
-  :host1_password: root-password-student-02
-```
-
-> The above file configures 2 differents cases with their own params. The script use this information when execute every case.
-
-## STEP 4: run the challenge
-
-Now we only have to run the challenge:
-
-```bash
-> teuton run foo
-```
-
-Output files are saved into `var/foo` directory.

data/docs/learn/06-debug.md

@@ -1,110 +0,0 @@
-
-[<< back](README.md)
-
-# Example: 06-debug
-
-Learn how to:
-* Check test syntax.
-* Debug your tests.
-
-1. [Tree directory](#tree-directory)
-2. [Execution section](#execution-section)
-3. [Check test](#check-test)
-4. [Debug](#debug)
-
-## Tree directory
-
-```
-> tree learn/learn-06-debug
-
-example/learn-06-debug
-├── config.yaml
-├── external.rb
-├── internal.rb
-├── README.md
-└── start.rb
-```
-
-## Execution section
-
-The `start.rb`  is main execution rb file, and uses `external` and `internal` rb files.
-
-Let's see current `start.rb` file:
-
-```ruby
-use 'external'
-use 'internal'
-
-play do
-  show
-  export :format => :colored_text
-end
-```
-
-## Check test
-
-Tests grows and becames huge, with a lot of targets (That isn't a problem). Then, we organize them spliting into several files and invoke `use` keywork from our main rb file to load other files (That's good idea) .
-
-When this happend, sometimes we need to verify or check rb file consistency and syntax, and we will do it with `teuton check PATH/TO/PROJECT/FOLDER`.
-
-Let's see example `teuton check examples/learn-01-target`:
-
-```
-+----------------------------+
-| GROUP: Learn about targets |
-+----------------------------+
-(001) target      Create user david
-      weight      1.0
-      run         'id david' on localhost
-      expect      david (String)
-
-+--------------+-------+
-| DSL Stats    | Count |
-+--------------+-------+
-| Groups       | 1     |
-| Targets      | 1     |
-| Goto         | 1     |
-|  * localhost | 1     |
-| Uniques      | 0     |
-| Logs         | 0     |
-|              |       |
-| Gets         | 0     |
-| Sets         | 0     |
-+--------------+-------+
-+----------------------+
-| Revising CONFIG file |
-+----------------------+
-[WARN] File /home/david/proy/repos/teuton.d/teuton/examples/01-target/config.yaml not found!
-[INFO] Recomended content:
----
-:global:
-:cases:
-- :tt_members: VALUE
-
-```
-
-In this case, Teuton detects that there isn't exist config file, and propose us content for `config.yaml`.
-
-## Debug
-
-Every time we invoke `run` or `goto` keywork, an OS command is executed. The output is showed on screen and saved into **result** internal object.
-
-We could debug it invoking `result.debug` into our tests. Let's see an example from `external.rb` file:
-
-```ruby
-group "Windows: external configuration" do
-
-  target "Localhost: Verify connectivity with #{gett(:windows1_ip)}"
-  run    "ping #{get(:windows1_ip)} -c 1"
-  result.debug
-  expect_one "0% packet loss"
-  result.debug
-
-  target "Localhost: netbios-ssn service working on #{gett(:windows1_ip)}"
-  run    "nmap -Pn #{get(:windows1_ip)}"
-  expect "139/tcp", "open"
-
-end
-```
-
-`result.debug` it's usefull when you are verifying command output captured by Teuton.

data/docs/learn/11-moodle_id.md

@@ -1,19 +0,0 @@
-[<< back](README.md)
-
-# Example: 11-moodle_id
-
-If you are a teacher and are using the Moodle platform, probably you will want to upload the results of the evaluation carried out by Teuton in Moodle.
-
-Teuton generates a file called "moodle.csv" with the grades of each student. Only have to import the file into Moodle.
-
-In the configuration file "config.yaml" add a field called "moodle_id" to each case. Fill it with the student's identification (For example, the email registered on the Moodle).
-
-Example:
-```
-global:
-cases:
-- tt_members: Darth Vader
-  tt_moodle_id: vader@starwars.com
-- tt_members: Obiwan Kenobi
-  tt_moodle_id: obiwan@starwars.com
-```