Rspec to TestRail Gem
TestRail (http://www.gurock.com/testrail/) is one of the best test case management software available. It has available APIs which can be used to mark your automated test results. If you label your RSPEC tests with TestRail testcase numbers, then you can automatically mark the test results via API calls.
This gem installs a command line tool that parses through all your RSPEC XML results file or Squish results file and marks all the test cases (Passed, Failed, ...) via API calls. This is a very useful tool to mark your test cases after running your automation tests using RSpec or Squish tests.
Installation
Install it yourself as:
$ gem install trail_marker
##Usage
To Use:
$ testrail_marker.rb -p Test Project Name -r test_run_auto -x ../some/directory/results
Arguments required:
-p Name of Project
-r or -t, Name of test run or test plan to mark
-x Directory path where XML test results are located
For RSPEC files: Tag all the tests with the correct test case
Ex:
it “should login to Server as a regular user (TestRail: C27)” do
=> This would mark TestRail cases number 27
it “should logout of server (TestRail: C11, C12 )” do
=> This would mark two test cases, number 11 and 12, at the same time
For SquishReport (Not sure how this is formatted - please edit): Tag all verification name with the correct test case
Ex (results XML should be):
<verification line="114" type="" name=“Transfer (TestRail: C76, C92) " file="C:/ancd/aaa/suite_connections/tst_clone/test.rb">
<result type="PASS" time="2015-07-06T11:20:58-07:00">
<description>Comparison</description>
</result>
</verification>
NOTE: You can associate multiple Test Cases to a single automated test if needed by separating each test case number by a comma (TestRail: C111, C222, …)
Other Options
-h, Show HELP
-p *, name of project (e.g. Production Push) (required parameter)
-r or -t *, name of test run (-r) or test plan (-t) (required parameter)
-m, milestone name (can be used when creating a test run)
-s, test suite name (* required when creating a test run)
-u, user (e.g. ibarra@gmail.com)
-pw, password or token (recommended)
-url, URL of TestRail (e.g. https://test.mycompany.com/testrail)
-d, debug mode (set to false to suppresses most messages)
-x or -f *, path (-x, Directory) or specific file (-f) for results to parse
-com, comment to put on each test
'-cm', '-cr', '-ct' => Creates milestones, runs, or test plan
'-dm', '-dr', '-dt' => Deletes milestones, runs, test plan