From a881720a67e21568654fae7c37993a94cc8b0807 Mon Sep 17 00:00:00 2001 From: Uesli Almeida Date: Tue, 16 Nov 2021 18:10:42 -0300 Subject: [PATCH] Update config example. --- README.md | 29 ++++++++++++++++------------- 1 file changed, 16 insertions(+), 13 deletions(-) diff --git a/README.md b/README.md index 5906720..114e104 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,5 @@ -jira-codeception-extension -============================= +# jira-codeception-extension + This package provides an extension for Codeception to create issues in Jira automatically when a test fails. ### How it works? @@ -7,22 +7,23 @@ This package provides an extension for Codeception to create issues in Jira auto When you run a test and it fails the extension will connect with your Jira instance through the Jira API and create an issue containing the data generated by Codeception at the moment of the failure. The number of issues created will vary depending on the number of failed tests, if two tests failed then two separated issues will be created. The issue will contain the following data: -- Test Name -- Failure Message -- Failed Step -- File Name + +- Test Name +- Failure Message +- Failed Step +- File Name - Stack Trace ### Configuration Example -This extension creates a Jira issue after a test failure. To use this extension a valid Jira configuration is required. +This extension creates a Jira issue after a test failure. To use this extension a valid Jira configuration is required. -- host: A Jira instance. -- user: A valid user that has permission to create issues in the specified project. -- token: A valid token for the specified user. The API will not accept the user password so a token is required. You can create a token in the user configuration panel, for more information follow the Jira official documentation [here](https://confluence.atlassian.com/cloud/api-tokens-938839638.html). -- projectKey: A valid Jira project key (e.g. TA, ZTE, ETC). -- issueType: Usually the issue is created as a Bug but you can change it for Task or another valid issue type available in your Jira instance. -- debugMode: In case you are creating tests or debugging tests you may not want to create issues (and I don't recommend it) so setting this config to true the extension will not create issues in production set it back to false. +- host: A Jira instance. +- user: A valid user that has permission to create issues in the specified project. +- token: A valid token for the specified user. The API will not accept the user password so a token is required. You can create a token in the user configuration panel, for more information follow the Jira official documentation [here](https://confluence.atlassian.com/cloud/api-tokens-938839638.html). +- projectKey: A valid Jira project key (e.g. TA, ZTE, ETC). +- issueType: Usually the issue is created as a Bug but you can change it for Task or another valid issue type available in your Jira instance. +- debugMode: In case you are creating tests or debugging tests you may not want to create issues (and I don't recommend it) so setting this config to true the extension will not create issues in production set it back to false. Configuration 'codeception.yml' example: @@ -36,4 +37,6 @@ Configuration 'codeception.yml' example: token: Tg7womaGGFpn9EC16qD3L7T6 projectKey: JE issueType: Bug + label: + - autotest_bug debugMode: false