gotl
Run and view Go test results grouped by package and test cases. Read logs for each test case separately.
Installation
Pre-built binaries can be found under the releases section on Github for each major operating system.
The binary can also be installed with cargo from crates.io or Github.
Usage
The application uses vim keybindings for navigation:
- j/k/down/up: Navigate up and down
- g/home: Move to top
- G/end: Move to bottom
- ctrl+f/page down: Move one page down
- ctrl+b/page up: Move one page up
- ctrl+d: Move half page down
- ctrl+u: Move half page up
- esc/q: Close current screen (quit when last screen is closed)
Tests screen
The first screen shown after test runs are finished are the tests screen. It groups tests by packages. The circles indicates the result of the given package or test case:
- Gray circle: Test is skipped
- Green filled circle: Test has passed
- Red filled circle: Test has failed
By default all test packages and cases are visible. The visibility of test cases can be switched on and off by test result categories:
- S: Toggle skipped test visibility
- P: Toggle passed test visibility
- F: Toggle failed test visibility
The bar at the bottom shows how many tests are passed, failed or skipped and whether they are visible or not.
On startup only test packages are visible. To see the test cases of a package, it has to be selected and expanded with either the l or right key. h or left key can be used to collapse packages.
The enter key will switch to the log screens for the selected test package or case.
To search for specific test package or case by name, the / key switches to search mode where search term can be given. Pressing enter memos the search term and the p and n key can be used to go to the previous and next occurence respectively. Pressing esc in search mode clears this memo.
Tests can be run again by pressing the ctrl+r key.
Log screen
This is where logs can be read for a given test package or case. If structured logging is used in JSON format pressing enter will show the details screen for the given line. This let's you inspect the JSON value. When the log line is plain text the details screen will just show the line wrapped.
Details screen
This screen let's you investigate JSON formatted log lines. When the current value is an object or array j/down and k/up can be used to select properties/items and the enter key can be used to dive into the selected value. Pressing q/esc will return to the previous screen.