TestRail-Cucumber Mapper

This tool is designed to help you map Cucumber feature files to TestRail. It will create a new Section in testRail if it does not exist and upload the feature file to the testRail. For each scenario in the feature file, it will create a new test case in the testRail and map the test case to the scenario. Also It can be used to upload multiple feature files in a directory to TestRail (in-progress).

Features

• Map Cucumber feature files to TestRail
• Create a new Section in TestRail if it does not exist
• Create a new test case in TestRail for each scenario in the feature file
• Map the test case to the scenario
• Upload multiple feature files in a directory to TestRail (in-progress)
• Update the existing test cases (in-progress)
• Add Tags in Refs and Other Fields (in-progress)
• Add Functionality for Test Run (in-progress)
• Dockerize the Application to run from CI (in-progress)

Installation

You can install the TestRail-Cucumber Mapper globally using npm:

git clone [email protected]:afsarali-pg/testrail-cucumber-mapper.git
cd testrail-cucumber-mapper
npm install
npm run compile

# Now you can access the command line tool
testrail

Usage

Authentication

Before using TestRail-Cucumber Mapper, you need to set up your TestRail credentials. You can do this by running:

export TR_USERNAME=<your_username>
export TR_PASSWORD=<your_password>
export TR_URL=<your_testrail_url>

Or you can use .env file:

Mapping Test Cases

To map TestRail test cases to Cucumber scenarios, you can run the following command:

tesrail

Then Follow the prompts to map the test cases to the cucumber scenarios.

Contributing

Contributions are welcome! If you'd like to contribute to TestRail-Cucumber Mapper, please follow these steps:

1. Fork the repository.
2. Create your feature branch: git checkout -b feature/my-feature.
3. Commit your changes: git commit -am 'Add my feature'.
4. Push to the branch: git push origin feature/my-feature.
5. Submit a pull request.

Version

Current version: 1.0.1

TODO

• [x] Upload Single Cucumber Feature File to TestRail
• [ ] Upload Multiple Cucumber Feature Files in a directory to TestRail
• [ ] Add Tags in Refs and Other Fields
• [ ] Add Functionality to update the existing test cases
• [ ] Add Functionality for Test Run
• [ ] Dockerize the Application to run from CI

License

This project is licensed under the MIT License.