Quickly answer the question โWhy the @*$% does this code exist?โ
- Integration with Jira or CA Agile Central to quickly access historical work items or issues
- Frequent contributors
- Commits across the last year of the file
$ # Why do these lines of code exist
$ tribe blame -L100,105 model/user.rb
$ # See basic information about your work items or issues
$ tribe show HIL-78
The configuration for tribe is stored in $HOME/.tribe.json. Currently the only configuration is the work item servers you want tribe to understand. Below is an example format.
{
"workitemservers": {
"rally1": {
"type": "rally",
"host": "https://<cool rally server>",
"apikey": "<rally api key here>",
"matcher": "(S|DE|F|s|de|f)[0-9][0-9]+"
},
"myjira": {
"type": "jira",
"host": "https://<cool jira server>",
"username": "<jira username>",
"password": "<jira password>",
"matcher": "HIL-[0-9]+"
}
}
}
You can have as many workitemservers
as you want. Tribe will search through all the servers defined in this section looking for matched work items in your commits.
- As the code is currently implemented, you will need to obtain an API Key from Rally. You can access your API Key at - https://rally1.rallydev.com/login/ on the API KEYS tab.
- The
matcher
for your Rally subscription depends on how your workspaces are setup in Rally. The starting letters of your Artifacts can be changed by your workspace administrator. See above for an example matcher. - Work items may not display correctly if the work item has been deleted or in a closed project or you don't have permissions to read that work item.
- If the JIRA server is public, you can leave off the username/password from it's configuration.
- Work items may not display correctly if the work item has been deleted or you don't have permissions to read that work item.
- Fork this repo
- Create a feature branch
- Commit your changes
- Rebase your local changes against the master branch
- Run test suite with the
go test ./...
command and confirm that it passes - Run
gofmt -s
- Create new pull request
$ go get -u github.com/heysquirrel/tribe