Skip to content

Exports user stories structured as themes and epics from TestRail into a CSV

License

Notifications You must be signed in to change notification settings

gresham-computing/testrail-story-exporter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 

Repository files navigation

TestRail User Story Exporter

Exports user stories from TestRail into a CSV. It expects a structure of directories named "Theme - $themeName" and "Epic - $epicName" to work correctly.

Acceptance criteria, BDD, and other comments aren't handled. This assumes that any section that doesn't have any children is supposed to be a story, and sections that do have children are groupings of stories and not stories themselves.

Configuration

You need a testrail.ini file in this directory that looks like this:

[testrail]
Username = MyTestrailUsername
ApiKey = MYTESTRAILAPIKEY
Server = myserver.testrail.net
SuiteId = 13

It's added to the .gitignore for security purposes (so you don't accidentally submit API credentials to a git repo).

See the TestRail Documentation for information about generating API keys.

Usage

Invoke as a python module

python3 -m exporter

You'll get some output explaining any stories that couldn't be parsed. In this directory you'll get a stories.csv file as output.

About

Exports user stories structured as themes and epics from TestRail into a CSV

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages