talismanic/tama repository overview

⁠What is TAMA

Test Pattern Miner for Ansible is a tool that identifies testing pattern instances that correlate with the appearance of bugs in Ansible test scripts. TAMA parses the relevant test YAML files of a repository where Ansible has been used and indicates some patterns like Assertion Roulette, Linter Strangler, Local Only Testing and Remote Mystery Guest.

⁠How to Use TAMA

⁠Pull TAMA

Download docker image from docker hub with below command:

docker pull talismanic/tama

⁠Run TAMA

Run the docker container binding the volume of the IaC (ansible) Project. For example, if project directory is /usr/project/name then we will run the following command:

docker run -v /usr/project/name:/src -it talismanic/tama

⁠Give your project name

TAMA will ask for the name of the project. Give it a name as per your wish.

⁠Check the findings

TAMA will scan the ansible test files and produce the output in the Ansible project directory. File name convention will be projectName_output.csv

⁠Supported Tags

As we are under active development, currently we only support the :latest tag.

⁠Maintained By

Paser Group⁠

Auburn University.

⁠Source Code

Github⁠