Project

tf

0.01
No commit activity in last 3 years
No release in over 3 years
Testing Framework solely based on plugins. For now only tests using Bash.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

~> 3.1
 Project Readme

Testing Framework Code Climate Build Status

TF is a pluggable framework for testing shell scripts (at least now). TF also is an umbrella which incorporates (eventually) multiple gems, each of which provides additional functionality to TF. TF is the skeleton upon which all other tf-* gems build.

Usage

$ gem install tf
$ tf <path/to/file>_comment_test.sh
$ tf --text <path/to/file>_comment_test.sh

Comment tests

Filename has to end with _comment_test.sh

Example test file:

## User comments start with double #
## command can be written in one line with multiple tests:
true # status=0; match=/^$/
## or tests can be placed in following lines:
false
# status=1

Matchers

The test can be negated by replacing = with !=

  • status= - check if command returned given status (0 is success)
  • match=// - regexp match command output both stdout and stderr
  • match[stdout|stderr]=// - regexp match command either stdout or stderr
  • env[<var_name>]=~// - regexp match the given environment variable name
  • env[<var_name>]?=[array|string|nil] - verify type of the given environment variable name
  • env[<var_name>][]= - verify size of the given environment variable name
  • env[<var_name>][]=// - regexp match all of elements of the given environment variable name
  • env[<var_name>][]=// - regexp match given element of the given environment variable name

Selecting shell / runner program

From version 0.3.1 Shebang lines are read and interpreted to select the runner shell. Still only Bash / ZSH like shells are allowed.

Example

$ bin/tf example_tests/comment/*
F..
##### Processed commands 2 of 2, success tests 2 of 3, failure tests 1 of 3.
$ false
# failed: status = 0 # was 1

$ bin/tf example_tests/comment/* --text
##### starting test failure.
$ false
# failed: status = 0 # was 1
##### starting test success.
$ true
# passed: status = 0
# passed: status != 1
##### Processed commands 2 of 2, success tests 2 of 3, failure tests 1 of 3.

Troubleshooting

Use environment variable TF_DEBUG to enable additional logging:

TF_DEBUG=1 tf --text  example_tests/comment/*

Internal architecture

Framework will load plugins from any available gem and local lib/ path, for example:

lib/plugins/tf/text_output.rb
lib/plugins/tf/status_test.rb
lib/plugins/tf/comment_test_input.rb

The search pattern is:

lib/plugins/tf/*.rb

And plugins are selected with:

lib/plugins/tf/*_{input,test,output}.rb

Thanks

  • Deryl R. Doucette