Gem Version GitHub

Test your infrastructure as code.

logo

The infrastructure test is useful for:

• Sysadmin teachers who want to evaluate students remote machines.
• Students who want to evaluate their learning process.
• Professionals who want to monitor their remote machines.

Install Ruby and then:

gem install teuton

Create your test file:

# File: examples/02-target/start.rb 
group "Learn about targets" do
 target "Create user obiwan", weight: 2
 run "id obiwan"
 expect ["uid=", "(obiwan)", "gid="]
 target "Delete user vader"
 run "id vader"
 expect_fail
end
start do
 show
 export
end

Usage: Run test with teuton run TESTPATH.

$ teuton run examples/02-target
------------------------------------
Started at 2025年12月01日 18:14:44 +0000
F.
Finished in 0.005 seconds
------------------------------------

CASE RESULTS
+------+-----------+-------+-------+
| CASE | MEMBERS | GRADE | STATE |
| 01 | anonymous | 33.0 | ? |
+------+-----------+-------+-------+

Output: reports saved into var/TESTNAME folder.

$ tree var 
var
└── 02-target
 ├── case-01.txt
 ├── moodle.csv
 └── resume.txt

Consult the generated output files

• Use simple DSL to define your tests: target, run,expect and more.
• Remote devices only require SSH or Telnet service installed.
• Output format: txt, html, json, yaml, markdown, etc.
• Multiplatform.
• Free Software License.

• Installation
  • Teuton installation
  • SSH/Telnet installation
• Teuton commands
  • teuton config
  • teuton check
  • teuton help
  • teuton new
  • teuton readme
  • teuton run
• Learning guide. Learning to create tests by doing.
• Learning Examples. The learning guide is based on these examples.
• Configuration file
• DSL - Language reference. DSL used to define tests.
  • expect
  • export
  • get
  • group
  • play
  • result
  • run
  • send
  • set
  • show
  • target
• Modes of use: Classroom, contest, standalone.
• Blogs and videos

• Email: teuton.software@protonmail.com

1. Make sure you have Ruby installed
2. Fork it
3. Create your feature branch (git checkout -b my-new-feature)
4. Commit your changes (git commit -am 'Add some feature')
5. Push to the branch (git push origin my-new-feature)
6. Create new Pull Request.

You can also create issues with your requests, incidences or suggestions.