Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Coyote is a test agent. It uses a yml configuration file with commands to setup (stdin, env vars, etc) and run. It checks the output for errors and may further search for the presence or absence of specific regular expressions. Finally it creates a html report with the tests, their outputs and some statistics.

Part of Landoop™ test suite

build status report card chat


The only requirement is the Go Programming Language, at least version 1.10+.

$ go get -u

This command will install the Coyote in $PATH (setup your $GOPATH/bin if you didn't already).


Getting your tests ran by the coyote -c command.

$ coyote -c my-test.yml -c my-second-test.yml # or -c ./my-tests-folder to load all yaml tests from a particular folder

The above command will run against those tests described in the passed test files and will generate a rich report inside the ./coyote.html template file before exit. The exit code of coyote is the number of failed tests, up to 254 failed tests. For 255 or more failed tests, the exit code will remain at 255.

The coyote.html template file needs a web server to be displayed correctly, you can use any web server to achieve this, like iris or python's httpserver module, it's up to you, i.e cd ./my-tests-folder && python -m http.server 8000, open a new browser tab and navigate to the http://localhost:8000/coyote.html.

The best example for understanding how to setup a coyote test, would be the kafka-tests.yaml which we use to test our Kafka setup for the Landoop Boxes.

coyote screenshot

Note that coyote stores the stderr and stdout of each command in memory, so it isn't suitable for testing commands with huge outputs


Sample entry in configuration yml file, overview of workdir, nolog and partially match of the standard output:

- name: Test 1
    - name: Command 1
      command: ls /
       - match: ["my-folder", "my-file.txt"]
         partial: true

    - name: Command 2
      command: ls
      workdir: /home

    - command: ls /proc
      nolog: true
  1. name is the test's group name,
  2. entries contains the tests under that group, groups are seen separated in the report page (coyote.html),
  3. command is the shell command that we want to test its output, it's required,
  4. match under the stdout will compare the command's output with the slice of text inside it, you can add more than one expected output,
  5. the partial: true under the stdout will tell the tester that we don't want to do an exact matching, just check if "my-folder" or "my-file.txt" is part of the command's output.
  6. the nolog tells the tester that we don't want to log anything from that particular command in the coyote's output.


Timeout will stop the command's execution when duration passed.

- name: Test 2
    - name: Long running command
      command: cat
      timeout: 300s
      stdin: hello


An option you may add to your groups or per command is skip. This option will skip the test if set to (case insensitive) true. Please note that this isn't a boolean option but rather a string.

The idea behind it is that you can have a test like this:

- name: test 1
  skip: _test1_
- name: test 2
  skip: _test2_

And then you can easily switch off parts of the test using sed or other tools.


Current: v1.4.0

Read more about Semantic Versioning 2.0.0


Distributed under GPLv3, See COPYING for more information.

You can’t perform that action at this time.