Merge pull request #512 from go-jira/v3-api-search

update for v3 search api

.chglog/CHANGELOG.tpl.md

@@ -0,0 +1,60 @@
+{{ if .Versions -}}
+<a name="unreleased"></a>
+## [Unreleased]
+
+{{ if .Unreleased.CommitGroups -}}
+{{ range .Unreleased.CommitGroups -}}
+### {{ .Title }}
+{{ range .Commits -}}
+- [{{.Hash.Short}}]({{ $.Info.RepositoryURL  }}/commit/{{ .Hash.Long }}): {{ .Subject }}
+{{ if .Refs -}}{{ range .Refs }} -{{if .Action}}{{ .Action }} {{ end }} [#{{ .Ref }}]({{ $.Info.RepositoryURL  }}/issues/{{ .Ref }}){{ end -}}
+{{ end -}}
+{{ end -}}
+{{ end -}}
+{{ end -}}
+
+{{ range .Versions }}
+<a name="{{ .Tag.Name }}"></a>
+## {{ if .Tag.Previous }}[{{ .Tag.Name }}]{{ else }}{{ .Tag.Name }}{{ end }} - {{ datetime "2006-01-02" .Tag.Date }}
+{{ range .CommitGroups -}}
+### {{ .Title }}
+{{ range .Commits -}}
+- [{{.Hash.Short}}]({{ $.Info.RepositoryURL  }}/commit/{{ .Hash.Long }}): {{ .Subject }}
+{{ if .Refs -}}{{ range .Refs }} - {{if .Action}}{{ .Action }}{{ end }} [#{{ .Ref }}]({{ $.Info.RepositoryURL  }}/issues/{{ .Ref }}){{ end -}}
+{{ end -}}
+{{ end -}}
+{{ end -}}
+
+{{- if .RevertCommits -}}
+### Reverts
+{{ range .RevertCommits -}}
+- {{ .Revert.Header }}
+{{ end }}
+{{ end -}}
+
+{{- if .MergeCommits -}}
+### Pull Requests
+{{ range .MergeCommits -}}
+- {{ .Header }}
+{{ end }}
+{{ end -}}
+
+{{- if .NoteGroups -}}
+{{ range .NoteGroups -}}
+### {{ .Title }}
+{{ range .Notes }}
+{{ .Body }}
+{{ end }}
+{{ end -}}
+{{ end -}}
+{{ end -}}
+
+{{- if .Versions }}
+[Unreleased]: {{ .Info.RepositoryURL }}/compare/{{ $latest := index .Versions 0 }}{{ $latest.Tag.Name }}...HEAD
+{{ range .Versions -}}
+{{ if .Tag.Previous -}}
+[{{ .Tag.Name }}]: {{ $.Info.RepositoryURL }}/compare/{{ .Tag.Previous.Name }}...{{ .Tag.Name }}
+{{ end -}}
+{{ end -}}
+{{ end -}}
+{{ end -}}

.chglog/config.yml

@@ -0,0 +1,29 @@
+style: github
+template: CHANGELOG.tpl.md
+info:
+  title: CHANGELOG
+  repository_url: https://github.com/go-jira/go-jira
+options:
+  commits:
+    sort_by: Scope
+  commit_groups:
+    group_by: Scope
+  header:
+    pattern: '^(.*):\s*(.*)$'
+    pattern_maps:
+      - Scope
+      - Subject
+  issues:
+    prefix: 
+      - "#"
+
+  refs:
+    actions:
+      - Closes
+      - Fixes
+      - PullRequest
+
+  notes:
+    keywords:
+      - BREAKING CHANGE
+      - NOTE

.github/CODEOWNERS

@@ -0,0 +1,2 @@
+# one of these users must approve the PR before merging
+* @coryb @mikepea @ldelossa @georgettica

.github/workflows/main.yml

@@ -0,0 +1,23 @@
+---
+name: CI
+
+on: [push, pull_request]
+
+jobs:
+  tests:
+    name: Tests
+    runs-on: ubuntu-latest
+    container: docker.io/library/golang:${{ matrix.go }}
+    strategy:
+      matrix:
+        go: ['1.13', '1.14']
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+      - name: add gox
+        run: go install github.com/mitchellh/gox
+      - name: make binaries
+        run: make all
+      - name: perform tests
+        run: go test -v ./...
+

.github/workflows/prepare-release.yml

@@ -0,0 +1,40 @@
+---
+name: Prepare Release
+
+on:
+  workflow_dispatch:
+    inputs:
+      branch:
+        description: 'the branch to prepare the release against'
+        required: true
+        deault: 'master'
+      tag:
+        description: 'the tag to be released'
+        required: true
+
+jobs:
+  prepare:
+    name: Prepare Release
+    runs-on: 'ubuntu-latest'
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+        with:
+          fetch-depth: 0
+          ref: ${{ github.event.inputs.branch }}
+      - name: Changelog
+        shell: bash
+        run: |
+          curl -L -o /tmp/git-chglog.tar.gz  https://github.com/git-chglog/git-chglog/releases/download/v0.14.2/git-chglog_0.14.2_linux_amd64.tar.gz
+          tar xf /tmp/git-chglog.tar.gz -C /tmp git-chglog
+          chmod u+x /tmp/git-chglog
+          echo "creating change log for tag: ${{ github.event.inputs.tag }}"
+          /tmp/git-chglog --next-tag "${{ github.event.inputs.tag }}" -o CHANGELOG.md
+      - name: Create Pull Request
+        uses: peter-evans/create-pull-request@v3.8.2
+        with:
+          title: "${{ github.event.inputs.tag }} Changelog Bump"
+          body: "This is an automated changelog commit."
+          commit-message: "chore: ${{ github.event.inputs.tag }} changelog bump"
+          branch: "ready-${{ github.event.inputs.tag }}"
+          signoff: "gh-actions"

.github/workflows/release.yml

@@ -0,0 +1,103 @@
+---
+name: Release
+
+on:
+  push:
+    tags:
+      - v1.*
+
+jobs:
+  release:
+    name: Release
+    runs-on: 'ubuntu-latest'
+    container: docker.io/library/golang:1.14
+    steps:
+      # This step is for local testing using https://github.com/nektos/act
+      - name: install node
+        run: |
+          apt update 
+          apt install -y nodejs
+      - name: Setup
+        run: |
+          tag=`basename ${{ github.ref }}`
+          echo "VERSION=${tag}" >> $GITHUB_ENV
+      - name: Checkout
+        uses: actions/checkout@v2
+        with:
+          fetch-depth: 0
+      - name: add gox
+        run: go install github.com/mitchellh/gox
+      - name: ChangeLog
+        shell: bash
+        run: |
+          curl -o git-chglog -L https://github.com/git-chglog/git-chglog/releases/download/0.9.1/git-chglog_linux_amd64
+          chmod u+x git-chglog
+          tag=`basename ${{ github.ref }}`
+          echo "creating change log for tag: $tag"
+          chglog="$(./git-chglog ${tag})"
+          chglog="${chglog//'%'/'%25'}"
+          chglog="${chglog//$'\n'/'%0A'}"
+          chglog="${chglog//$'\r'/'%0D'}"
+          echo "CHANGELOG=${chglog}" >> $GITHUB_ENV
+      - name: Create Release
+        id: create_release
+        uses: actions/create-release@latest
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          tag_name: ${{ github.ref }}
+          release_name: ${{ env.VERSION }} Release
+          body: |
+            ${{ env.CHANGELOG }}
+          prerelease: ${{ contains(env.VERSION, 'alpha') || contains(env.VERSION, 'beta') || contains(env.VERSION, 'rc') }}
+      # perform production release of artifacts
+      - name: Build Artifacts
+        run: |
+          VERSION=${{ env.VERSION }} make all
+      - name: "Publish Darwin AMD64"
+        uses: actions/upload-release-asset@v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          upload_url: ${{ steps.create_release.outputs.upload_url }}
+          asset_path: ./dist/github.com/go-jira/jira-darwin-amd64
+          asset_name: jira-darwin-amd64
+          asset_content_type: application/octet-stream
+      - name: "Publish Linux 386"
+        uses: actions/upload-release-asset@v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          upload_url: ${{ steps.create_release.outputs.upload_url }}
+          asset_path: ./dist/github.com/go-jira/jira-linux-386
+          asset_name: jira-linux-386
+          asset_content_type: application/octet-stream
+      - name: "Publish Linux AMD64"
+        uses: actions/upload-release-asset@v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          upload_url: ${{ steps.create_release.outputs.upload_url }}
+          asset_path: ./dist/github.com/go-jira/jira-linux-amd64
+          asset_name: jira-linux-amd64
+          asset_content_type: application/octet-stream
+      - name: "Publish Windows 386"
+        uses: actions/upload-release-asset@v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          upload_url: ${{ steps.create_release.outputs.upload_url }}
+          asset_path: ./dist/github.com/go-jira/jira-windows-386.exe
+          asset_name: jira-windows-386.exe
+          asset_content_type: application/octet-stream
+      - name: "Publish Windows AMD64"
+        uses: actions/upload-release-asset@v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          upload_url: ${{ steps.create_release.outputs.upload_url }}
+          asset_path: ./dist/github.com/go-jira/jira-windows-amd64.exe
+          asset_name: jira-windows-amd64.exe
+          asset_content_type: application/octet-stream
+
+

.gitignore

@@ -1,15 +1,12 @@
-bin/
-pkg/
-src/code.google.com/
-src/github.com/docopt/
-src/github.com/mgutz/
-src/github.com/op/
-src/gopkg.in/
 jira
-jira.exe
 schemas/*.json
-t/issue.props
-t/.jira.d/templates
-dist/
-src/
-t/.maven-cache
+/_t/.gnupg/random_seed
+/_t/issue.props
+/_t/attach.props
+/_t/garbage.bin
+/_t/attach1.txt
+/_t/binary.out
+/_t/foobar.bin
+/_t/.password-store/GoJira/api-token:gojira@corybennett.org.gpg
+/_t/.password-store/GoJira/api-token:mothra@corybennett.org.gpg
+dist

.jira.d/config.yml

@@ -0,0 +1,12 @@
+config:
+  stop: true
+password-source: pass
+endpoint: https://go-jira.atlassian.net
+user: admin
+login: atlassian@corybennett.org
+
+queries:
+  todo: |
+    resolution = unresolved {{if .project}}AND project = '{{.project}}'{{end}} AND status = 'To Do'
+  open: |
+    resolution = unresolved {{if .project}}AND project = '{{.project}}'{{end}} AND status = 'Open'

.travis.yml

@@ -1,17 +0,0 @@
-sudo: true
-before_install:
-    - sudo apt-get update && sudo apt-get install -y pass gnupg
-
-language: go
-
-go:
-  - 1.6
-
-matrix:
-  fast_finish: true
-  
-script:
-  - make vet
-  - make lint
-  - make
-  - make prove 2>&1 

CHANGELOG.md

@@ -1,214 +1,513 @@
-# Changelog
+<a name="unreleased"></a>
+## [Unreleased]
+
+
+<a name="v1.0.28"></a>
+## [v1.0.28] - 2021-05-05
+
+<a name="v1.0.27"></a>
+## [v1.0.27] - 2020-10-01
+### Block
+- [f7587f4](https://github.com/go-jira/go-jira/commit/f7587f43f12bcf0b47e52a5abe775daf6cbb3229): reverse order of arguments
+### Chore
+- [2c7a9b2](https://github.com/go-jira/go-jira/commit/2c7a9b283025202428db629b1a9ecdc63a9b704f): V1.0.27 changelog bump
+### Templates
+- [0e3082f](https://github.com/go-jira/go-jira/commit/0e3082fab6e12a337f5fe26c3e2dec5cb51425d8): add wrap helper function
+
+<a name="v1.0.26"></a>
+## [v1.0.26] - 2020-09-11
+### Chore
+- [c3d22b7](https://github.com/go-jira/go-jira/commit/c3d22b765a6f3cd93445033da5c19fc0feaeaece): v1.0.26 changelog bump
+### Cicd
+- [96ec333](https://github.com/go-jira/go-jira/commit/96ec3339a4cc810da20450a9d9e91612c2b9aad4): automated releases fixes
+- [31f7b03](https://github.com/go-jira/go-jira/commit/31f7b0397890388947f2312cf42af494c7a6979f): automated changelog and release
+
+<a name="v1.0.25"></a>
+## [v1.0.25] - 2020-09-11
+### Bugfix
+- [aa8dae7](https://github.com/go-jira/go-jira/commit/aa8dae7c5b7035e086bd60b3d354ffa43c30caf7): only build jira tool with gox
+### Chore
+- [578c44c](https://github.com/go-jira/go-jira/commit/578c44c628e3134e4d46f3250baf46d6b054cfe8): v1.0.25 release
+### Fix(Changelog)
+- [ff5decc](https://github.com/go-jira/go-jira/commit/ff5decc114b297e9b393f8d4af72bbace0037c73): fix changelog version
+### Tests
+- [a8c961f](https://github.com/go-jira/go-jira/commit/a8c961fe19f424df3fdbe108a374cc56b8ff9fe0): rework passive tests into native go tests
+
+<a name="v1.0.24"></a>
+## [v1.0.24] - 2020-09-04
+### Cicd
+- [d093bcf](https://github.com/go-jira/go-jira/commit/d093bcf63adbd1d4e88640307aa8a5c8669ac535): deflake tests
+### Tests
+- [3bc5e42](https://github.com/go-jira/go-jira/commit/3bc5e42bd0186dbc5c47f022b9528207140fa297): transition if under review
+### Transition
+- [3c1c4d9](https://github.com/go-jira/go-jira/commit/3c1c4d95e199a717499f1f4259649152a6832e9f): map field name to id
+### Username-Deprecation
+- [6a27e28](https://github.com/go-jira/go-jira/commit/6a27e28c61c45f4b2a6aff473cf28852a2df64a2): use email and display names
+### Pull Requests
+- Merge pull request [#367](https://github.com/go-jira/go-jira/issues/367) from bbkane/master
+- Merge pull request [#349](https://github.com/go-jira/go-jira/issues/349) from aszenz/patch-1
+- Merge pull request [#355](https://github.com/go-jira/go-jira/issues/355) from go-jira/vanniktech-patch-1
+- Merge pull request [#323](https://github.com/go-jira/go-jira/issues/323) from tjamet/issue-comment
+
+
+<a name="v1.0.23"></a>
+## [v1.0.23] - 2020-02-26
+### Add Sprig Template Functions, Replaces [#215] Http
+- [719f7a6](https://github.com/go-jira/go-jira/commit/719f7a68a7f2c01e428a1ad3519a611c92268d27): //masterminds.github.io/sprig/
+ -  [#215](https://github.com/go-jira/go-jira/issues/215)### All
+- [31c113d](https://github.com/go-jira/go-jira/commit/31c113d1baf2dba814bca3e1dcc519ab8b0269e9): unindent some code
+- [f125ef3](https://github.com/go-jira/go-jira/commit/f125ef3fa9c7a64e8dfda9a643cadf0241b09bc7): convert to a Go module
+### CI
+- [664c5ca](https://github.com/go-jira/go-jira/commit/664c5cad246cbd4c861b615eb567d3874151d1a1): test on Go 1.12.x, cleanup
+### Docs
+- [d8189f0](https://github.com/go-jira/go-jira/commit/d8189f0a018d1afd364237e51ca8ed43ea1aabb1): update pass documentation with password-name
+### Fixes #228: Make '
+- [52a577e](https://github.com/go-jira/go-jira/commit/52a577ea48afea9efb7a1f4163301129a66f7b76): ' gpg files temporary to fix go mod
+ - Fixes [#228](https://github.com/go-jira/go-jira/issues/228)### Merge Branch 'Make-Password-Source-Binary-Exchangeable' Of Https
+- [e26fbfc](https://github.com/go-jira/go-jira/commit/e26fbfcb142f2ce8c7c33a977d4cf0b436d743eb): //github.com/patrickpichler/jira into patrickpichler-make-password-source-binary-exchangeable
+### README
+- [098d963](https://github.com/go-jira/go-jira/commit/098d963881322c2b2efba48ef6a39f235bdae881): trim down the content
+### T
+- [d237e86](https://github.com/go-jira/go-jira/commit/d237e86cda3812b23f432e90d120ec21e749a854): rename to _t to fix module support
+ - Fixes [#228](https://github.com/go-jira/go-jira/issues/228)### Update All Usage Of User.Name To User.AccountId For Privacy Migration: Https
+- [a26683e](https://github.com/go-jira/go-jira/commit/a26683e01dc7e161e735b1b387d1633bc32da2fe): //developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/
+### Pull Requests
+- Merge pull request [#318](https://github.com/go-jira/go-jira/issues/318) from jrschumacher/patch-1
+- Merge pull request [#317](https://github.com/go-jira/go-jira/issues/317) from go-jira/privacy-migration
+- Merge pull request [#302](https://github.com/go-jira/go-jira/issues/302) from go-jira/simplify-template-tables
+- Merge pull request [#292](https://github.com/go-jira/go-jira/issues/292) from pdecat/cache_password
+- Merge pull request [#301](https://github.com/go-jira/go-jira/issues/301) from go-jira/allow-issue-ints
+- Merge pull request [#286](https://github.com/go-jira/go-jira/issues/286) from patrickpichler/add-gopass-instructions-to-readme
+- Merge pull request [#285](https://github.com/go-jira/go-jira/issues/285) from patrickpichler/add-gopass-support
+- Merge pull request [#283](https://github.com/go-jira/go-jira/issues/283) from go-jira/sprig
+- Merge pull request [#273](https://github.com/go-jira/go-jira/issues/273) from acaloiaro/master
+- Merge pull request [#282](https://github.com/go-jira/go-jira/issues/282) from pcockwell/fix/choose-direct-transition-match-if-available
+- Merge pull request [#280](https://github.com/go-jira/go-jira/issues/280) from go-jira/cut_v1_0_21
+- Merge pull request [#275](https://github.com/go-jira/go-jira/issues/275) from go-jira/remove_gopkg_in
+- Merge pull request [#278](https://github.com/go-jira/go-jira/issues/278) from go-jira/update-figtree
+- Merge pull request [#276](https://github.com/go-jira/go-jira/issues/276) from go-jira/fix_228
+- Merge pull request [#266](https://github.com/go-jira/go-jira/issues/266) from mbethke/fix-multiline-worklog-comment
+- Merge pull request [#263](https://github.com/go-jira/go-jira/issues/263) from kojustin/master
+- Merge pull request [#253](https://github.com/go-jira/go-jira/issues/253) from mvdan/module
+- Merge pull request [#240](https://github.com/go-jira/go-jira/issues/240) from jgraglia/patch-1
+- Merge pull request [#219](https://github.com/go-jira/go-jira/issues/219) from kerhac/master
+- Merge pull request [#236](https://github.com/go-jira/go-jira/issues/236) from CodeLingoBot/rewrite
+- Merge pull request [#245](https://github.com/go-jira/go-jira/issues/245) from justmiles/211
+
+
+<a name="v1.0.22"></a>
+## [v1.0.22] - 2019-09-30
+### All
+- [bb9790f](https://github.com/go-jira/go-jira/commit/bb9790f28783c1b82a3685a9c4657241e906826a): unindent some code
+- [89fe2ec](https://github.com/go-jira/go-jira/commit/89fe2ecf16709511c3e04e02f7c7906a5ac6865a): convert to a Go module
+### CI
+- [80743e4](https://github.com/go-jira/go-jira/commit/80743e4da870a1febcc65d18d08242bb201b744d): test on Go 1.12.x, cleanup
+### Docs
+- [48c15e2](https://github.com/go-jira/go-jira/commit/48c15e2daa7b3f4c84526bd9f030828f378edfc2): update pass documentation with password-name
+### Fixes #228: Make '
+- [3984d0d](https://github.com/go-jira/go-jira/commit/3984d0d4848fdfe790f46ec18bd3b71782e36c32): ' gpg files temporary to fix go mod
+ - Fixes [#228](https://github.com/go-jira/go-jira/issues/228)### README
+- [dc9a9de](https://github.com/go-jira/go-jira/commit/dc9a9de165859057e4596aa47961e84de34b0b4b): trim down the content
+### T
+- [8994b42](https://github.com/go-jira/go-jira/commit/8994b42f714f8fc5b224bda8b5835f003d96ef02): rename to _t to fix module support
+ - Fixes [#228](https://github.com/go-jira/go-jira/issues/228)
+<a name="v1.0.21"></a>
+## [v1.0.21] - 2019-09-16
+### All
+- [31c113d](https://github.com/go-jira/go-jira/commit/31c113d1baf2dba814bca3e1dcc519ab8b0269e9): unindent some code
+- [f125ef3](https://github.com/go-jira/go-jira/commit/f125ef3fa9c7a64e8dfda9a643cadf0241b09bc7): convert to a Go module
+### CI
+- [664c5ca](https://github.com/go-jira/go-jira/commit/664c5cad246cbd4c861b615eb567d3874151d1a1): test on Go 1.12.x, cleanup
+### Docs
+- [d8189f0](https://github.com/go-jira/go-jira/commit/d8189f0a018d1afd364237e51ca8ed43ea1aabb1): update pass documentation with password-name
+### Fixes #228: Make '
+- [52a577e](https://github.com/go-jira/go-jira/commit/52a577ea48afea9efb7a1f4163301129a66f7b76): ' gpg files temporary to fix go mod
+ - Fixes [#228](https://github.com/go-jira/go-jira/issues/228)### README
+- [098d963](https://github.com/go-jira/go-jira/commit/098d963881322c2b2efba48ef6a39f235bdae881): trim down the content
+### T
+- [d237e86](https://github.com/go-jira/go-jira/commit/d237e86cda3812b23f432e90d120ec21e749a854): rename to _t to fix module support
+ - Fixes [#228](https://github.com/go-jira/go-jira/issues/228)### Pull Requests
+- Merge pull request [#275](https://github.com/go-jira/go-jira/issues/275) from go-jira/remove_gopkg_in
+- Merge pull request [#278](https://github.com/go-jira/go-jira/issues/278) from go-jira/update-figtree
+- Merge pull request [#276](https://github.com/go-jira/go-jira/issues/276) from go-jira/fix_228
+- Merge pull request [#266](https://github.com/go-jira/go-jira/issues/266) from mbethke/fix-multiline-worklog-comment
+- Merge pull request [#263](https://github.com/go-jira/go-jira/issues/263) from kojustin/master
+- Merge pull request [#253](https://github.com/go-jira/go-jira/issues/253) from mvdan/module
+- Merge pull request [#240](https://github.com/go-jira/go-jira/issues/240) from jgraglia/patch-1
+- Merge pull request [#219](https://github.com/go-jira/go-jira/issues/219) from kerhac/master
+- Merge pull request [#236](https://github.com/go-jira/go-jira/issues/236) from CodeLingoBot/rewrite
+- Merge pull request [#245](https://github.com/go-jira/go-jira/issues/245) from justmiles/211
+- Merge pull request [#220](https://github.com/go-jira/go-jira/issues/220) from ejsuncy/master
+
+
+<a name="v1.0.20"></a>
+## [v1.0.20] - 2018-08-04
+
+<a name="v1.0.19"></a>
+## [v1.0.19] - 2018-08-02
+### Pull Requests
+- Merge pull request [#197](https://github.com/go-jira/go-jira/issues/197) from kojiromike/spellcheck
+
+
+<a name="v1.0.18"></a>
+## [v1.0.18] - 2018-07-29
+### They Broke Golang.Org/X/Net: ERROR: Vendor/Golang.Org/X/Net/Proxy/Socks5.Go:11:2
+- [7191c77](https://github.com/go-jira/go-jira/commit/7191c7751b2d18d7f951d089fa3235acf5748d4b): use of internal package not allowed
+### Pull Requests
+- Merge pull request [#178](https://github.com/go-jira/go-jira/issues/178) from vergenzt/patch-1
+
+
+<a name="v1.0.17"></a>
+## [v1.0.17] - 2018-04-15
+### [#157] Add `Password-Directory
+- [06b26c9](https://github.com/go-jira/go-jira/commit/06b26c9e00384318ec7a51fa1c5ff5de63ea686b): path` to allow overriding PASSWORD_STORE_DIR from configs
+ -  [#157](https://github.com/go-jira/go-jira/issues/157)### Pull Requests
+- Merge pull request [#161](https://github.com/go-jira/go-jira/issues/161) from vanniktech/patch-1
+
+
+<a name="v1.0.16"></a>
+## [v1.0.16] - 2018-04-01
+### Pull Requests
+- Merge pull request [#150](https://github.com/go-jira/go-jira/issues/150) from catskul/parameterized-go-makefile
+- Merge pull request [#153](https://github.com/go-jira/go-jira/issues/153) from catskul/document-shell-completion
+- Merge pull request [#152](https://github.com/go-jira/go-jira/issues/152) from catskul/fix-missing-priority
+
+
+<a name="v1.0.15"></a>
+## [v1.0.15] - 2018-03-08
+### Pull Requests
+- Merge pull request [#151](https://github.com/go-jira/go-jira/issues/151) from catskul/build-instructions
+- Merge pull request [#142](https://github.com/go-jira/go-jira/issues/142) from anthonyrisinger/patch-1
+
+
+<a name="v1.0.14"></a>
+## [v1.0.14] - 2017-11-04
+### Pull Requests
+- Merge pull request [#130](https://github.com/go-jira/go-jira/issues/130) from onionjake/master
+
+
+<a name="v1.0.13"></a>
+## [v1.0.13] - 2017-10-28
+### Pull Requests
+- Merge pull request [#126](https://github.com/go-jira/go-jira/issues/126) from schorsch3000/master
+- Merge pull request [#129](https://github.com/go-jira/go-jira/issues/129) from blachniet/logout-help-typo-fix
+- Merge pull request [#124](https://github.com/go-jira/go-jira/issues/124) from gvol/master
+- Merge pull request [#128](https://github.com/go-jira/go-jira/issues/128) from mivok/escape-issuetype
+
+
+<a name="v1.0.12"></a>
+## [v1.0.12] - 2017-10-04
+
+<a name="v1.0.11"></a>
+## [v1.0.11] - 2017-09-26
+
+<a name="v1.0.10"></a>
+## [v1.0.10] - 2017-09-18
+
+<a name="v1.0.9"></a>
+## [v1.0.9] - 2017-09-17
+
+<a name="v1.0.8"></a>
+## [v1.0.8] - 2017-09-17
+
+<a name="v1.0.7"></a>
+## [v1.0.7] - 2017-09-15
 
-## 0.1.12 - 2017-03-22
+<a name="v1.0.6"></a>
+## [v1.0.6] - 2017-09-13
 
-* Implement "browse" subcommand on Windows [Claus Brod] [[ca333d8](https://github.com/Netflix-Skunkworks/go-jira/commit/ca333d8)]
+<a name="v1.0.5"></a>
+## [v1.0.5] - 2017-09-11
 
-## 0.1.11 - 2017-02-26
+<a name="v1.0.4"></a>
+## [v1.0.4] - 2017-09-08
 
-* [[#69](https://github.com/Netflix-Skunkworks/go-jira/issues/69)] add subtask command [Cory Bennett] [[21a2ed5](https://github.com/Netflix-Skunkworks/go-jira/commit/21a2ed5)]
+<a name="v1.0.3"></a>
+## [v1.0.3] - 2017-09-06
 
-## 0.1.10 - 2017-02-08
+<a name="v1.0.2"></a>
+## [v1.0.2] - 2017-09-06
 
-* set GPG_TTY in .bashrc [Cory Bennett] [[b1e552f](https://github.com/Netflix-Skunkworks/go-jira/commit/b1e552f)]
-* force password in case password already exists [Cory Bennett] [[d5a2c3b](https://github.com/Netflix-Skunkworks/go-jira/commit/d5a2c3b)]
-* refactor password source, allow for "pass" to be used, update tests to use `password-source: pass` [Cory Bennett] [[5a71939](https://github.com/Netflix-Skunkworks/go-jira/commit/5a71939)]
+<a name="v1.0.1"></a>
+## [v1.0.1] - 2017-09-06
 
-## 0.1.9 - 2016-12-18
+<a name="v1.0.0"></a>
+## [v1.0.0] - 2017-09-05
 
-* only warn about needing login when not already running the login command [Cory Bennett] [[6c24e55](https://github.com/Netflix-Skunkworks/go-jira/commit/6c24e55)]
-* fix(http): Add proxy transport [William Hearn] [[4bd740b](https://github.com/Netflix-Skunkworks/go-jira/commit/4bd740b)] [[2dff6c9](https://github.com/Netflix-Skunkworks/go-jira/commit/2dff6c9)]
+<a name="v0.1.15"></a>
+## [v0.1.15] - 2017-08-25
+### Pull Requests
+- Merge pull request [#104](https://github.com/go-jira/go-jira/issues/104) from wrouesnel/keyring-update
+- Merge pull request [#90](https://github.com/go-jira/go-jira/issues/90) from bbaugher/master
 
-## 0.1.8 - 2016-11-24
 
-* [[#12](https://github.com/Netflix-Skunkworks/go-jira/issues/12)] integrate with keyring for password storage and provide http basic auth credentials for every request since most jira services have websudo enabled with does not allow cookie based authentication [Cory Bennett] [[b8a6e57](https://github.com/Netflix-Skunkworks/go-jira/commit/b8a6e57)]
-* Cleaning up usage [Jay Shirley] [[8add52b](https://github.com/Netflix-Skunkworks/go-jira/commit/8add52b)]
-* Update usage [Jay Shirley] [[b56e32a](https://github.com/Netflix-Skunkworks/go-jira/commit/b56e32a)]
-* use gopkg.in for links to maintain version compatibility [Cory Bennett] [[1414d1f](https://github.com/Netflix-Skunkworks/go-jira/commit/1414d1f)]
-* golint [Cory Bennett] [[44cdebf](https://github.com/Netflix-Skunkworks/go-jira/commit/44cdebf)]
-* add "rank" command allow ordering backlog issues in agile projects [Cory Bennett] [[e4cc9c6](https://github.com/Netflix-Skunkworks/go-jira/commit/e4cc9c6)]
-* Adding a unixproxy mechanism [Jay Shirley] [[5b9c0dd](https://github.com/Netflix-Skunkworks/go-jira/commit/5b9c0dd)]
+<a name="v0.1.14"></a>
+## [v0.1.14] - 2017-05-10
 
-## 0.1.7 - 2016-08-24
+<a name="v0.1.13"></a>
+## [v0.1.13] - 2017-04-24
+### Pull Requests
+- Merge pull request [#78](https://github.com/go-jira/go-jira/issues/78) from davidreuss/generic-issuelink
+- Merge pull request [#77](https://github.com/go-jira/go-jira/issues/77) from davidreuss/fix-start-parameter-for-pagination
 
-* Prefer transition names which match exactly [Don Brower] [[e40f9c1](https://github.com/Netflix-Skunkworks/go-jira/commit/e40f9c1)]
-* update tempates to make them more readable with space trimming added to go-1.6 [Cory Bennett] [[693b3e4](https://github.com/Netflix-Skunkworks/go-jira/commit/693b3e4)]
 
-## 0.1.6 - 2016-08-21
+<a name="v0.1.12"></a>
+## [v0.1.12] - 2017-03-22
+### Pull Requests
+- Merge pull request [#74](https://github.com/go-jira/go-jira/issues/74) from clausb/BrowseOnWindows
 
-* make "worklogs" command print output through template allow "add worklog" command to open edit template [Cory Bennett] [[cc3fbee](https://github.com/Netflix-Skunkworks/go-jira/commit/cc3fbee)]
-* remove extra newline at end of worklogs template [Cory Bennett] [[d08ef15](https://github.com/Netflix-Skunkworks/go-jira/commit/d08ef15)]
-* adding worklog related templates [Cory Bennett] [[ab1cd27](https://github.com/Netflix-Skunkworks/go-jira/commit/ab1cd27)]
 
-## 0.1.5 - 2016-08-21
+<a name="v0.1.11"></a>
+## [v0.1.11] - 2017-02-26
 
-* update for golint [Cory Bennett] [[5a4e17c](https://github.com/Netflix-Skunkworks/go-jira/commit/5a4e17c)]
-* fix for go vet [Cory Bennett] [[355fb42](https://github.com/Netflix-Skunkworks/go-jira/commit/355fb42)]
+<a name="v0.1.10"></a>
+## [v0.1.10] - 2017-02-08
+### Doc Tweak
+- [e6faa4e](https://github.com/go-jira/go-jira/commit/e6faa4eab1a8d6a7fb624b79bb58a641d02e876b): add info for setting username
+### Merge Branch 'Master' Of Github.Com
+- [63bc2ae](https://github.com/go-jira/go-jira/commit/63bc2ae15a2ebafa16861965951800e0d5c122bd): Netflix-Skunkworks/go-jira
+### Refactor Password Source, Allow For "Pass" To Be Used, Update Tests To Use `Password-Source
+- [cb70941](https://github.com/go-jira/go-jira/commit/cb70941aad2b8198f5c8ad8d1e1a7a98dc820cd9): pass`
+### Pull Requests
+- Merge pull request [#65](https://github.com/go-jira/go-jira/issues/65) from mlbright/patch-1
+- Merge pull request [#64](https://github.com/go-jira/go-jira/issues/64) from astrostl/patch-2
+- Merge pull request [#62](https://github.com/go-jira/go-jira/issues/62) from astrostl/patch-1
 
-## 0.1.4 - 2016-08-12
 
-* when running "dups" on a Process Management Project type, you have to start/stop the task to resolve it [Cory Bennett] [[2c91905](https://github.com/Netflix-Skunkworks/go-jira/commit/2c91905)]
-* allow for defaultResolution option for transition command [Cory Bennett] [[a328c2d](https://github.com/Netflix-Skunkworks/go-jira/commit/a328c2d)]
-* add "backlog" command for Kanban related Issues [Cory Bennett] [[5d39b23](https://github.com/Netflix-Skunkworks/go-jira/commit/5d39b23)]
-* fix --noedit flag with "dups" command [Cory Bennett] [[37c07fa](https://github.com/Netflix-Skunkworks/go-jira/commit/37c07fa)]
-* add "votes" and "labels" to default view template [Cory Bennett] [[6f73b8c](https://github.com/Netflix-Skunkworks/go-jira/commit/6f73b8c)]
-* add "blockerType" config param, for issueLinkType use for "blocks" command [Cory Bennett] [[30fd301](https://github.com/Netflix-Skunkworks/go-jira/commit/30fd301)]
-* update gitter room [Cory Bennett] [[4b822b1](https://github.com/Netflix-Skunkworks/go-jira/commit/4b822b1)]
-* default issuetype to "Bug" for project that have Bug, otherwise try "Task" [Cory Bennett] [[0c807b4](https://github.com/Netflix-Skunkworks/go-jira/commit/0c807b4)]
-* make view template only show fields that have values [Cory Bennett] [[8238fe8](https://github.com/Netflix-Skunkworks/go-jira/commit/8238fe8)]
-* make default create template only display fields if they are valid fields for the project [Cory Bennett] [[adc2ace](https://github.com/Netflix-Skunkworks/go-jira/commit/adc2ace)]
-* ignore empty json fields when processing templates [Cory Bennett] [[f5f3e28](https://github.com/Netflix-Skunkworks/go-jira/commit/f5f3e28)]
-* allow JIRA_LOG_FORMAT env variable to control log output format [Cory Bennett] [[469def0](https://github.com/Netflix-Skunkworks/go-jira/commit/469def0)]
-* remove extraneous debug [Cory Bennett] [[752a94d](https://github.com/Netflix-Skunkworks/go-jira/commit/752a94d)]
-* add logout command modify password prompt to echo masked password [Cory Bennett] [[8ad91be](https://github.com/Netflix-Skunkworks/go-jira/commit/8ad91be)]
-* tweak cookies to store hostname dump all http request/response with --verbose [Cory Bennett] [[f93fe79](https://github.com/Netflix-Skunkworks/go-jira/commit/f93fe79)]
-* load configs in order of closest to cwd (/etc/go-jira.yml is last) [Cory Bennett] [[f54267b](https://github.com/Netflix-Skunkworks/go-jira/commit/f54267b)]
+<a name="v0.1.9"></a>
+## [v0.1.9] - 2016-12-18
+### Fix(Http)
+- [b326623](https://github.com/go-jira/go-jira/commit/b326623ed22677a3ff76d2c4c67bb7ca7ecb3877): Add proxy transport
+- [72c78c6](https://github.com/go-jira/go-jira/commit/72c78c6c1c63a70d837c8e367754792c8a30ae06): Add proxy transport
+### Merge Branch 'Master' Of Github.Com
+- [ac515e2](https://github.com/go-jira/go-jira/commit/ac515e2743e1bcf5f492a0e25d2b084f3311f0d0): Netflix-Skunkworks/go-jira
+### Pull Requests
+- Merge pull request [#61](https://github.com/go-jira/go-jira/issues/61) from sylus/feature-proxy
+- Merge pull request [#60](https://github.com/go-jira/go-jira/issues/60) from facundoolano/patch-1
 
-## 0.1.3 - 2016-07-30
 
-* [[#43](https://github.com/Netflix-Skunkworks/go-jira/issues/43)] add support for jira done|todo|prog commands [Cory Bennett] [[dd7d1cc](https://github.com/Netflix-Skunkworks/go-jira/commit/dd7d1cc)]
-* Reporter is not generally editable. [Mike Pountney] [[a637b43](https://github.com/Netflix-Skunkworks/go-jira/commit/a637b43)]
+<a name="v0.1.8"></a>
+## [v0.1.8] - 2016-11-24
+### Pull Requests
+- Merge pull request [#53](https://github.com/go-jira/go-jira/issues/53) from jshirley/master
 
-## 0.1.2 - 2016-06-29
 
-* [[#44](https://github.com/Netflix-Skunkworks/go-jira/issues/44)] Close tmpfile before rename to work around "The process cannot access the file because it is being used by another process" error on windows. [Cory Bennett] [[0980f8e](https://github.com/Netflix-Skunkworks/go-jira/commit/0980f8e)]
+<a name="v0.1.7"></a>
+## [v0.1.7] - 2016-08-24
+### Pull Requests
+- Merge pull request [#52](https://github.com/go-jira/go-jira/issues/52) from dbrower/master
 
-## 0.1.1 - 2016-06-28
 
-* use USERPROFILE instead of HOME for windows, rework paths to use filepath.Join for better cross platform support [Cory Bennett] [[adcedc4](https://github.com/Netflix-Skunkworks/go-jira/commit/adcedc4)]
-* Include templates from a system path [Mike Pountney] [[cf10f53](https://github.com/Netflix-Skunkworks/go-jira/commit/cf10f53)]
-* Added support for the ```expand``` option for Issues [tobyjoe] [[fb4afc9](https://github.com/Netflix-Skunkworks/go-jira/commit/fb4afc9)]
-* change for api changes to go-logging [Cory Bennett] [[7bfc6e8](https://github.com/Netflix-Skunkworks/go-jira/commit/7bfc6e8)]
-* Fix issuetype calls adding URL escaping [Jonathan Wright] [[e4a25e2](https://github.com/Netflix-Skunkworks/go-jira/commit/e4a25e2)]
+<a name="v0.1.6"></a>
+## [v0.1.6] - 2016-08-21
 
-## 0.1.0 - 2016-01-29
+<a name="v0.1.5"></a>
+## [v0.1.5] - 2016-08-21
 
-* Fixes [#32](https://github.com/Netflix-Skunkworks/go-jira/issues/32) - make path to cookieFile if it's not present [Mike Pountney] [[6644579](https://github.com/Netflix-Skunkworks/go-jira/commit/6644579)]
-* Add component/components support: add and list for now. [Mike Pountney] [[d7b3226](https://github.com/Netflix-Skunkworks/go-jira/commit/d7b3226)]
-* Tweak the CmdWatch contract and add watcher remove support [Mike Pountney] [[383847a](https://github.com/Netflix-Skunkworks/go-jira/commit/383847a)]
-* Amend vote/unvote to be vote/vote --down [Mike Pountney] [[797edef](https://github.com/Netflix-Skunkworks/go-jira/commit/797edef)]
-* Add 'vote' and 'unvote' [Mike Pountney] [[c95e66e](https://github.com/Netflix-Skunkworks/go-jira/commit/c95e66e)]
+<a name="v0.1.4"></a>
+## [v0.1.4] - 2016-08-12
 
-## 0.0.20 - 2016-01-21
+<a name="v0.1.3"></a>
+## [v0.1.3] - 2016-07-30
+### Pull Requests
+- Merge pull request [#24](https://github.com/go-jira/go-jira/issues/24) from mikepea/edit_template_common
 
-* [issue [#28](https://github.com/Netflix-Skunkworks/go-jira/issues/28)] check to make sure we got back issuetypes for create metadata [Cory Bennett] [[ee0e780](https://github.com/Netflix-Skunkworks/go-jira/commit/ee0e780)]
-* Add insecure option for TLS endpoints [Brian Lalor] [[6a88bb9](https://github.com/Netflix-Skunkworks/go-jira/commit/6a88bb9)]
-* Correct naming of parameter: set/add/remove are actions. [Mike Pountney] [[303784f](https://github.com/Netflix-Skunkworks/go-jira/commit/303784f)]
-* Tweak CmdLabels args so that magic happens with CLI [Mike Pountney] [[40a7c65](https://github.com/Netflix-Skunkworks/go-jira/commit/40a7c65)]
-* Expose ViewTicket as per FindIssues [Mike Pountney] [[8977f3d](https://github.com/Netflix-Skunkworks/go-jira/commit/8977f3d)]
-* Add exposed versions of getTemplate and runTemplate [Mike Pountney] [[da6cbd5](https://github.com/Netflix-Skunkworks/go-jira/commit/da6cbd5)]
-* Add 'labels' command to set/add/remove labels [Mike Pountney] [[230b52d](https://github.com/Netflix-Skunkworks/go-jira/commit/230b52d)]
-* Add a 'join' func to the template engine [Mike Pountney] [[a7820fe](https://github.com/Netflix-Skunkworks/go-jira/commit/a7820fe)]
-* make "jira" golang package, move code from jira/cli to root, move jira/main.go to main/main.go [Cory Bennett] [[7268b9e](https://github.com/Netflix-Skunkworks/go-jira/commit/7268b9e)]
 
-## 0.0.19 - 2015-12-09
+<a name="v0.1.2"></a>
+## [v0.1.2] - 2016-06-29
 
-* fix jira trans TRANS ISSUE (case sensitivity issue), also go fmt [Cory Bennett] [[3c30f3b](https://github.com/Netflix-Skunkworks/go-jira/commit/3c30f3b)]
+<a name="v0.1.1"></a>
+## [v0.1.1] - 2016-06-28
+### Merge Branch 'Master' Of Github.Com
+- [dd0f5ef](https://github.com/go-jira/go-jira/commit/dd0f5efd3247157686c2c88817d3ad375de399ea): Netflix-Skunkworks/go-jira
+### Pull Requests
+- Merge pull request [#39](https://github.com/go-jira/go-jira/issues/39) from mikepea/system_template_dir
+- Merge pull request [#38](https://github.com/go-jira/go-jira/issues/38) from jglick/patch-1
+- Merge pull request [#37](https://github.com/go-jira/go-jira/issues/37) from tobyjoe/add-resource-expansion
+- Merge pull request [#35](https://github.com/go-jira/go-jira/issues/35) from QuinnyPig/fix-readme
+- Merge pull request [#34](https://github.com/go-jira/go-jira/issues/34) from jonathanio/fix/issuetypes-url-escaping
 
-## 0.0.18 - 2015-12-03
 
-* need to default "quiet" to false [Cory Bennett] [[4f4a89b](https://github.com/Netflix-Skunkworks/go-jira/commit/4f4a89b)]
+<a name="v0.1.0"></a>
+## [v0.1.0] - 2016-01-29
+### Add Component/Components Support
+- [595a521](https://github.com/go-jira/go-jira/commit/595a5212b43be28e01a0d5a6cf98a8de89383e41): add and list for now.
+### Merge Branch 'Master' Of Github.Com
+- [9e90376](https://github.com/go-jira/go-jira/commit/9e90376816c295d3a75b4f51703c24fd95873625): Netflix-Skunkworks/go-jira
+- [382bf4f](https://github.com/go-jira/go-jira/commit/382bf4faeb17198b54950a05b0fdb3e126af8d73): Netflix-Skunkworks/go-jira
+### Pull Requests
+- Merge pull request [#33](https://github.com/go-jira/go-jira/issues/33) from mikepea/make_jirad
+- Merge pull request [#31](https://github.com/go-jira/go-jira/issues/31) from mikepea/component_mgmt
+- Merge pull request [#30](https://github.com/go-jira/go-jira/issues/30) from mikepea/unwatch_support
+- Merge pull request [#26](https://github.com/go-jira/go-jira/issues/26) from mikepea/vote_support
 
-## 0.0.17 - 2015-12-03
 
-* add --quiet command to not print the OK .. add --saveFile option to print the issue/link to a file on create command [Cory Bennett] [[c9ac162](https://github.com/Netflix-Skunkworks/go-jira/commit/c9ac162)]
-* fix overrides [Cory Bennett] [[eaddfe6](https://github.com/Netflix-Skunkworks/go-jira/commit/eaddfe6)]
-* add abstract request wrapper to allow you to access/process random apis supported by Jira but not yet supported by go-jira [Cory Bennett] [[90ef56a](https://github.com/Netflix-Skunkworks/go-jira/commit/90ef56a)]
+<a name="v0.0.20"></a>
+## [v0.0.20] - 2016-01-21
+### Correct Naming Of Parameter
+- [8e66246](https://github.com/go-jira/go-jira/commit/8e662462dac6cccdf8af277797777caeff3ad2bc): set/add/remove are actions.
+### Pull Requests
+- Merge pull request [#27](https://github.com/go-jira/go-jira/issues/27) from blalor/insecure-skip-verify
+- Merge pull request [#21](https://github.com/go-jira/go-jira/issues/21) from mikepea/label_command
+- Merge pull request [#22](https://github.com/go-jira/go-jira/issues/22) from mikepea/library_break_out
+- Merge pull request [#20](https://github.com/go-jira/go-jira/issues/20) from mikepea/add_join_template_func
 
-## 0.0.16 - 2015-11-23
 
-* jira edit should not require one arguemnt (allow for --query) [Cory Bennett] [[a1eb4a1](https://github.com/Netflix-Skunkworks/go-jira/commit/a1eb4a1)]
+<a name="0.0.19"></a>
+## [0.0.19] - 2015-12-09
 
-## 0.0.15 - 2015-11-23
+<a name="0.0.18"></a>
+## [0.0.18] - 2015-12-03
 
-* [[#17](https://github.com/Netflix-Skunkworks/go-jira/issues/17)] print usage on missing arguments [Cory Bennett] [[fd2a2fe](https://github.com/Netflix-Skunkworks/go-jira/commit/fd2a2fe)]
+<a name="0.0.17"></a>
+## [0.0.17] - 2015-12-03
 
-## 0.0.14 - 2015-11-17
+<a name="0.0.16"></a>
+## [0.0.16] - 2015-11-23
 
-* s/enpoint/endpoint/g [Oliver Schrenk] [[c5d251d](https://github.com/Netflix-Skunkworks/go-jira/commit/c5d251d)]
-* Implement dateFormat template command [Mike Pountney] [[68d3bae](https://github.com/Netflix-Skunkworks/go-jira/commit/68d3bae)]
-* Add 'updated' field to default queryfields. [Mike Pountney] [[91e2475](https://github.com/Netflix-Skunkworks/go-jira/commit/91e2475)]
-* Fix export-templates option (typo) [Mike Pountney] [[4d7fdb8](https://github.com/Netflix-Skunkworks/go-jira/commit/4d7fdb8)]
-* when yaml element resolves to "\n" strip it out so we dont post it to jira [Cory Bennett] [[47ced2f](https://github.com/Netflix-Skunkworks/go-jira/commit/47ced2f)]
-* print PUT/POST data when using --dryrun to help debug [Cory Bennett] [[618f245](https://github.com/Netflix-Skunkworks/go-jira/commit/618f245)]
+<a name="0.0.15"></a>
+## [0.0.15] - 2015-11-23
 
-## 0.0.13 - 2015-09-19
+<a name="0.0.14"></a>
+## [0.0.14] - 2015-11-17
+### Pull Requests
+- Merge pull request [#16](https://github.com/go-jira/go-jira/issues/16) from oschrenk/fix-typo
+- Merge pull request [#14](https://github.com/go-jira/go-jira/issues/14) from mikepea/ls_with_updated
 
-* replace dead/deprecated code.google.com/p/gopass with golang.org/x/crypto/ssh/terminal for reading password from stdin [Cory Bennett] [[909eb06](https://github.com/Netflix-Skunkworks/go-jira/commit/909eb06)]
 
-## 0.0.12 - 2015-09-18
+<a name="0.0.13"></a>
+## [0.0.13] - 2015-09-19
 
-* fix exception from "jira create" [Cory Bennett] [[9348a4b](https://github.com/Netflix-Skunkworks/go-jira/commit/9348a4b)]
-* add some debug messages to help diagnose login failures [Cory Bennett] [[1c08a7d](https://github.com/Netflix-Skunkworks/go-jira/commit/1c08a7d)]
+<a name="0.0.12"></a>
+## [0.0.12] - 2015-09-18
 
-## 0.0.11 - 2015-09-16
+<a name="0.0.11"></a>
+## [0.0.11] - 2015-09-16
 
-* add --version [Cory Bennett] [[8385ee2](https://github.com/Netflix-Skunkworks/go-jira/commit/8385ee2)]
-* fix command line parser broken in 0.0.10 [Cory Bennett] [[15ae929](https://github.com/Netflix-Skunkworks/go-jira/commit/15ae929)]
+<a name="0.0.10"></a>
+## [0.0.10] - 2015-09-15
 
-## 0.0.10 - 2015-09-15
+<a name="0.0.9"></a>
+## [0.0.9] - 2015-09-15
+### Allow "Abort
+- [80b6f5a](https://github.com/go-jira/go-jira/commit/80b6f5a198fbe17aa0245c470d47c2988d8624c3): true" to be set while editing to cancel the edit operation
 
-* allow for command aliasing in conjunction with executable config files. Issue #5 [Cory Bennett] [[23590d4](https://github.com/Netflix-Skunkworks/go-jira/commit/23590d4)]
-* update usage [Cory Bennett] [[ef7a57e](https://github.com/Netflix-Skunkworks/go-jira/commit/ef7a57e)]
+<a name="0.0.8"></a>
+## [0.0.8] - 2015-07-31
+### Pull Requests
+- Merge pull request [#11](https://github.com/go-jira/go-jira/issues/11) from mikepea/max_results_option
 
-## 0.0.9 - 2015-09-15
+### Note
 
-* use forked yaml.v2 so as to not lose line terminations present in jira fields [Cory Bennett] [[f84e77f](https://github.com/Netflix-Skunkworks/go-jira/commit/f84e77f)]
-* adding a |~ literal yaml syntax to just chomp a single newline (again to preserve existing formatting in jira fields) [Cory Bennett] [[f84e77f](https://github.com/Netflix-Skunkworks/go-jira/commit/f84e77f)]
-* for indent/comment allow for unicode line termination characters that yaml will use for parsing [Cory Bennett] [[f84e77f](https://github.com/Netflix-Skunkworks/go-jira/commit/f84e77f)]
-* fix "edit" default option, change how defaults are dealt with for filters [Cory Bennett] [[4265913](https://github.com/Netflix-Skunkworks/go-jira/commit/4265913)]
-* for edit template add issue id as comment, also add "comments" as comment so you can review the comment details while editing [Cory Bennett] [[968a9df](https://github.com/Netflix-Skunkworks/go-jira/commit/968a9df)]
-* add "comment" template filter to comment out multiline statements [Cory Bennett] [[d664868](https://github.com/Netflix-Skunkworks/go-jira/commit/d664868)]
-* add getOpt wrappers to get options with defaults [Cory Bennett] [[c0070cf](https://github.com/Netflix-Skunkworks/go-jira/commit/c0070cf)]
-* make --dryrun work [Cory Bennett] [[d229ac1](https://github.com/Netflix-Skunkworks/go-jira/commit/d229ac1)]
-* refactor config/option loading so command options override settings in config files [Cory Bennett] [[d229ac1](https://github.com/Netflix-Skunkworks/go-jira/commit/d229ac1)]
-* allow query options to be used on the "edit" command to iterate editing [Cory Bennett] [[d229ac1](https://github.com/Netflix-Skunkworks/go-jira/commit/d229ac1)]
-* remove duplication for defaults [Cory Bennett] [[f8c8ddf](https://github.com/Netflix-Skunkworks/go-jira/commit/f8c8ddf)]
-* use optigo for option parsing, drop docopt [Cory Bennett] [[7bbd571](https://github.com/Netflix-Skunkworks/go-jira/commit/7bbd571)]
-* allow "abort: true" to be set while editing to cancel the edit operation [Cory Bennett] [[ea67a77](https://github.com/Netflix-Skunkworks/go-jira/commit/ea67a77)]
-* if no changes are made on edit templates then abort edit [Cory Bennett] [[e69b65c](https://github.com/Netflix-Skunkworks/go-jira/commit/e69b65c)]
+that testing against our JIRA instance, in a project with
+more than 1000 open issues, suggests that the JIRA has an internal
+limit of 1000 results in a single query.
 
-## 0.0.8 - 2015-07-31
 
-* Add --max_results option for 'ls' [Mike Pountney] [[e06ff0c](https://github.com/Netflix-Skunkworks/go-jira/commit/e06ff0c)]
+<a name="0.0.7"></a>
+## [0.0.7] - 2015-07-01
+### Merge Branch 'Master' Of Github.Com
+- [b72040b](https://github.com/go-jira/go-jira/commit/b72040bfd413bcdc88ca2c3f6843a7f6dee2e898): Netflix-Skunkworks/go-jira
+### Pull Requests
+- Merge pull request [#9](https://github.com/go-jira/go-jira/issues/9) from nelfin/quickfix/take-user
 
-## 0.0.7 - 2015-07-01
 
-* fix "take" command not honouring user option [Andrew Haigh] [[8f1d2b9](https://github.com/Netflix-Skunkworks/go-jira/commit/8f1d2b9)]
-* fix typo [Cory Bennett] [[06f57fe](https://github.com/Netflix-Skunkworks/go-jira/commit/06f57fe)]
+<a name="0.0.6"></a>
+## [0.0.6] - 2015-02-27
+### Set JIRA_OPERATION To "View" When No Operation Used (Ie
+- [8040746](https://github.com/go-jira/go-jira/commit/8040746bcf6aac6e3ff6e419c349661a8fc9bf99): jira GOJIRA-123)
 
-## 0.0.6 - 2015-02-27
+<a name="0.0.5"></a>
+## [0.0.5] - 2015-02-21
 
-* allow --sort= to disable sort override [Cory Bennett] [[701f091](https://github.com/Netflix-Skunkworks/go-jira/commit/701f091)]
-* fix default JIRA_OPERATION env variable [Cory Bennett] [[82fd9b9](https://github.com/Netflix-Skunkworks/go-jira/commit/82fd9b9)]
-* automatically close duplicate issues with "Duplicate" resolution [Cory Bennett] [[ebf1700](https://github.com/Netflix-Skunkworks/go-jira/commit/ebf1700)]
-* set JIRA_OPERATION to "view" when no operation used (ie: jira GOJIRA-123) [Cory Bennett] [[050848a](https://github.com/Netflix-Skunkworks/go-jira/commit/050848a)]
-* add --sort option to "list" command [Cory Bennett] [[f359030](https://github.com/Netflix-Skunkworks/go-jira/commit/f359030)]
+<a name="0.0.4"></a>
+## [0.0.4] - 2015-02-19
 
-## 0.0.5 - 2015-02-21
+<a name="0.0.3"></a>
+## [0.0.3] - 2015-02-19
+### [Issue #8] Detect X-Seraph-Loginreason
+- [f3feff7](https://github.com/go-jira/go-jira/commit/f3feff796fbecca6477ecbc1e9dae6a2b78e755c): AUTHENTICATION_DENIED header to catch login failures
+ -  [#8](https://github.com/go-jira/go-jira/issues/8)### Pull Requests
+- Merge pull request [#7](https://github.com/go-jira/go-jira/issues/7) from jaybuff/empty-projects
 
-* handle editor having arguments [Cory Bennett] [[7186fb3](https://github.com/Netflix-Skunkworks/go-jira/commit/7186fb3)]
-* add more template error handling [Cory Bennett] [[3e6f2b3](https://github.com/Netflix-Skunkworks/go-jira/commit/3e6f2b3)]
-* allow create template to specify defalt watchers with -o watchers=... [Cory Bennett] [[4db2e4e](https://github.com/Netflix-Skunkworks/go-jira/commit/4db2e4e)]
-* if config files are executable then run them and parse the output [Cory Bennett] [[7a2f7f5](https://github.com/Netflix-Skunkworks/go-jira/commit/7a2f7f5)]
 
-## 0.0.4 - 2015-02-19
-
-* add --template option to export-templates to export a single template [Cory Bennett] [[343fbb6](https://github.com/Netflix-Skunkworks/go-jira/commit/343fbb6)]
-* add "table" template to be used with "list" command [Cory Bennett] [[8954ec1](https://github.com/Netflix-Skunkworks/go-jira/commit/8954ec1)]
-
-## 0.0.3 - 2015-02-19
-
-* [issue [#8](https://github.com/Netflix-Skunkworks/go-jira/issues/8)] detect X-Seraph-Loginreason: AUTHENTICATION_DENIED header to catch login failures [Cory Bennett] [[2dcf665](https://github.com/Netflix-Skunkworks/go-jira/commit/2dcf665)]
-* project should always be uppercase [Jay Buffington] [[1b69d12](https://github.com/Netflix-Skunkworks/go-jira/commit/1b69d12)]
-* if response is 400, check json for errorMessages and log them [Jay Buffington] [[4924dfa](https://github.com/Netflix-Skunkworks/go-jira/commit/4924dfa)]
-* validate project [Jay Buffington] [[dc5ae42](https://github.com/Netflix-Skunkworks/go-jira/commit/dc5ae42)]
-
-## 0.0.2 - 2015-02-18
-
-* add missing --override options on transition command
-* add browse command
+<a name="0.0.2"></a>
+## [0.0.2] - 2015-02-18
 
+<a name="0.0.1"></a>
 ## 0.0.1 - 2015-02-18
+### Adding Commands
+- [18f10fd](https://github.com/go-jira/go-jira/commit/18f10fd12521584c7d85b20dff2b1c2da0854cb9): * create * dups * blocks * watch
+### Merge Branch 'Nil-Assignee' Of Https
+- [25539ef](https://github.com/go-jira/go-jira/commit/25539efedda0e06e103fc942e16405c0c09ba621): //github.com/jaybuff/go-jira into jaybuff-nil-assignee
+### Work In Progress, Minor Refactor.  Added Commands
+- [acbc24b](https://github.com/go-jira/go-jira/commit/acbc24b2096f31a5805fa48984724a4a6c1da431): * login * editmeta ISSUE * edit ISSUE * issuetypes [-p PROJECT] * createmeta [-p PROJECT] [-i ISSUETYPE] * transitions ISSUE
+### Pull Requests
+- Merge pull request [#2](https://github.com/go-jira/go-jira/issues/2) from jaybuff/clean-up
 
-* Initial experimental release
+
+[Unreleased]: https://github.com/go-jira/go-jira/compare/v1.0.28...HEAD
+[v1.0.28]: https://github.com/go-jira/go-jira/compare/v1.0.27...v1.0.28
+[v1.0.27]: https://github.com/go-jira/go-jira/compare/v1.0.26...v1.0.27
+[v1.0.26]: https://github.com/go-jira/go-jira/compare/v1.0.25...v1.0.26
+[v1.0.25]: https://github.com/go-jira/go-jira/compare/v1.0.24...v1.0.25
+[v1.0.24]: https://github.com/go-jira/go-jira/compare/v1.0.23...v1.0.24
+[v1.0.23]: https://github.com/go-jira/go-jira/compare/v1.0.22...v1.0.23
+[v1.0.22]: https://github.com/go-jira/go-jira/compare/v1.0.21...v1.0.22
+[v1.0.21]: https://github.com/go-jira/go-jira/compare/v1.0.20...v1.0.21
+[v1.0.20]: https://github.com/go-jira/go-jira/compare/v1.0.19...v1.0.20
+[v1.0.19]: https://github.com/go-jira/go-jira/compare/v1.0.18...v1.0.19
+[v1.0.18]: https://github.com/go-jira/go-jira/compare/v1.0.17...v1.0.18
+[v1.0.17]: https://github.com/go-jira/go-jira/compare/v1.0.16...v1.0.17
+[v1.0.16]: https://github.com/go-jira/go-jira/compare/v1.0.15...v1.0.16
+[v1.0.15]: https://github.com/go-jira/go-jira/compare/v1.0.14...v1.0.15
+[v1.0.14]: https://github.com/go-jira/go-jira/compare/v1.0.13...v1.0.14
+[v1.0.13]: https://github.com/go-jira/go-jira/compare/v1.0.12...v1.0.13
+[v1.0.12]: https://github.com/go-jira/go-jira/compare/v1.0.11...v1.0.12
+[v1.0.11]: https://github.com/go-jira/go-jira/compare/v1.0.10...v1.0.11
+[v1.0.10]: https://github.com/go-jira/go-jira/compare/v1.0.9...v1.0.10
+[v1.0.9]: https://github.com/go-jira/go-jira/compare/v1.0.8...v1.0.9
+[v1.0.8]: https://github.com/go-jira/go-jira/compare/v1.0.7...v1.0.8
+[v1.0.7]: https://github.com/go-jira/go-jira/compare/v1.0.6...v1.0.7
+[v1.0.6]: https://github.com/go-jira/go-jira/compare/v1.0.5...v1.0.6
+[v1.0.5]: https://github.com/go-jira/go-jira/compare/v1.0.4...v1.0.5
+[v1.0.4]: https://github.com/go-jira/go-jira/compare/v1.0.3...v1.0.4
+[v1.0.3]: https://github.com/go-jira/go-jira/compare/v1.0.2...v1.0.3
+[v1.0.2]: https://github.com/go-jira/go-jira/compare/v1.0.1...v1.0.2
+[v1.0.1]: https://github.com/go-jira/go-jira/compare/v1.0.0...v1.0.1
+[v1.0.0]: https://github.com/go-jira/go-jira/compare/v0.1.15...v1.0.0
+[v0.1.15]: https://github.com/go-jira/go-jira/compare/v0.1.14...v0.1.15
+[v0.1.14]: https://github.com/go-jira/go-jira/compare/v0.1.13...v0.1.14
+[v0.1.13]: https://github.com/go-jira/go-jira/compare/v0.1.12...v0.1.13
+[v0.1.12]: https://github.com/go-jira/go-jira/compare/v0.1.11...v0.1.12
+[v0.1.11]: https://github.com/go-jira/go-jira/compare/v0.1.10...v0.1.11
+[v0.1.10]: https://github.com/go-jira/go-jira/compare/v0.1.9...v0.1.10
+[v0.1.9]: https://github.com/go-jira/go-jira/compare/v0.1.8...v0.1.9
+[v0.1.8]: https://github.com/go-jira/go-jira/compare/v0.1.7...v0.1.8
+[v0.1.7]: https://github.com/go-jira/go-jira/compare/v0.1.6...v0.1.7
+[v0.1.6]: https://github.com/go-jira/go-jira/compare/v0.1.5...v0.1.6
+[v0.1.5]: https://github.com/go-jira/go-jira/compare/v0.1.4...v0.1.5
+[v0.1.4]: https://github.com/go-jira/go-jira/compare/v0.1.3...v0.1.4
+[v0.1.3]: https://github.com/go-jira/go-jira/compare/v0.1.2...v0.1.3
+[v0.1.2]: https://github.com/go-jira/go-jira/compare/v0.1.1...v0.1.2
+[v0.1.1]: https://github.com/go-jira/go-jira/compare/v0.1.0...v0.1.1
+[v0.1.0]: https://github.com/go-jira/go-jira/compare/v0.0.20...v0.1.0
+[v0.0.20]: https://github.com/go-jira/go-jira/compare/0.0.19...v0.0.20
+[0.0.19]: https://github.com/go-jira/go-jira/compare/0.0.18...0.0.19
+[0.0.18]: https://github.com/go-jira/go-jira/compare/0.0.17...0.0.18
+[0.0.17]: https://github.com/go-jira/go-jira/compare/0.0.16...0.0.17
+[0.0.16]: https://github.com/go-jira/go-jira/compare/0.0.15...0.0.16
+[0.0.15]: https://github.com/go-jira/go-jira/compare/0.0.14...0.0.15
+[0.0.14]: https://github.com/go-jira/go-jira/compare/0.0.13...0.0.14
+[0.0.13]: https://github.com/go-jira/go-jira/compare/0.0.12...0.0.13
+[0.0.12]: https://github.com/go-jira/go-jira/compare/0.0.11...0.0.12
+[0.0.11]: https://github.com/go-jira/go-jira/compare/0.0.10...0.0.11
+[0.0.10]: https://github.com/go-jira/go-jira/compare/0.0.9...0.0.10
+[0.0.9]: https://github.com/go-jira/go-jira/compare/0.0.8...0.0.9
+[0.0.8]: https://github.com/go-jira/go-jira/compare/0.0.7...0.0.8
+[0.0.7]: https://github.com/go-jira/go-jira/compare/0.0.6...0.0.7
+[0.0.6]: https://github.com/go-jira/go-jira/compare/0.0.5...0.0.6
+[0.0.5]: https://github.com/go-jira/go-jira/compare/0.0.4...0.0.5
+[0.0.4]: https://github.com/go-jira/go-jira/compare/0.0.3...0.0.4
+[0.0.3]: https://github.com/go-jira/go-jira/compare/0.0.2...0.0.3
+[0.0.2]: https://github.com/go-jira/go-jira/compare/0.0.1...0.0.2

CHANGELOG.md.old

@@ -0,0 +1,492 @@
+# Changelog
+
+## 1.0.25 - 2020-09-11
+
+* Ensure body is NPE safe [Louis DeLosSantos] [[42e5d23](https://github.com/Netflix-Skunkworks/go-jira/commit/42e5d23)]
+* Support empty responses in request commands [Louis DeLosSantos] [[b572037](https://github.com/Netflix-Skunkworks/go-jira/commit/b572037)]
+
+## 1.0.24 - 2020-09-04
+
+* Make -h flag show --help [Benjamin Kane] [[4bf1d03](https://github.com/Netflix-Skunkworks/go-jira/commit/4bf1d03)]
+* transition: map field name to id [Louis DeLosSantos] [[3c1c4d9](https://github.com/Netflix-Skunkworks/go-jira/commit/3c1c4d9)]
+* username-deprecation: use email and display names [Louis DeLosSantos] [[6a27e28](https://github.com/Netflix-Skunkworks/go-jira/commit/6a27e28)]
+* Add support to get all comments for an issue [Thibault Jamet] [[a311d0d](https://github.com/Netflix-Skunkworks/go-jira/commit/a311d0d)]
+* update all usage of user.name to user.accountId for privacy migration: https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/ [Cory Bennett] [[a26683e](https://github.com/Netflix-Skunkworks/go-jira/commit/a26683e)]
+* add template functions to handle table output, fixes [#176](https://github.com/Netflix-Skunkworks/go-jira/issues/176), replaces [#296](https://github.com/Netflix-Skunkworks/go-jira/issues/296) [Cory Bennett] [[7e97463](https://github.com/Netflix-Skunkworks/go-jira/commit/7e97463)]
+* use `password-source-path` to allow overriding binary and/or path to binary [Cory Bennett] [[d6173ce](https://github.com/Netflix-Skunkworks/go-jira/commit/d6173ce)]
+* allow issues on command line to automatically prefix with project when defined [Cory Bennett] [[d002d7f](https://github.com/Netflix-Skunkworks/go-jira/commit/d002d7f)]
+* Forgot you use TAB instead of spaces [Cory Bennett] [[789886c](https://github.com/Netflix-Skunkworks/go-jira/commit/789886c)]
+* Fixed append project to view [Cory Bennett] [[8a46215](https://github.com/Netflix-Skunkworks/go-jira/commit/8a46215)]
+* Added a line break removal function [Cory Bennett] [[9cbd993](https://github.com/Netflix-Skunkworks/go-jira/commit/9cbd993)]
+* Pushed Readfile to .jira.d directory instead of pwd [Cory Bennett] [[db53622](https://github.com/Netflix-Skunkworks/go-jira/commit/db53622)]
+* Cache password to avoid invoking password source on each API request [Patrick Decat] [[0f059a5](https://github.com/Netflix-Skunkworks/go-jira/commit/0f059a5)]
+* Add support to switch out password source binary [Patrick Pichler] [[659a5c8](https://github.com/Netflix-Skunkworks/go-jira/commit/659a5c8)]
+* Add error handling to pass password-source [Patrick Pichler] [[3339303](https://github.com/Netflix-Skunkworks/go-jira/commit/3339303)]
+* Add gopass support [Patrick Pichler] [[3c0a62e](https://github.com/Netflix-Skunkworks/go-jira/commit/3c0a62e)]
+* add sprig template functions, replaces [[#215](https://github.com/Netflix-Skunkworks/go-jira/issues/215)] http://masterminds.github.io/sprig/ [Cory Bennett] [[719f7a6](https://github.com/Netflix-Skunkworks/go-jira/commit/719f7a6)]
+* [[#232](https://github.com/Netflix-Skunkworks/go-jira/issues/232)] fix api to use common Version schema also rewrote the schema fetcher to use Go [Cory Bennett] [[90f01ce](https://github.com/Netflix-Skunkworks/go-jira/commit/90f01ce)]
+* fix syntax [Cory Bennett] [[94dd489](https://github.com/Netflix-Skunkworks/go-jira/commit/94dd489)]
+* Address comments for direct name match [Patrick Cockwell] [[a70384b](https://github.com/Netflix-Skunkworks/go-jira/commit/a70384b)]
+* Choose exact transition match if available [Patrick Cockwell] [[a646f76](https://github.com/Netflix-Skunkworks/go-jira/commit/a646f76)]
+* [[#277](https://github.com/Netflix-Skunkworks/go-jira/issues/277)] update figtree to latest [Cory Bennett] [[0e520a4](https://github.com/Netflix-Skunkworks/go-jira/commit/0e520a4)]
+* Switch over to using github.com/go-jira/jira, from gopkg.in [Mike Pountney] [[27f57b2](https://github.com/Netflix-Skunkworks/go-jira/commit/27f57b2)]
+* Add 'pctOf' and 'fit' template functions [Adriano Caloiaro] [[027adee](https://github.com/Netflix-Skunkworks/go-jira/commit/027adee)]
+* fix worklog template to allow multiline comments [Matthias Bethke] [[43e07f1](https://github.com/Netflix-Skunkworks/go-jira/commit/43e07f1)]
+* Allow reading password from stdin [Justin Ko] [[225e1dc](https://github.com/Netflix-Skunkworks/go-jira/commit/225e1dc)]
+* all: unindent some code [Daniel Martí] [[31c113d](https://github.com/Netflix-Skunkworks/go-jira/commit/31c113d)]
+* don't use ReadAll when decoding JSON [Daniel Martí] [[9bcdcc1](https://github.com/Netflix-Skunkworks/go-jira/commit/9bcdcc1)]
+* start making staticcheck happier [Daniel Martí] [[9b9186f](https://github.com/Netflix-Skunkworks/go-jira/commit/9b9186f)]
+* all: convert to a Go module [Daniel Martí] [[f125ef3](https://github.com/Netflix-Skunkworks/go-jira/commit/f125ef3)]
+* CI: test on Go 1.12.x, cleanup [Daniel Martí] [[664c5ca](https://github.com/Netflix-Skunkworks/go-jira/commit/664c5ca)]
+* make automatic pagination on search optional, fix tests [Cory Bennett] [[36c99ce](https://github.com/Netflix-Skunkworks/go-jira/commit/36c99ce)]
+* prefer defer resp.Body.Close to avoid leaks on subsequent errors [Cory Bennett] [[181bd74](https://github.com/Netflix-Skunkworks/go-jira/commit/181bd74)]
+* add pagination to search [Miles Maddox] [[76dd1d8](https://github.com/Netflix-Skunkworks/go-jira/commit/76dd1d8)]
+* Fix function comments based on best practices from Effective Go [CodeLingo Bot] [[23ac118](https://github.com/Netflix-Skunkworks/go-jira/commit/23ac118)]
+
+## 1.0.23 - 2020-02-26
+
+* update all usage of user.name to user.accountId for privacy migration: https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/ [Cory Bennett] [[a26683e](https://github.com/Netflix-Skunkworks/go-jira/commit/a26683e)]
+* add template functions to handle table output, fixes [#176](https://github.com/Netflix-Skunkworks/go-jira/issues/176), replaces [#296](https://github.com/Netflix-Skunkworks/go-jira/issues/296) [Cory Bennett] [[7e97463](https://github.com/Netflix-Skunkworks/go-jira/commit/7e97463)]
+* use `password-source-path` to allow overriding binary and/or path to binary [Cory Bennett] [[d6173ce](https://github.com/Netflix-Skunkworks/go-jira/commit/d6173ce)]
+* allow issues on command line to automatically prefix with project when defined [Cory Bennett] [[d002d7f](https://github.com/Netflix-Skunkworks/go-jira/commit/d002d7f)]
+* Forgot you use TAB instead of spaces [Cory Bennett] [[789886c](https://github.com/Netflix-Skunkworks/go-jira/commit/789886c)]
+* Fixed append project to view [Cory Bennett] [[8a46215](https://github.com/Netflix-Skunkworks/go-jira/commit/8a46215)]
+* Added a line break removal function [Cory Bennett] [[9cbd993](https://github.com/Netflix-Skunkworks/go-jira/commit/9cbd993)]
+* Pushed Readfile to .jira.d directory instead of pwd [Cory Bennett] [[db53622](https://github.com/Netflix-Skunkworks/go-jira/commit/db53622)]
+* Cache password to avoid invoking password source on each API request [Patrick Decat] [[0f059a5](https://github.com/Netflix-Skunkworks/go-jira/commit/0f059a5)]
+* Add support to switch out password source binary [Patrick Pichler] [[659a5c8](https://github.com/Netflix-Skunkworks/go-jira/commit/659a5c8)]
+* Add error handling to pass password-source [Patrick Pichler] [[3339303](https://github.com/Netflix-Skunkworks/go-jira/commit/3339303)]
+* Add gopass support [Patrick Pichler] [[3c0a62e](https://github.com/Netflix-Skunkworks/go-jira/commit/3c0a62e)]
+* add sprig template functions, replaces [[#215](https://github.com/Netflix-Skunkworks/go-jira/issues/215)] http://masterminds.github.io/sprig/ [Cory Bennett] [[719f7a6](https://github.com/Netflix-Skunkworks/go-jira/commit/719f7a6)]
+* [[#232](https://github.com/Netflix-Skunkworks/go-jira/issues/232)] fix api to use common Version schema also rewrote the schema fetcher to use Go [Cory Bennett] [[90f01ce](https://github.com/Netflix-Skunkworks/go-jira/commit/90f01ce)]
+
+## 1.0.22 - 2019-09-30
+
+* fix syntax [Cory Bennett] [[807ca76](https://github.com/Netflix-Skunkworks/go-jira/commit/807ca76)]
+* Address comments for direct name match [Patrick Cockwell] [[a70384b](https://github.com/Netflix-Skunkworks/go-jira/commit/a70384b)]
+* Choose exact transition match if available [Patrick Cockwell] [[a646f76](https://github.com/Netflix-Skunkworks/go-jira/commit/a646f76)]
+
+
+## 1.0.21 - 2019-09-16
+
+* [[#277](https://github.com/Netflix-Skunkworks/go-jira/issues/277)] update figtree to latest [Cory Bennett] [[0e520a4](https://github.com/Netflix-Skunkworks/go-jira/commit/0e520a4)]
+* Switch over to using github.com/go-jira/jira, from gopkg.in [Mike Pountney] [[27f57b2](https://github.com/Netflix-Skunkworks/go-jira/commit/27f57b2)]
+* fix worklog template to allow multiline comments [Matthias Bethke] [[43e07f1](https://github.com/Netflix-Skunkworks/go-jira/commit/43e07f1)]
+* Allow reading password from stdin [Justin Ko] [[225e1dc](https://github.com/Netflix-Skunkworks/go-jira/commit/225e1dc)]
+* all: unindent some code [Daniel Martí] [[31c113d](https://github.com/Netflix-Skunkworks/go-jira/commit/31c113d)]
+* don't use ReadAll when decoding JSON [Daniel Martí] [[9bcdcc1](https://github.com/Netflix-Skunkworks/go-jira/commit/9bcdcc1)]
+* start making staticcheck happier [Daniel Martí] [[9b9186f](https://github.com/Netflix-Skunkworks/go-jira/commit/9b9186f)]
+* all: convert to a Go module [Daniel Martí] [[f125ef3](https://github.com/Netflix-Skunkworks/go-jira/commit/f125ef3)]
+* CI: test on Go 1.12.x, cleanup [Daniel Martí] [[664c5ca](https://github.com/Netflix-Skunkworks/go-jira/commit/664c5ca)]
+* make automatic pagination on search optional, fix tests [Cory Bennett] [[36c99ce](https://github.com/Netflix-Skunkworks/go-jira/commit/36c99ce)]
+* prefer defer resp.Body.Close to avoid leaks on subsequent errors [Cory Bennett] [[181bd74](https://github.com/Netflix-Skunkworks/go-jira/commit/181bd74)]
+* add pagination to search [Miles Maddox] [[76dd1d8](https://github.com/Netflix-Skunkworks/go-jira/commit/76dd1d8)]
+* Fix function comments based on best practices from Effective Go [CodeLingo Bot] [[23ac118](https://github.com/Netflix-Skunkworks/go-jira/commit/23ac118)]
+* [[#201](https://github.com/Netflix-Skunkworks/go-jira/issues/201)] update required library, failing to populate cookiejar from cookies file [Cory Bennett] [[ee69afa](https://github.com/Netflix-Skunkworks/go-jira/commit/ee69afa)]
+
+## 1.0.20 - 2018-08-04
+
+* [[#201](https://github.com/Netflix-Skunkworks/go-jira/issues/201)] update required library, failing to populate cookiejar from cookies file [Cory Bennett] [[ee69afa](https://github.com/Netflix-Skunkworks/go-jira/commit/ee69afa)]
+
+## 1.0.19 - 2018-08-02
+
+* [[#199](https://github.com/Netflix-Skunkworks/go-jira/issues/199)] [[#198](https://github.com/Netflix-Skunkworks/go-jira/issues/198)] update http client library, fix issues with internal login retries [Cory Bennett] [[0cba806](https://github.com/Netflix-Skunkworks/go-jira/commit/0cba806)]
+
+## 1.0.18 - 2018-07-29
+
+* [[#196](https://github.com/Netflix-Skunkworks/go-jira/issues/196)] add `jira session` command to show session information if user is authenticated [Cory Bennett] [[f592107](https://github.com/Netflix-Skunkworks/go-jira/commit/f592107)]
+* [[#192](https://github.com/Netflix-Skunkworks/go-jira/issues/192)] fix template usage for 'fixVersions' in transition template [Cory Bennett] [[c9a4e30](https://github.com/Netflix-Skunkworks/go-jira/commit/c9a4e30)]
+* move HandleExit to the jiracli package [Cory Bennett] [[ef9b731](https://github.com/Netflix-Skunkworks/go-jira/commit/ef9b731)]
+* they broke golang.org/x/net: ERROR: vendor/golang.org/x/net/proxy/socks5.go:11:2: use of internal package not allowed [Cory Bennett] [[7191c77](https://github.com/Netflix-Skunkworks/go-jira/commit/7191c77)]
+* udpate deps [Cory Bennett] [[d16bcc2](https://github.com/Netflix-Skunkworks/go-jira/commit/d16bcc2)]
+* udpate for figtree api changes [Cory Bennett] [[07ba74b](https://github.com/Netflix-Skunkworks/go-jira/commit/07ba74b)]
+* udpate to use latest dep, update figtree [Cory Bennett] [[462ef1c](https://github.com/Netflix-Skunkworks/go-jira/commit/462ef1c)]
+* [[#171](https://github.com/Netflix-Skunkworks/go-jira/issues/171)] change proposed PasswordPath to PasswordName [Cory Bennett] [[213a7e0](https://github.com/Netflix-Skunkworks/go-jira/commit/213a7e0)]
+* add pass path to config [dvogt23] [[fa01ff5](https://github.com/Netflix-Skunkworks/go-jira/commit/fa01ff5)]
+
+## 1.0.17 - 2018-04-15
+
+* fix IsTerminal usage for windows [Cory Bennett] [[7f9595c](https://github.com/Netflix-Skunkworks/go-jira/commit/7f9595c)]
+* [[#166](https://github.com/Netflix-Skunkworks/go-jira/issues/166)] fix issue when editing templates specified with full path [Cory Bennett] [[d787ac0](https://github.com/Netflix-Skunkworks/go-jira/commit/d787ac0)]
+* only prompt on logout if stdin and stdout are terminals [Cory Bennett] [[09a61c3](https://github.com/Netflix-Skunkworks/go-jira/commit/09a61c3)]
+* [[#163](https://github.com/Netflix-Skunkworks/go-jira/issues/163)] fix url path join logic [Cory Bennett] [[9146346](https://github.com/Netflix-Skunkworks/go-jira/commit/9146346)]
+* [[#160](https://github.com/Netflix-Skunkworks/go-jira/issues/160)] prompt when api-token is invalid to get new token [Cory Bennett] [[e639cce](https://github.com/Netflix-Skunkworks/go-jira/commit/e639cce)]
+* [[#157](https://github.com/Netflix-Skunkworks/go-jira/issues/157)] add `password-directory: path` to allow overriding PASSWORD_STORE_DIR from configs [Cory Bennett] [[06b26c9](https://github.com/Netflix-Skunkworks/go-jira/commit/06b26c9)]
+* [[#160](https://github.com/Netflix-Skunkworks/go-jira/issues/160)] allow `jira logout` to delete your api-token from keychain [Cory Bennett] [[bd3cf99](https://github.com/Netflix-Skunkworks/go-jira/commit/bd3cf99)]
+
+## 1.0.16 - 2018-04-01
+
+* [[#159](https://github.com/Netflix-Skunkworks/go-jira/issues/159)] fix `slice bounds out of range` error in `abbrev` template function [Cory Bennett] [[359bec2](https://github.com/Netflix-Skunkworks/go-jira/commit/359bec2)]
+* [[#158](https://github.com/Netflix-Skunkworks/go-jira/issues/158)] always print usage to stdout [Cory Bennett] [[79c83f6](https://github.com/Netflix-Skunkworks/go-jira/commit/79c83f6)]
+
+## 1.0.15 - 2018-03-08
+
+* [[#147](https://github.com/Netflix-Skunkworks/go-jira/issues/147)] [[#148](https://github.com/Netflix-Skunkworks/go-jira/issues/148)] add support for api token based authentication [Cory Bennett] [[edb0662](https://github.com/Netflix-Skunkworks/go-jira/commit/edb0662)]
+* refactor to simplify main [Cory Bennett] [[43ebc84](https://github.com/Netflix-Skunkworks/go-jira/commit/43ebc84)] [[0d7c1a7](https://github.com/Netflix-Skunkworks/go-jira/commit/0d7c1a7)]
+* [[#145](https://github.com/Netflix-Skunkworks/go-jira/issues/145)] fix to match AuthProvider interface [Cory Bennett] [[80325a5](https://github.com/Netflix-Skunkworks/go-jira/commit/80325a5)]
+* [[#141](https://github.com/Netflix-Skunkworks/go-jira/issues/141)] better handling in responseError for non-json error responses [Cory Bennett] [[20a9666](https://github.com/Netflix-Skunkworks/go-jira/commit/20a9666)]
+* Update unexportTemplates.go [GitHub] [[6da9974](https://github.com/Netflix-Skunkworks/go-jira/commit/6da9974)]
+* [[#139](https://github.com/Netflix-Skunkworks/go-jira/issues/139)] add shellquote and toMinJson template functions [Cory Bennett] [[8c7ca38](https://github.com/Netflix-Skunkworks/go-jira/commit/8c7ca38)]
+* [[#137](https://github.com/Netflix-Skunkworks/go-jira/issues/137)] update kingpeon dep to allow access to dynamic command structure [Cory Bennett] [[425fa63](https://github.com/Netflix-Skunkworks/go-jira/commit/425fa63)]
+* field name is "comment" not "comments" [Cory Bennett] [[464742c](https://github.com/Netflix-Skunkworks/go-jira/commit/464742c)]
+
+## 1.0.14 - 2017-11-04
+
+* [[#131](https://github.com/Netflix-Skunkworks/go-jira/issues/131)] fix parsing global options before command execution (allow unixproxy/socksproxy to be set in config.yml) [Cory Bennett] [[042bc48](https://github.com/Netflix-Skunkworks/go-jira/commit/042bc48)]
+* add/update deps [Cory Bennett] [[a2e36e8](https://github.com/Netflix-Skunkworks/go-jira/commit/a2e36e8)]
+* add support for using socks proxy [onionjake] [[ff985f9](https://github.com/Netflix-Skunkworks/go-jira/commit/ff985f9)]
+
+## 1.0.13 - 2017-10-28
+
+* fix transition command [Cory Bennett] [[9597f9b](https://github.com/Netflix-Skunkworks/go-jira/commit/9597f9b)]
+* fix default values to load after parsing configs [Cory Bennett] [[c9b5054](https://github.com/Netflix-Skunkworks/go-jira/commit/c9b5054)]
+* add test to make sure IssueType.Fields does not disappear on regeneration [Cory Bennett] [[3966def](https://github.com/Netflix-Skunkworks/go-jira/commit/3966def)]
+* add tests for validating changes to auto-generated jiradata files [Cory Bennett] [[41d1a7c](https://github.com/Netflix-Skunkworks/go-jira/commit/41d1a7c)]
+* Fix typo in 'logout' command help [Cory Bennett] [[9000777](https://github.com/Netflix-Skunkworks/go-jira/commit/9000777)]
+* Add URL escaping to an additional issuetype call [Cory Bennett] [[7bfa241](https://github.com/Netflix-Skunkworks/go-jira/commit/7bfa241)]
+* Add --resolution option [Cory Bennett] [[e6600cf](https://github.com/Netflix-Skunkworks/go-jira/commit/e6600cf)]
+* Create Metadata Not Populated Correctly [Dillon Buchanan] [[093c510](https://github.com/Netflix-Skunkworks/go-jira/commit/093c510)]
+* add regexReplace template function [Dirk Heilig] [[d3e294e](https://github.com/Netflix-Skunkworks/go-jira/commit/d3e294e)]
+
+## 1.0.12 - 2017-10-04
+
+* add `{{env.VARNAME}}` template support to allow use of env vars [Cory Bennett] [[4d74554](https://github.com/Netflix-Skunkworks/go-jira/commit/4d74554)]
+
+## 1.0.11 - 2017-09-26
+
+* [[#115](https://github.com/Netflix-Skunkworks/go-jira/issues/115)] fix transition template for description [Cory Bennett] [[986cc78](https://github.com/Netflix-Skunkworks/go-jira/commit/986cc78)]
+* update edit command to set queryFields on search to match what is used in template [Cory Bennett] [[3913726](https://github.com/Netflix-Skunkworks/go-jira/commit/3913726)]
+* fix edit with query loop, allow continuation when not submitting previous issue [Cory Bennett] [[0ba8aa0](https://github.com/Netflix-Skunkworks/go-jira/commit/0ba8aa0)]
+* fix edit when priority is not set [Cory Bennett] [[098eb99](https://github.com/Netflix-Skunkworks/go-jira/commit/098eb99)]
+* flatten CommandRegistry list to make it more readable [Cory Bennett] [[2ddaed2](https://github.com/Netflix-Skunkworks/go-jira/commit/2ddaed2)]
+
+## 1.0.10 - 2017-09-18
+
+* clean up usage formatting, print aliases [Cory Bennett] [[9f433ac](https://github.com/Netflix-Skunkworks/go-jira/commit/9f433ac)]
+* fix edit [Cory Bennett] [[4c6b36c](https://github.com/Netflix-Skunkworks/go-jira/commit/4c6b36c)]
+* fix named query template expansion [Cory Bennett] [[a8eaa97](https://github.com/Netflix-Skunkworks/go-jira/commit/a8eaa97)]
+* fix usage message [Cory Bennett] [[cd3cfd8](https://github.com/Netflix-Skunkworks/go-jira/commit/cd3cfd8)]
+
+## 1.0.9 - 2017-09-17
+
+* need issuetype to use the default list table template now [Cory Bennett] [[3e8b9bd](https://github.com/Netflix-Skunkworks/go-jira/commit/3e8b9bd)]
+* [[#102](https://github.com/Netflix-Skunkworks/go-jira/issues/102)] add issuetype into the default queryfields and add it to the default `table` list template [Cory Bennett] [[c9d8dfb](https://github.com/Netflix-Skunkworks/go-jira/commit/c9d8dfb)]
+
+## 1.0.8 - 2017-09-17
+
+* [[#100](https://github.com/Netflix-Skunkworks/go-jira/issues/100)] add support for posting, fetching, listing and removing attachments [Cory Bennett] [[66eb7bf](https://github.com/Netflix-Skunkworks/go-jira/commit/66eb7bf)]
+
+## 1.0.7 - 2017-09-15
+
+* [[#87](https://github.com/Netflix-Skunkworks/go-jira/issues/87)] add various commands for interacting with epics [Cory Bennett] [[893454f](https://github.com/Netflix-Skunkworks/go-jira/commit/893454f)]
+
+## 1.0.6 - 2017-09-13
+
+* tweaks for templates in named queries to work better [Cory Bennett] [[00cba79](https://github.com/Netflix-Skunkworks/go-jira/commit/00cba79)]
+* [[#99](https://github.com/Netflix-Skunkworks/go-jira/issues/99)] add support for named queries to be stored in configs [Cory Bennett] [[fb43753](https://github.com/Netflix-Skunkworks/go-jira/commit/fb43753)]
+* [[#98](https://github.com/Netflix-Skunkworks/go-jira/issues/98)] add `--status` option for JQL filter on status with `list` command [Cory Bennett] [[5da04c1](https://github.com/Netflix-Skunkworks/go-jira/commit/5da04c1)]
+
+## 1.0.5 - 2017-09-11
+
+* use --gjq for GJson Query to filter json response data [Cory Bennett] [[608e586](https://github.com/Netflix-Skunkworks/go-jira/commit/608e586)]
+* fix field tag syntax [Cory Bennett] [[2c552ac](https://github.com/Netflix-Skunkworks/go-jira/commit/2c552ac)]
+* add '{{jira}}' template macro to refer to path of currently running jira command [Cory Bennett] [[941824d](https://github.com/Netflix-Skunkworks/go-jira/commit/941824d)]
+
+## 1.0.4 - 2017-09-08
+
+* update deps for kingpeon update use os.exec instead of syscall.exec for windows [Cory Bennett] [[86b963b](https://github.com/Netflix-Skunkworks/go-jira/commit/86b963b)]
+
+## 1.0.3 - 2017-09-06
+
+* [[#66](https://github.com/Netflix-Skunkworks/go-jira/issues/66)] add --started option to `jira worklog add` to change the start time for worklog [Cory Bennett] [[e6faee1](https://github.com/Netflix-Skunkworks/go-jira/commit/e6faee1)]
+* [[#45](https://github.com/Netflix-Skunkworks/go-jira/issues/45)] automatically add comment to issue even if transition does not support comment updates during transtion [Cory Bennett] [[c4be59c](https://github.com/Netflix-Skunkworks/go-jira/commit/c4be59c)]
+
+## 1.0.2 - 2017-09-06
+
+* update dependencies [Cory Bennett] [[aa876cd](https://github.com/Netflix-Skunkworks/go-jira/commit/aa876cd)]
+* update for github.com/AlecAivazis/survey => gopkg.in/AlecAivazis/survey.v1 package [Cory Bennett] [[9453179](https://github.com/Netflix-Skunkworks/go-jira/commit/9453179)]
+* use stdout to determin output terminal size [Cory Bennett] [[4d79af4](https://github.com/Netflix-Skunkworks/go-jira/commit/4d79af4)]
+
+## 1.0.1 - 2017-09-06
+
+* [[#13](https://github.com/Netflix-Skunkworks/go-jira/issues/13)] change default input syntax to not require escaping for special characters [Cory Bennett] [[1106558](https://github.com/Netflix-Skunkworks/go-jira/commit/1106558)]
+
+## 1.0.0 - 2017-09-05
+
+* fix build for windows [Cory Bennett] [[1b854da](https://github.com/Netflix-Skunkworks/go-jira/commit/1b854da)]
+* change the default log output format [Cory Bennett] [[f1b8c64](https://github.com/Netflix-Skunkworks/go-jira/commit/f1b8c64)]
+* tweak auto-login so it does not print the standard `jira login` command output [Cory Bennett] [[49f6cdc](https://github.com/Netflix-Skunkworks/go-jira/commit/49f6cdc)]
+* add --quiet global option [Cory Bennett] [[c226077](https://github.com/Netflix-Skunkworks/go-jira/commit/c226077)]
+* refactor to allow for --insecure and --unixproxy arguments [Cory Bennett] [[c0358eb](https://github.com/Netflix-Skunkworks/go-jira/commit/c0358eb)]
+* handle html response on expired cookies (require X-Ausername header to always be present) [Cory Bennett] [[21920c5](https://github.com/Netflix-Skunkworks/go-jira/commit/21920c5)]
+* allow login prompt to be interrupted [Cory Bennett] [[7ab6c22](https://github.com/Netflix-Skunkworks/go-jira/commit/7ab6c22)]
+* fmt -> log typo [Cory Bennett] [[bccf09f](https://github.com/Netflix-Skunkworks/go-jira/commit/bccf09f)]
+* make ~/.jira.d directory if not already present [Cory Bennett] [[e72479c](https://github.com/Netflix-Skunkworks/go-jira/commit/e72479c)]
+* fix go vet [Cory Bennett] [[e04b506](https://github.com/Netflix-Skunkworks/go-jira/commit/e04b506)]
+* fix tests [Cory Bennett] [[ba35f55](https://github.com/Netflix-Skunkworks/go-jira/commit/ba35f55)]
+* add OK printf [Cory Bennett] [[dc02181](https://github.com/Netflix-Skunkworks/go-jira/commit/dc02181)]
+* change --method to use -M for backwards compat [Cory Bennett] [[b120c0b](https://github.com/Netflix-Skunkworks/go-jira/commit/b120c0b)]
+* add resolution to dup'd issues when necessary [Cory Bennett] [[2638396](https://github.com/Netflix-Skunkworks/go-jira/commit/2638396)]
+* call correct function for `labels remove|set` commands [Cory Bennett] [[ad1a62a](https://github.com/Netflix-Skunkworks/go-jira/commit/ad1a62a)]
+* data argument is optional (for GET and DELETE requests) [Cory Bennett] [[4b60313](https://github.com/Netflix-Skunkworks/go-jira/commit/4b60313)]
+* fix usage, overrides not serialized correctly [Cory Bennett] [[84119a2](https://github.com/Netflix-Skunkworks/go-jira/commit/84119a2)]
+* fix `jira ISSUE-123` command line parsing [Cory Bennett] [[fa4ac25](https://github.com/Netflix-Skunkworks/go-jira/commit/fa4ac25)]
+* add logger object to jiracmd [Cory Bennett] [[aed952b](https://github.com/Netflix-Skunkworks/go-jira/commit/aed952b)]
+* refactor for GlobalOptions and CommonOptions [Cory Bennett] [[979da1f](https://github.com/Netflix-Skunkworks/go-jira/commit/979da1f)]
+* move commands from jiracli package to jiracmd package [Cory Bennett] [[0a5510b](https://github.com/Netflix-Skunkworks/go-jira/commit/0a5510b)]
+* use jiracli.Error object to disambiguate between kingpin errors and cli errors [Cory Bennett] [[fb1bfeb](https://github.com/Netflix-Skunkworks/go-jira/commit/fb1bfeb)]
+* fix stray newline for list table template [Cory Bennett] [[36c26c5](https://github.com/Netflix-Skunkworks/go-jira/commit/36c26c5)]
+* fix dynamic table output when not on tty [Cory Bennett] [[3942f6f](https://github.com/Netflix-Skunkworks/go-jira/commit/3942f6f)]
+* when using --verbose set the JIRA_DEBUG environment variable so custom-commands can auto enable verbose output [Cory Bennett] [[da9a2b2](https://github.com/Netflix-Skunkworks/go-jira/commit/da9a2b2)]
+* make `jira ISSUE-123` usage call `jira view ISSUE-123` [Cory Bennett] [[ec0858b](https://github.com/Netflix-Skunkworks/go-jira/commit/ec0858b)]
+* integrate kingpeon library to allow for custom commands via configuration [Cory Bennett] [[301a61f](https://github.com/Netflix-Skunkworks/go-jira/commit/301a61f)]
+* use terminal width to adjust list table output [Cory Bennett] [[2a081dd](https://github.com/Netflix-Skunkworks/go-jira/commit/2a081dd)]
+* set yaml/json tags for option structs [Cory Bennett] [[f52d2c4](https://github.com/Netflix-Skunkworks/go-jira/commit/f52d2c4)]
+* update generated data files [Cory Bennett] [[c89f11d](https://github.com/Netflix-Skunkworks/go-jira/commit/c89f11d)]
+* automatically login when anonymous user detected [Cory Bennett] [[21add54](https://github.com/Netflix-Skunkworks/go-jira/commit/21add54)]
+* refactor trivial objects in favor of arguments to static functions [Cory Bennett] [[1f345ce](https://github.com/Netflix-Skunkworks/go-jira/commit/1f345ce)]
+* set JIRA_OPERATION when parsing configs.  Use figtree config types for options to make defaulting work [Cory Bennett] [[5716a7c](https://github.com/Netflix-Skunkworks/go-jira/commit/5716a7c)]
+* add better handing for usage error [Cory Bennett] [[b235dcc](https://github.com/Netflix-Skunkworks/go-jira/commit/b235dcc)]
+* adding `request` command, removing dead code [Cory Bennett] [[56b1c9d](https://github.com/Netflix-Skunkworks/go-jira/commit/56b1c9d)]
+* adding Do required for request language [Cory Bennett] [[a1c2849](https://github.com/Netflix-Skunkworks/go-jira/commit/a1c2849)]
+* add `browse` command and implement -b option for most operations [Cory Bennett] [[a91b9d5](https://github.com/Netflix-Skunkworks/go-jira/commit/a91b9d5)]
+* fix IssueAssign [Cory Bennett] [[f32cc70](https://github.com/Netflix-Skunkworks/go-jira/commit/f32cc70)]
+* merge in update for upstream changes [#104](https://github.com/Netflix-Skunkworks/go-jira/issues/104) [Cory Bennett] [[19d8686](https://github.com/Netflix-Skunkworks/go-jira/commit/19d8686)]
+* add `export-templates` command [Cory Bennett] [[abaad56](https://github.com/Netflix-Skunkworks/go-jira/commit/abaad56)]
+* add `issuetypes` command [Cory Bennett] [[da39323](https://github.com/Netflix-Skunkworks/go-jira/commit/da39323)]
+* add `components` command [Cory Bennett] [[0bd3ca2](https://github.com/Netflix-Skunkworks/go-jira/commit/0bd3ca2)]
+* add `component add` command [Cory Bennett] [[cc90610](https://github.com/Netflix-Skunkworks/go-jira/commit/cc90610)]
+* add `take`, `unassign` and `assign|give` commands [Cory Bennett] [[959524a](https://github.com/Netflix-Skunkworks/go-jira/commit/959524a)]
+* adding `labels [add|set|remove]` commands [Cory Bennett] [[9161861](https://github.com/Netflix-Skunkworks/go-jira/commit/9161861)]
+* add `comment` command [Cory Bennett] [[f0b08c5](https://github.com/Netflix-Skunkworks/go-jira/commit/f0b08c5)]
+* add `watch` command [Cory Bennett] [[ec0ac3c](https://github.com/Netflix-Skunkworks/go-jira/commit/ec0ac3c)]
+* add `rank ISSUE after|before ISSUE` command [Cory Bennett] [[8b863d2](https://github.com/Netflix-Skunkworks/go-jira/commit/8b863d2)]
+* add `vote` command [Cory Bennett] [[a08c92f](https://github.com/Netflix-Skunkworks/go-jira/commit/a08c92f)]
+* add `issuelinktypes` command [Cory Bennett] [[37f81a4](https://github.com/Netflix-Skunkworks/go-jira/commit/37f81a4)]
+* add `issuelink` command [Cory Bennett] [[aacc9f4](https://github.com/Netflix-Skunkworks/go-jira/commit/aacc9f4)]
+* fix closing duplicate issue on `dup` command [Cory Bennett] [[fc696c3](https://github.com/Netflix-Skunkworks/go-jira/commit/fc696c3)]
+* rewrite checkpoint [Cory Bennett] [[36632a5](https://github.com/Netflix-Skunkworks/go-jira/commit/36632a5)]
+
+## 0.1.14 - 2017-05-10
+
+* fix unsafe casting for --quiet flag [Cory Bennett] [[6f29f43](https://github.com/Netflix-Skunkworks/go-jira/commit/6f29f43)]
+* [[#80](https://github.com/Netflix-Skunkworks/go-jira/issues/80)] add `jira unassign` and `jira give ISSUE --default` commands [Cory Bennett] [[03d8633](https://github.com/Netflix-Skunkworks/go-jira/commit/03d8633)]
+
+## 0.1.13 - 2017-04-24
+
+* work around `github.com/tmc/keyring` compile error for windows [Cory Bennett] [[85298e9](https://github.com/Netflix-Skunkworks/go-jira/commit/85298e9)]
+* Added generic issuelink command [David Reuss] [[cc54d11](https://github.com/Netflix-Skunkworks/go-jira/commit/cc54d11)]
+* Added --start parameter for pagination on results [David Reuss] [[9b94d9e](https://github.com/Netflix-Skunkworks/go-jira/commit/9b94d9e)]
+
+## 0.1.12 - 2017-03-22
+
+* Implement "browse" subcommand on Windows [Claus Brod] [[ca333d8](https://github.com/Netflix-Skunkworks/go-jira/commit/ca333d8)]
+
+## 0.1.11 - 2017-02-26
+
+* [[#69](https://github.com/Netflix-Skunkworks/go-jira/issues/69)] add subtask command [Cory Bennett] [[21a2ed5](https://github.com/Netflix-Skunkworks/go-jira/commit/21a2ed5)]
+
+## 0.1.10 - 2017-02-08
+
+* set GPG_TTY in .bashrc [Cory Bennett] [[b1e552f](https://github.com/Netflix-Skunkworks/go-jira/commit/b1e552f)]
+* force password in case password already exists [Cory Bennett] [[d5a2c3b](https://github.com/Netflix-Skunkworks/go-jira/commit/d5a2c3b)]
+* refactor password source, allow for "pass" to be used, update tests to use `password-source: pass` [Cory Bennett] [[5a71939](https://github.com/Netflix-Skunkworks/go-jira/commit/5a71939)]
+
+## 0.1.9 - 2016-12-18
+
+* only warn about needing login when not already running the login command [Cory Bennett] [[6c24e55](https://github.com/Netflix-Skunkworks/go-jira/commit/6c24e55)]
+* fix(http): Add proxy transport [William Hearn] [[4bd740b](https://github.com/Netflix-Skunkworks/go-jira/commit/4bd740b)] [[2dff6c9](https://github.com/Netflix-Skunkworks/go-jira/commit/2dff6c9)]
+
+## 0.1.8 - 2016-11-24
+
+* [[#12](https://github.com/Netflix-Skunkworks/go-jira/issues/12)] integrate with keyring for password storage and provide http basic auth credentials for every request since most jira services have websudo enabled with does not allow cookie based authentication [Cory Bennett] [[b8a6e57](https://github.com/Netflix-Skunkworks/go-jira/commit/b8a6e57)]
+* Cleaning up usage [Jay Shirley] [[8add52b](https://github.com/Netflix-Skunkworks/go-jira/commit/8add52b)]
+* Update usage [Jay Shirley] [[b56e32a](https://github.com/Netflix-Skunkworks/go-jira/commit/b56e32a)]
+* use gopkg.in for links to maintain version compatibility [Cory Bennett] [[1414d1f](https://github.com/Netflix-Skunkworks/go-jira/commit/1414d1f)]
+* golint [Cory Bennett] [[44cdebf](https://github.com/Netflix-Skunkworks/go-jira/commit/44cdebf)]
+* add "rank" command allow ordering backlog issues in agile projects [Cory Bennett] [[e4cc9c6](https://github.com/Netflix-Skunkworks/go-jira/commit/e4cc9c6)]
+* Adding a unixproxy mechanism [Jay Shirley] [[5b9c0dd](https://github.com/Netflix-Skunkworks/go-jira/commit/5b9c0dd)]
+
+## 0.1.7 - 2016-08-24
+
+* Prefer transition names which match exactly [Don Brower] [[e40f9c1](https://github.com/Netflix-Skunkworks/go-jira/commit/e40f9c1)]
+* update tempates to make them more readable with space trimming added to go-1.6 [Cory Bennett] [[693b3e4](https://github.com/Netflix-Skunkworks/go-jira/commit/693b3e4)]
+
+## 0.1.6 - 2016-08-21
+
+* make "worklogs" command print output through template allow "add worklog" command to open edit template [Cory Bennett] [[cc3fbee](https://github.com/Netflix-Skunkworks/go-jira/commit/cc3fbee)]
+* remove extra newline at end of worklogs template [Cory Bennett] [[d08ef15](https://github.com/Netflix-Skunkworks/go-jira/commit/d08ef15)]
+* adding worklog related templates [Cory Bennett] [[ab1cd27](https://github.com/Netflix-Skunkworks/go-jira/commit/ab1cd27)]
+
+## 0.1.5 - 2016-08-21
+
+* update for golint [Cory Bennett] [[5a4e17c](https://github.com/Netflix-Skunkworks/go-jira/commit/5a4e17c)]
+* fix for go vet [Cory Bennett] [[355fb42](https://github.com/Netflix-Skunkworks/go-jira/commit/355fb42)]
+
+## 0.1.4 - 2016-08-12
+
+* when running "dups" on a Process Management Project type, you have to start/stop the task to resolve it [Cory Bennett] [[2c91905](https://github.com/Netflix-Skunkworks/go-jira/commit/2c91905)]
+* allow for defaultResolution option for transition command [Cory Bennett] [[a328c2d](https://github.com/Netflix-Skunkworks/go-jira/commit/a328c2d)]
+* add "backlog" command for Kanban related Issues [Cory Bennett] [[5d39b23](https://github.com/Netflix-Skunkworks/go-jira/commit/5d39b23)]
+* fix --noedit flag with "dups" command [Cory Bennett] [[37c07fa](https://github.com/Netflix-Skunkworks/go-jira/commit/37c07fa)]
+* add "votes" and "labels" to default view template [Cory Bennett] [[6f73b8c](https://github.com/Netflix-Skunkworks/go-jira/commit/6f73b8c)]
+* add "blockerType" config param, for issueLinkType use for "blocks" command [Cory Bennett] [[30fd301](https://github.com/Netflix-Skunkworks/go-jira/commit/30fd301)]
+* update gitter room [Cory Bennett] [[4b822b1](https://github.com/Netflix-Skunkworks/go-jira/commit/4b822b1)]
+* default issuetype to "Bug" for project that have Bug, otherwise try "Task" [Cory Bennett] [[0c807b4](https://github.com/Netflix-Skunkworks/go-jira/commit/0c807b4)]
+* make view template only show fields that have values [Cory Bennett] [[8238fe8](https://github.com/Netflix-Skunkworks/go-jira/commit/8238fe8)]
+* make default create template only display fields if they are valid fields for the project [Cory Bennett] [[adc2ace](https://github.com/Netflix-Skunkworks/go-jira/commit/adc2ace)]
+* ignore empty json fields when processing templates [Cory Bennett] [[f5f3e28](https://github.com/Netflix-Skunkworks/go-jira/commit/f5f3e28)]
+* allow JIRA_LOG_FORMAT env variable to control log output format [Cory Bennett] [[469def0](https://github.com/Netflix-Skunkworks/go-jira/commit/469def0)]
+* remove extraneous debug [Cory Bennett] [[752a94d](https://github.com/Netflix-Skunkworks/go-jira/commit/752a94d)]
+* add logout command modify password prompt to echo masked password [Cory Bennett] [[8ad91be](https://github.com/Netflix-Skunkworks/go-jira/commit/8ad91be)]
+* tweak cookies to store hostname dump all http request/response with --verbose [Cory Bennett] [[f93fe79](https://github.com/Netflix-Skunkworks/go-jira/commit/f93fe79)]
+* load configs in order of closest to cwd (/etc/go-jira.yml is last) [Cory Bennett] [[f54267b](https://github.com/Netflix-Skunkworks/go-jira/commit/f54267b)]
+
+## 0.1.3 - 2016-07-30
+
+* [[#43](https://github.com/Netflix-Skunkworks/go-jira/issues/43)] add support for jira done|todo|prog commands [Cory Bennett] [[dd7d1cc](https://github.com/Netflix-Skunkworks/go-jira/commit/dd7d1cc)]
+* Reporter is not generally editable. [Mike Pountney] [[a637b43](https://github.com/Netflix-Skunkworks/go-jira/commit/a637b43)]
+
+## 0.1.2 - 2016-06-29
+
+* [[#44](https://github.com/Netflix-Skunkworks/go-jira/issues/44)] Close tmpfile before rename to work around "The process cannot access the file because it is being used by another process" error on windows. [Cory Bennett] [[0980f8e](https://github.com/Netflix-Skunkworks/go-jira/commit/0980f8e)]
+
+## 0.1.1 - 2016-06-28
+
+* use USERPROFILE instead of HOME for windows, rework paths to use filepath.Join for better cross platform support [Cory Bennett] [[adcedc4](https://github.com/Netflix-Skunkworks/go-jira/commit/adcedc4)]
+* Include templates from a system path [Mike Pountney] [[cf10f53](https://github.com/Netflix-Skunkworks/go-jira/commit/cf10f53)]
+* Added support for the ```expand``` option for Issues [tobyjoe] [[fb4afc9](https://github.com/Netflix-Skunkworks/go-jira/commit/fb4afc9)]
+* change for api changes to go-logging [Cory Bennett] [[7bfc6e8](https://github.com/Netflix-Skunkworks/go-jira/commit/7bfc6e8)]
+* Fix issuetype calls adding URL escaping [Jonathan Wright] [[e4a25e2](https://github.com/Netflix-Skunkworks/go-jira/commit/e4a25e2)]
+
+## 0.1.0 - 2016-01-29
+
+* Fixes [#32](https://github.com/Netflix-Skunkworks/go-jira/issues/32) - make path to cookieFile if it's not present [Mike Pountney] [[6644579](https://github.com/Netflix-Skunkworks/go-jira/commit/6644579)]
+* Add component/components support: add and list for now. [Mike Pountney] [[d7b3226](https://github.com/Netflix-Skunkworks/go-jira/commit/d7b3226)]
+* Tweak the CmdWatch contract and add watcher remove support [Mike Pountney] [[383847a](https://github.com/Netflix-Skunkworks/go-jira/commit/383847a)]
+* Amend vote/unvote to be vote/vote --down [Mike Pountney] [[797edef](https://github.com/Netflix-Skunkworks/go-jira/commit/797edef)]
+* Add 'vote' and 'unvote' [Mike Pountney] [[c95e66e](https://github.com/Netflix-Skunkworks/go-jira/commit/c95e66e)]
+
+## 0.0.20 - 2016-01-21
+
+* [issue [#28](https://github.com/Netflix-Skunkworks/go-jira/issues/28)] check to make sure we got back issuetypes for create metadata [Cory Bennett] [[ee0e780](https://github.com/Netflix-Skunkworks/go-jira/commit/ee0e780)]
+* Add insecure option for TLS endpoints [Brian Lalor] [[6a88bb9](https://github.com/Netflix-Skunkworks/go-jira/commit/6a88bb9)]
+* Correct naming of parameter: set/add/remove are actions. [Mike Pountney] [[303784f](https://github.com/Netflix-Skunkworks/go-jira/commit/303784f)]
+* Tweak CmdLabels args so that magic happens with CLI [Mike Pountney] [[40a7c65](https://github.com/Netflix-Skunkworks/go-jira/commit/40a7c65)]
+* Expose ViewTicket as per FindIssues [Mike Pountney] [[8977f3d](https://github.com/Netflix-Skunkworks/go-jira/commit/8977f3d)]
+* Add exposed versions of getTemplate and runTemplate [Mike Pountney] [[da6cbd5](https://github.com/Netflix-Skunkworks/go-jira/commit/da6cbd5)]
+* Add 'labels' command to set/add/remove labels [Mike Pountney] [[230b52d](https://github.com/Netflix-Skunkworks/go-jira/commit/230b52d)]
+* Add a 'join' func to the template engine [Mike Pountney] [[a7820fe](https://github.com/Netflix-Skunkworks/go-jira/commit/a7820fe)]
+* make "jira" golang package, move code from jira/cli to root, move jira/main.go to main/main.go [Cory Bennett] [[7268b9e](https://github.com/Netflix-Skunkworks/go-jira/commit/7268b9e)]
+
+## 0.0.19 - 2015-12-09
+
+* fix jira trans TRANS ISSUE (case sensitivity issue), also go fmt [Cory Bennett] [[3c30f3b](https://github.com/Netflix-Skunkworks/go-jira/commit/3c30f3b)]
+
+## 0.0.18 - 2015-12-03
+
+* need to default "quiet" to false [Cory Bennett] [[4f4a89b](https://github.com/Netflix-Skunkworks/go-jira/commit/4f4a89b)]
+
+## 0.0.17 - 2015-12-03
+
+* add --quiet command to not print the OK .. add --saveFile option to print the issue/link to a file on create command [Cory Bennett] [[c9ac162](https://github.com/Netflix-Skunkworks/go-jira/commit/c9ac162)]
+* fix overrides [Cory Bennett] [[eaddfe6](https://github.com/Netflix-Skunkworks/go-jira/commit/eaddfe6)]
+* add abstract request wrapper to allow you to access/process random apis supported by Jira but not yet supported by go-jira [Cory Bennett] [[90ef56a](https://github.com/Netflix-Skunkworks/go-jira/commit/90ef56a)]
+
+## 0.0.16 - 2015-11-23
+
+* jira edit should not require one arguemnt (allow for --query) [Cory Bennett] [[a1eb4a1](https://github.com/Netflix-Skunkworks/go-jira/commit/a1eb4a1)]
+
+## 0.0.15 - 2015-11-23
+
+* [[#17](https://github.com/Netflix-Skunkworks/go-jira/issues/17)] print usage on missing arguments [Cory Bennett] [[fd2a2fe](https://github.com/Netflix-Skunkworks/go-jira/commit/fd2a2fe)]
+
+## 0.0.14 - 2015-11-17
+
+* s/enpoint/endpoint/g [Oliver Schrenk] [[c5d251d](https://github.com/Netflix-Skunkworks/go-jira/commit/c5d251d)]
+* Implement dateFormat template command [Mike Pountney] [[68d3bae](https://github.com/Netflix-Skunkworks/go-jira/commit/68d3bae)]
+* Add 'updated' field to default queryfields. [Mike Pountney] [[91e2475](https://github.com/Netflix-Skunkworks/go-jira/commit/91e2475)]
+* Fix export-templates option (typo) [Mike Pountney] [[4d7fdb8](https://github.com/Netflix-Skunkworks/go-jira/commit/4d7fdb8)]
+* when yaml element resolves to "\n" strip it out so we dont post it to jira [Cory Bennett] [[47ced2f](https://github.com/Netflix-Skunkworks/go-jira/commit/47ced2f)]
+* print PUT/POST data when using --dryrun to help debug [Cory Bennett] [[618f245](https://github.com/Netflix-Skunkworks/go-jira/commit/618f245)]
+
+## 0.0.13 - 2015-09-19
+
+* replace dead/deprecated code.google.com/p/gopass with golang.org/x/crypto/ssh/terminal for reading password from stdin [Cory Bennett] [[909eb06](https://github.com/Netflix-Skunkworks/go-jira/commit/909eb06)]
+
+## 0.0.12 - 2015-09-18
+
+* fix exception from "jira create" [Cory Bennett] [[9348a4b](https://github.com/Netflix-Skunkworks/go-jira/commit/9348a4b)]
+* add some debug messages to help diagnose login failures [Cory Bennett] [[1c08a7d](https://github.com/Netflix-Skunkworks/go-jira/commit/1c08a7d)]
+
+## 0.0.11 - 2015-09-16
+
+* add --version [Cory Bennett] [[8385ee2](https://github.com/Netflix-Skunkworks/go-jira/commit/8385ee2)]
+* fix command line parser broken in 0.0.10 [Cory Bennett] [[15ae929](https://github.com/Netflix-Skunkworks/go-jira/commit/15ae929)]
+
+## 0.0.10 - 2015-09-15
+
+* allow for command aliasing in conjunction with executable config files. Issue #5 [Cory Bennett] [[23590d4](https://github.com/Netflix-Skunkworks/go-jira/commit/23590d4)]
+* update usage [Cory Bennett] [[ef7a57e](https://github.com/Netflix-Skunkworks/go-jira/commit/ef7a57e)]
+
+## 0.0.9 - 2015-09-15
+
+* use forked yaml.v2 so as to not lose line terminations present in jira fields [Cory Bennett] [[f84e77f](https://github.com/Netflix-Skunkworks/go-jira/commit/f84e77f)]
+* adding a |~ literal yaml syntax to just chomp a single newline (again to preserve existing formatting in jira fields) [Cory Bennett] [[f84e77f](https://github.com/Netflix-Skunkworks/go-jira/commit/f84e77f)]
+* for indent/comment allow for unicode line termination characters that yaml will use for parsing [Cory Bennett] [[f84e77f](https://github.com/Netflix-Skunkworks/go-jira/commit/f84e77f)]
+* fix "edit" default option, change how defaults are dealt with for filters [Cory Bennett] [[4265913](https://github.com/Netflix-Skunkworks/go-jira/commit/4265913)]
+* for edit template add issue id as comment, also add "comments" as comment so you can review the comment details while editing [Cory Bennett] [[968a9df](https://github.com/Netflix-Skunkworks/go-jira/commit/968a9df)]
+* add "comment" template filter to comment out multiline statements [Cory Bennett] [[d664868](https://github.com/Netflix-Skunkworks/go-jira/commit/d664868)]
+* add getOpt wrappers to get options with defaults [Cory Bennett] [[c0070cf](https://github.com/Netflix-Skunkworks/go-jira/commit/c0070cf)]
+* make --dryrun work [Cory Bennett] [[d229ac1](https://github.com/Netflix-Skunkworks/go-jira/commit/d229ac1)]
+* refactor config/option loading so command options override settings in config files [Cory Bennett] [[d229ac1](https://github.com/Netflix-Skunkworks/go-jira/commit/d229ac1)]
+* allow query options to be used on the "edit" command to iterate editing [Cory Bennett] [[d229ac1](https://github.com/Netflix-Skunkworks/go-jira/commit/d229ac1)]
+* remove duplication for defaults [Cory Bennett] [[f8c8ddf](https://github.com/Netflix-Skunkworks/go-jira/commit/f8c8ddf)]
+* use optigo for option parsing, drop docopt [Cory Bennett] [[7bbd571](https://github.com/Netflix-Skunkworks/go-jira/commit/7bbd571)]
+* allow "abort: true" to be set while editing to cancel the edit operation [Cory Bennett] [[ea67a77](https://github.com/Netflix-Skunkworks/go-jira/commit/ea67a77)]
+* if no changes are made on edit templates then abort edit [Cory Bennett] [[e69b65c](https://github.com/Netflix-Skunkworks/go-jira/commit/e69b65c)]
+
+## 0.0.8 - 2015-07-31
+
+* Add --max_results option for 'ls' [Mike Pountney] [[e06ff0c](https://github.com/Netflix-Skunkworks/go-jira/commit/e06ff0c)]
+
+## 0.0.7 - 2015-07-01
+
+* fix "take" command not honouring user option [Andrew Haigh] [[8f1d2b9](https://github.com/Netflix-Skunkworks/go-jira/commit/8f1d2b9)]
+* fix typo [Cory Bennett] [[06f57fe](https://github.com/Netflix-Skunkworks/go-jira/commit/06f57fe)]
+
+## 0.0.6 - 2015-02-27
+
+* allow --sort= to disable sort override [Cory Bennett] [[701f091](https://github.com/Netflix-Skunkworks/go-jira/commit/701f091)]
+* fix default JIRA_OPERATION env variable [Cory Bennett] [[82fd9b9](https://github.com/Netflix-Skunkworks/go-jira/commit/82fd9b9)]
+* automatically close duplicate issues with "Duplicate" resolution [Cory Bennett] [[ebf1700](https://github.com/Netflix-Skunkworks/go-jira/commit/ebf1700)]
+* set JIRA_OPERATION to "view" when no operation used (ie: jira GOJIRA-123) [Cory Bennett] [[050848a](https://github.com/Netflix-Skunkworks/go-jira/commit/050848a)]
+* add --sort option to "list" command [Cory Bennett] [[f359030](https://github.com/Netflix-Skunkworks/go-jira/commit/f359030)]
+
+## 0.0.5 - 2015-02-21
+
+* handle editor having arguments [Cory Bennett] [[7186fb3](https://github.com/Netflix-Skunkworks/go-jira/commit/7186fb3)]
+* add more template error handling [Cory Bennett] [[3e6f2b3](https://github.com/Netflix-Skunkworks/go-jira/commit/3e6f2b3)]
+* allow create template to specify defalt watchers with -o watchers=... [Cory Bennett] [[4db2e4e](https://github.com/Netflix-Skunkworks/go-jira/commit/4db2e4e)]
+* if config files are executable then run them and parse the output [Cory Bennett] [[7a2f7f5](https://github.com/Netflix-Skunkworks/go-jira/commit/7a2f7f5)]
+
+## 0.0.4 - 2015-02-19
+
+* add --template option to export-templates to export a single template [Cory Bennett] [[343fbb6](https://github.com/Netflix-Skunkworks/go-jira/commit/343fbb6)]
+* add "table" template to be used with "list" command [Cory Bennett] [[8954ec1](https://github.com/Netflix-Skunkworks/go-jira/commit/8954ec1)]
+
+## 0.0.3 - 2015-02-19
+
+* [issue [#8](https://github.com/Netflix-Skunkworks/go-jira/issues/8)] detect X-Seraph-Loginreason: AUTHENTICATION_DENIED header to catch login failures [Cory Bennett] [[2dcf665](https://github.com/Netflix-Skunkworks/go-jira/commit/2dcf665)]
+* project should always be uppercase [Jay Buffington] [[1b69d12](https://github.com/Netflix-Skunkworks/go-jira/commit/1b69d12)]
+* if response is 400, check json for errorMessages and log them [Jay Buffington] [[4924dfa](https://github.com/Netflix-Skunkworks/go-jira/commit/4924dfa)]
+* validate project [Jay Buffington] [[dc5ae42](https://github.com/Netflix-Skunkworks/go-jira/commit/dc5ae42)]
+
+## 0.0.2 - 2015-02-18
+
+* add missing --override options on transition command
+* add browse command
+
+## 0.0.1 - 2015-02-18
+
+* Initial experimental release

Makefile

@@ -1,20 +1,5 @@
-PLATFORMS= \
-	freebsd/amd64 \
-	linux/386 \
-	linux/amd64 \
-	windows/386 \
-	windows/amd64 \
-	darwin/amd64 \
-	$(NULL)
-
-	# freebsd-386 \
-	# freebsd-arm \
-	# linux-arm \
-	# openbsd-386 \
-	# openbsd-amd64 \
-	# darwin-386
-
 NAME=jira
+GO?=go
 
 OS=$(shell uname -s)
 ifeq ($(filter CYGWIN%,$(OS)),$(OS))
@@ -28,72 +13,37 @@ else
 	BIN ?= $(GOBIN)$(SEP)$(NAME)
 endif
 
-export GOPATH=$(CWD)
-
 DIST=$(CWD)$(SEP)dist
 
 GOBIN ?= $(CWD)
 
 CURVER ?= $(patsubst v%,%,$(shell [ -d .git ] && git describe --abbrev=0 --tags || grep ^\#\# CHANGELOG.md | awk '{print $$2; exit}'))
-LDFLAGS:=-X jira.VERSION=$(CURVER) -w
+LDFLAGS:= -w
+VERSION ?= development
 
-# use make DEBUG=1 and you can get a debuggable golang binary
-# see https://github.com/mailgun/godebug
-ifneq ($(DEBUG),)
-	GOBUILD=go get -v github.com/mailgun/godebug && ./bin/godebug build
-else
-	GOBUILD=go build -v -ldflags "$(LDFLAGS) -s"
-endif
-
-build: src/gopkg.in/Netflix-Skunkworks/go-jira.v0
-	$(GOBUILD) -o '$(BIN)' main/main.go
-
-debug:
-	$(MAKE) DEBUG=1
-
-src/%:
-	mkdir -p $(@D)
-	test -L $@ || ln -sf '../../..' $@
-	go get -v $* $*/main
+build:
+	$(GO) build -gcflags="-e" -v -ldflags "$(LDFLAGS) -s" -o '$(BIN)' cmd/jira/main.go
 
 vet:
-	@go vet .
-	@go vet ./data
-	@go vet ./main
+	@$(GO) vet .
+	@$(GO) vet ./jiracli
+	@$(GO) vet ./jiracmd
+	@$(GO) vet ./jiradata
+	@$(GO) vet ./cmd/jira
 
 lint:
-	@go get github.com/golang/lint/golint
-	@./bin/golint .
-	@./bin/golint ./data
-	@./bin/golint ./main
+	@$(GO) get github.com/golang/lint/golint
+	@golint .
+	@golint ./jiracli
+	@golint ./jiracmd
+	@golint ./jiradata
+	@golint ./cmd/jira
 
-cross-setup:
-	for p in $(PLATFORMS); do \
-        echo Building for $$p"; \
-		cd $(GOROOT)/src && sudo GOROOT_BOOTSTRAP=$(GOROOT) GOOS=$${p/-*/} GOARCH=$${p/*-/} bash ./make.bash --no-clean; \
-   done
-
-all: 
-	git push --tags
-	rm -rf src
-	${MAKE} src/gopkg.in/Netflix-Skunkworks/go-jira.v0
-	docker pull karalabe/xgo-latest
+all:
+	GO111MODULE=off $(GO) get -u github.com/mitchellh/gox
 	rm -rf dist
 	mkdir -p dist
-	docker run --rm -e EXT_GOPATH=/gopath -v $$(pwd):/gopath -e TARGETS="$(PLATFORMS)" -v $$(pwd)/dist:/build karalabe/xgo-latest gopkg.in/Netflix-Skunkworks/go-jira.v0/main
-	cd $(DIST) && for x in main-*; do mv $$x jira-$$(echo $$x | cut -c 6-); done
-
-# all:
-# 	rm -rf $(DIST); \
-# 	mkdir -p $(DIST); \
-# 	for p in $(PLATFORMS); do \
-#         echo "Building for $$p"; \
-#         ${MAKE} build GOOS=$${p/-*/} GOARCH=$${p/*-/} BIN=$(DIST)/$(NAME)-$$p; \
-#     done
-# 	for x in $(DIST)/jira-windows-*; do mv $$x $$x.exe; done
-
-fmt:
-	gofmt -s -w main/*.go *.go
+	gox -ldflags="-w -s" -ldflags="-X 'github.com/go-jira/jira.VERSION=$(VERSION)'" -output="dist/github.com/go-jira/jira-{{.OS}}-{{.Arch}}" -osarch="darwin/amd64 linux/386 linux/amd64 windows/386 windows/amd64" ./cmd/jira
 
 install:
 	${MAKE} GOBIN=$$HOME/bin build
@@ -102,7 +52,7 @@ NEWVER ?= $(shell echo $(CURVER) | awk -F. '{print $$1"."$$2"."$$3+1}')
 TODAY  := $(shell date +%Y-%m-%d)
 
 changes:
-	@git log --pretty=format:"* %s [%cn] [%h]" --no-merges ^v$(CURVER) HEAD main/*.go *.go | grep -vE 'gofmt|go fmt'
+	@git log --pretty=format:"* %s [%cn] [%h]" --no-merges ^v$(CURVER) HEAD *.go jiracli/*.go jiradata/*.go jiracmd/*.go cmd/*/*.go *.lock | grep -vE 'gofmt|go fmt|version bump'
 
 update-changelog:
 	@echo "# Changelog" > CHANGELOG.md.new; \
@@ -113,20 +63,39 @@ update-changelog:
 	perl -pe 's{\[([a-f0-9]+)\]}{[[$$1](https://github.com/Netflix-Skunkworks/go-jira/commit/$$1)]}g' | \
 	perl -pe 's{\#(\d+)}{[#$$1](https://github.com/Netflix-Skunkworks/go-jira/issues/$$1)}g' >> CHANGELOG.md.new; \
 	tail -n +2 CHANGELOG.md >> CHANGELOG.md.new; \
+    perl -pi -e 's{VERSION = "$(CURVER)"}{VERSION = "$(NEWVER)"}' jira.go; \
 	mv CHANGELOG.md.new CHANGELOG.md; \
-	git commit -m "Updated Changelog" CHANGELOG.md; \
+	$(NULL)
+
+update-usage:
+	@perl -pi -e 'undef $$/; s|\n```\nusage.*?```|"\n```\n".qx{./jira --help}."```"|esg' README.md
+
+release:
+	make update-usage
+	git diff --exit-code --quiet README.md || git commit -m "Updated Usage" README.md
+	git commit -m "Updated Changelog" CHANGELOG.md
+	git commit -m "version bump" jira.go
 	git tag v$(NEWVER)
+	git push --tags
 
 version:
 	@echo $(CURVER)
 
-clean:
-	rm -rf pkg dist bin src ./$(NAME)
+clean: clean-password-store
+	rm -rf ./$(NAME)
 
-export GNUPGHOME=$(CWD)/t/.gnupg
-export PASSWORD_STORE_DIR=$(CWD)/t/.password-store
-export JIRACLOUD=1
+clean-password-store:
+	rm -f "$(CWD)/_t/.password-store/GoJira/api-token:gojira@corybennett.org.gpg"
+	rm -f "$(CWD)/_t/.password-store/GoJira/api-token:mothra@corybennett.org.gpg"
 
-prove:
-	chmod -R g-rwx,o-rwx $(GNUPGHOME)
-	OSHT_VERBOSE=1 prove -v 
+test-password-store:
+	ln -s "api-token__gojira@corybennett.org.gpg" "$(CWD)/_t/.password-store/GoJira/api-token:gojira@corybennett.org.gpg"
+	ln -s "api-token__mothra@corybennett.org.gpg" "$(CWD)/_t/.password-store/GoJira/api-token:mothra@corybennett.org.gpg"
+
+prove: test-password-store
+	chmod -R g-rwx,o-rwx $(CWD)/_t/.gnupg
+	OSHT_VERBOSE=1 prove -v _t/*.t
+
+generate:
+	cd schemas && ./fetch-schemas.py
+	grep -h slipscheme jiradata/*.go | grep json | sort | uniq | awk -F\/\/ '{print $$2}' | while read cmd; do $$cmd; done

README.md

@@ -1,102 +1,57 @@
-[![Join the chat at https://gitter.im/go-jira-cli/help](https://badges.gitter.im/go-jira-cli/help.svg)](https://gitter.im/go-jira-cli/help?utm_source=badge&utm_medium=badge&utm_content=badge)
-[![Build Status](https://travis-ci.org/Netflix-Skunkworks/go-jira.svg?branch=master)](https://travis-ci.org/Netflix-Skunkworks/go-jira)
-[![GoDoc](https://godoc.org/gopkg.in/Netflix-Skunkworks/go-jira.v0?status.png)](https://godoc.org/gopkg.in/Netflix-Skunkworks/go-jira.v0)
-
+[![Build Status](https://travis-ci.org/go-jira/jira.svg?branch=master)](https://travis-ci.org/go-jira/jira)
+[![GoDoc](https://godoc.org/github.com/go-jira/jira?status.svg)](https://godoc.org/github.com/go-jira/jira)
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 
 # go-jira
-simple command line client for Atlassian's Jira service written in Go
 
-## Synopsis
+Simple command line client for Atlassian's Jira service written in Go.
 
-```bash
-jira ls -p GOJIRA                       # list all unresolved issues for project GOJIRA
-jira ls -p GOJIRA -a mothra             # as above also assigned to user mothra
-jira ls -p GOJIRA -w mothra             # lists GOJIRA unresolved issues watched by user mothra
-jira ls -p GOJIRA -r mothra             # list GOJIRA unresolved issues reported by user mothra
-jira ls -t table -p GOJIRA              # list all unresolved issues in pretty table output
+## GDPR USERNAME DISCLAIMER
 
-jira view GOJIRA-321                    # print Issue using "view" template
-jira GOJIRA-321                         # same as above
+When this tool was initial written the "username" parameter was widely used in the Atlassian API.
+Due to GDPR restrictions this parameter was been almost completely phased out other then V1 login.
+The "--user" field is still provided as a default global, however moving forward any usage of this field should be phased out in favor of the "--login" option. 
 
-jira edit GOJIRA-321                    # open up the issue in an editor, when you exit the
-                                        # editor the issue will post the updates to the server
+Commands which previously took a username will now expect an email address such as watch, create, assign, etc...
 
-# edit the issue, using the overrides on the command line, skip the interactive editor:
-jira edit GOJIRA-321 --noedit \
-     -o assignee=mothra \
-     -o comment="mothra, please take care of this." \
-     -o priority=Major
+## Install
 
-jira create -p GOJIRA                   # create new "Bug" type issue for project GOJIRA
-jira create -p GOJIRA -i Task           # create new Task type issue
+### Download
 
-jira trans close GOJIRA-321             # close issue, with interactive editor to set fields
-jira close GOJIRA-321 --edit            # same as above
+You can download one of the pre-built binaries for **go-jira** [here](https://github.com/go-jira/jira/releases).
 
-# close the issue, set the resolution, and skip interactive editor:
-jira trans close GOJIRA-321 -o resolution="Won't Fix" --noedit
-# same as above
-jira close GOJIRA-321 -o resolution="Won't Fix"
+### Build
 
-jira reopen GOJIRA-321 -m "reopening"  # reopen issue
+You can build and install the official repository with [Go](https://golang.org/dl/) (before running the below command, ensure you have `GO111MODULE=on` set in your environment):
 
-jira watch GOJIRA-321                   # add self as watcher to the issue
+	go get github.com/go-jira/jira/cmd/jira
 
-jira comment GOJIRA-321 -m "done yet?"  # add comment to the issue
+This will checkout this repository into `$GOPATH/src/github.com/go-jira/jira/`, build, and install it.
 
-jira take GOJIRA-321                    # assign issue to self
+It should then be available in $GOPATH/bin/jira.
 
-jira give GOJIRA-321 mothra             # assign issue to user mothra
+## Usage
 
-# create local project config to set defaults
-mkdir .jira.d
-echo "project: GOJIRA" > .jira.d/config.yml
 
-jira ls                                 # list all unresolved issues for project GOJRIA
-jira ls -a mothra                       # as above also assigned to user mothra
-jira ls -w mothra                       # lists GOJIRA unresolved issues watched by user mothra
-jira ls -r mothra                       # list GOJIRA unresolved issues reported by user mothra
-jira ls -t table                        # list all unresolved issues in pretty table output
+#### Setting up TAB completion
 
-jira create                             # create new "Bug" type issue for project GOJIRA
-jira create -i Task                     # create new Task type issue
+Since go-jira is built with the "kingpin" golang command line library we support bash/zsh shell completion automatically:
 
-# make the table template your default "list" template:
-jira export-templates -t table
-mv $HOME/.jira.d/templates/table $HOME/.jira.d/templates/list
-```
+ * <https://github.com/alecthomas/kingpin/tree/v2.2.5#bashzsh-shell-completion>
 
-## Download
+For example, in bash, adding something along the lines of:
 
-You can download one of the pre-built binaries for **go-jira** [here](https://github.com/Netflix-Skunkworks/go-jira/releases).
+  `eval "$(jira --completion-script-bash)"`
 
-## Build
-
-* **NOTE** You will need **`go-1.4.1`** minimum
-
-*  To build the `jira` binary the current directory just run:
-```bash
-make
-```
-* To install the binary to you ~/bin directory you can run:
-```bash
-make install
-```
+to your bashrc, or .profile (assuming go-jira binary is already in your path) will cause jira to offer tab completion behavior.
 
 ## Configuration
 
-**go-jira** uses a configuration hierarchy.  When loading the configuration from disk it will recursively look through
-all parent directories in your current path looking for a **.jira.d** directory.  If your current directory is not
-a child directory of your homedir, then your homedir will also be inspected for a **.jira.d** directory.  From all of **.jira.d** directories
-discovered **go-jira** will load a **config.yml** if found.  The configuration properties found in a file closests to your current working directory
-will have precedence.  Properties overriden with command line options will have final precedence.
+**go-jira** uses a configuration hierarchy.  When loading the configuration from disk it will recursively look through all parent directories in your current path looking for a **.jira.d** directory.  If your current directory is not a child directory of your homedir, then your homedir will also be inspected for a **.jira.d** directory.  From all of **.jira.d** directories discovered **go-jira** will load a **&lt;command&gt;.yml** file (ie for `jira list` it will load `.jira.d/list.yml`) then it will merge in any properties from the **config.yml** if found.  The configuration properties found in a file closest to your current working directory will have precedence.  Properties overridden with command line options will have final precedence.
 
-The complicated configuration hierarchy is used because **go-jira** attempts to be context aware.  For example, if you are working on a "foo" project and
-you `cd` into your project workspace, wouldn't it be nice if `jira ls` automatically knew to list only issues related to the "foo" project?  Likewise when you
-`cd` to the "bar" project then `jira ls` should only list issues related to "bar" project.  You can do this with by creating a configuration under your project
-workspace at **./.jira.d/config.yml** that looks like:
+The complicated configuration hierarchy is used because **go-jira** attempts to be context aware.  For example, if you are working on a "foo" project and you `cd` into your project workspace, wouldn't it be nice if `jira ls` automatically knew to list only issues related to the "foo" project?  Likewise when you `cd` to the "bar" project then `jira ls` should only list issues related to "bar" project.  You can do this with by creating a configuration under your project workspace at **./.jira.d/config.yml** that looks like:
 
-```
+```yaml
 project: foo
 ```
 
@@ -122,7 +77,7 @@ If the **.jira.d/config.yml** file is executable, then **go-jira** will attempt
 echo "endpoint: https://jira.mycompany.com"
 echo "editor: emacs -nw"
 
-case $JIRA_OPERATION in 
+case $JIRA_OPERATION in
     list)
       echo "template: table";;
 esac
@@ -142,10 +97,159 @@ case $JIRA_OPERATION in
 esac
 ```
 
+### Custom Commands
+You can now create custom commands for `jira` just by editing your `.jira.d/config.yml` config file.  These commands are effectively shell-scripts that can have documented options and arguments. The basic format is like:
+```yaml
+custom-commands:
+  - command1
+  - command2
+```
+##### Commands
+Where the individual commands are maps with these keys:
+* `name: string` [**required**] This is the command name, so for `jira foobar` you would have `name: foobar`
+* `help: string` This is help message displayed in the usage for the command
+* `hidden: bool` This command will be hidden from users, but still executable.  Sometimes useful for constructing complex commands where one custom command might call another.
+* `default: bool` Use this for compound command groups.  If you wanted to have `jira foo bar` and `jira foo baz` you would have two commands with `name: foo bar` and `name: foo baz`.  Then if you wanted `jira foo baz` to be called by default when you type `jira foo` you would set `default: true` for that custom command.
+* `options: list`  This is the list of possible option flags that the command will accept
+* `args: list` This is the list of command arguments (like the ISSUE) that the command will accept.
+* `aliases: string list`: This is a list of alternate names that the user can provide on the command line to run the same command.  Typically used to shorten the command name or provide alternatives that users might expect.
+* `script: string` [**required**] This is the script that will be executed as the action for this command. The value will be treated as a template and substitutions for options and arguments will be made before executing.
+
+##### Options
+These are possible keys under the command `options` property:
+* `name: string` [**required**] Name of the option, so `name: foobar` will result in `--foobar` option.
+* `help: string` The help message displayed in usage for the option.
+* `type: string`:  The type of the option, can be one of these values: `BOOL`, `COUNTER`, `ENUM`, `FLOAT32`, `FLOAT64`, `INT8`, `INT16`, `INT32`, `INT64`, `INT`, `STRING`, `STRINGMAP`, `UINT8`, `UINT16`, `UINT32`,  `UINT64` and `UINT`.  Most of these are primitive data types an should be self-explanatory.  The default type is `STRING`. There are some special types:
+  * `COUNTER` will be an integer type that increments each time the option is used.  So something like `--count --count` will results in `{{options.count}}` of `2`.
+  * `ENUM` type is used with the `enum` property.  The raw type is a string and **must** be one of the values listed in the `enum` property.
+  * `STRINGMAP` is a `string => string` map with the format of `KEY=VALUE`.  So `--override foo=bar --override bin=baz` will allow for `{{options.override.foo}}` to be `bar` and `{{options.override.bin}}` to be `baz`.
+* `short: char` The single character option to be used so `short: c` will allow for `-c`.
+* `required: bool` Indicate that this option must be provided on the command line.  Conflicts with the `default` property.
+* `default: any` Specify the default value for the option.  Conflicts with the `required` property.
+* `hidden: bool` Hide the option from the usage help message, but otherwise works fine.  Sometimes useful for developer options that user should not play with.
+* `repeat: bool` Indicate that this option can be repeated.  Not applicable for `COUNTER` and `STRINGMAP` types.  This will turn the option value into an array that you can iterate over.  So `--day Monday --day Thursday` can be used like `{{range options.day}}Day: {{.}}{{end}}`
+* `enum: string list` Used with the `type: ENUM` property, it is a list of strings values that represent the set of possible values the option accepts.
+
+##### Arguments
+These are possible keys under the command `args` property:
+* `name: string` [**required**] Name of the option, so `name: ISSUE` will show in the usage as `jira <command> ISSUE`.  This also represents the name of the argument to be used in the script template, so `{{args.ISSUE}}`.
+* `help: string` The help message displayed in usage for the argument.
+* `type: string`:  The type of the argument, can be one of these values: `BOOL`, `COUNTER`, `ENUM`, `FLOAT32`, `FLOAT64`, `INT8`, `INT16`, `INT32`, `INT64`, `INT`, `STRING`, `STRINGMAP`, `UINT8`, `UINT16`, `UINT32`,  `UINT64` and `UINT`.  Most of these are primitive data types an should be self-explanatory.  The default type is `STRING`.  There are some special types:
+  * `COUNTER` will be an integer type that increments each the argument is provided  So something like `jira <command> ISSUE-12 ISSUE-23` will results in `{{args.ISSUE}}` of `2`.
+  * `ENUM` type is used with the `enum` property.  The raw type is a string and **must** be one of the values listed in the `enum` property.
+  * `STRINGMAP` is a `string => string` map with the format of `KEY=VALUE`.  So `jira <command> foo=bar bin=baz` along with a `name: OVERRIDE` property will allow for `{{args.OVERRIDE.foo}}` to be `bar` and `{{args.OVERRIDE.bin}}` to be `baz`.
+* `required: bool` Indicate that this argument must be provided on the command line.  Conflicts with the `default` property.
+* `default: any` Specify the default value for the argument.  Conflicts with the `required` property.
+* `repeat: bool` Indicate that this argument can be repeated.  Not applicable for `COUNTER` and `STRINGMAP` types.  This will turn the template value into an array that you can iterate over.  So `jira <command> ISSUE-12 ISSUE-23` can be used like `{{range args.ISSUE}}Issue: {{.}}{{end}}`
+* `enum: string list` Used with the `type: ENUM` property, it is a list of strings values that represent the set of possible values for the argument.
+
+##### Script Template
+The `script` property is a template that would produce `/bin/sh` compatible syntax after the template has been processed.  There are 2 key template functions `{{args}}` and `{{options}}` that return the parsed arguments and option flags as a map.
+
+To demonstrate how you might use args and options here is a `custom-test` command:
+```yaml
+custom-commands:
+  - name: custom-test
+    help: Testing the custom commands
+    options:
+      - name: abc
+        short: a
+        default: default
+      - name: day
+        type: ENUM
+        enum:
+          - Monday
+          - Tuesday
+          - Wednesday
+          - Thursday
+          - Friday
+        required: true
+    args:
+      - name: ARG
+        required: true
+      - name: MORE
+        repeat: true
+    script: |
+      echo COMMAND {{args.ARG}} --abc {{options.abc}} --day {{options.day}} {{range $more := args.MORE}}{{$more}} {{end}}
+```
+
+Then to run it:
+```
+$ jira custom-test
+ERROR Invalid Usage: required flag --day not provided
+
+$ jira custom-test --day Sunday
+ERROR Invalid Usage: enum value must be one of Monday,Tuesday,Wednesday,Thursday,Friday, got 'Sunday'
+
+$ jira custom-test --day Tuesday
+ERROR Invalid Usage: required argument 'ARG' not provided
+
+$ jira custom-test --day Tuesday arg1
+COMMAND arg1 --abc default --day Tuesday
+
+$ jira custom-test --day Tuesday arg1 more1 more2 more3
+COMMAND arg1 --abc default --day Tuesday more1 more2 more3
+
+$ jira custom-test --day Tuesday arg1 more1 more2 more3 --abc non-default
+COMMAND arg1 --abc non-default --day Tuesday more1 more2 more3
+
+$ jira custom-test --day Tuesday arg1 more1 more2 more3 -a short-non-default
+COMMAND arg1 --abc short-non-default --day Tuesday more1 more2 more3
+```
+
+The script has access to all the environment variables that are in your current environment plus those that `jira` will set.  `jira` sets environment variables for each config property it has parsed from `.jira.d/config.yml` or the command configs at `.jira.d/<command>.yml`.  It might be useful to see all environment variables that `jira` is producing, so here is a simple custom command to list them:
+```yaml
+custom-commands:
+  - name: env
+    help: print the JIRA environment variables available to custom commands
+    script: |
+      env | grep JIRA
+ ```
+
+You could use the environment variables automatically, so if your `.jira.d/config.yml` looks something like this:
+```yaml
+project: PROJECT
+custom-commands:
+  - name: print-project
+    help: print the name of the configured project
+    script: "echo $JIRA_PROJECT"
+```
+
+##### Examples
+
+* `jira mine` for listing issues assigned to you
+```yaml
+custom-commands:
+  - name: mine
+    help: display issues assigned to me
+    script: |-
+      if [ -n "$JIRA_PROJECT" ]; then
+          # if `project: ...` configured just list the issues for current project
+          {{jira}} list --template table --query "resolution = unresolved and assignee=currentuser() and project = $JIRA_PROJECT ORDER BY priority asc, created"
+      else
+          # otherwise list issues for all project
+          {{jira}} list --template table --query "resolution = unresolved and assignee=currentuser() ORDER BY priority asc, created"
+      fi
+```
+* `jira sprint` for listing issues in your current sprint
+```yaml
+custom-commands:
+  - name: sprint
+    help: display issues for active sprint
+    script: |-
+      if [ -n "$JIRA_PROJECT" ]; then
+          # if `project: ...` configured just list the issues for current project
+          {{jira}} list --template table --query "sprint in openSprints() and type != epic and resolution = unresolved and project=$JIRA_PROJECT ORDER BY rank asc, created"
+      else
+          # otherwise list issues for all project
+          {{jira}} list --template table --query "sprint in openSprints() and type != epic and resolution = unresolved ORDER BY rank asc, created"
+      fi
+```
+
 ### Editing
 
 When you run command like `jira edit` it will open up your favorite editor with the templatized output so you can quickly edit.  When the editor
-closes **go-jira** will submit the completed form.  The order which **go-jira** attempts to determine your prefered editor is:
+closes **go-jira** will submit the completed form.  The order which **go-jira** attempts to determine your preferred editor is:
 
 * **editor** property in any config.yml file
 * **JIRA_EDITOR** environment variable
@@ -164,9 +268,9 @@ hard-coded templates with `jira export-templates` which will write them to **~/.
 
 #### Writing/Editing Templates
 
-First the basic templating functionality is defined by the Go language 'text/template' library.  The library reference documentation can be found [here](https://golang.org/pkg/text/template/), and there is a good primer document [here](https://gohugo.io/templates/go-templates/).  `go-jira` also provides a few extra helper functions to make it a bit easlier to format the data, those functions are defined [here](https://github.com/Netflix-Skunkworks/go-jira/blob/master/util.go#L133).
+First the basic templating functionality is defined by the Go language 'text/template' library.  The library reference documentation can be found [here](https://golang.org/pkg/text/template/), and there is a good primer document [here](https://gohugo.io/templates/go-templates/).  `go-jira` also provides a few extra helper functions to make it a bit easier to format the data, those functions are defined [here](https://github.com/go-jira/jira/blob/master/jiracli/templates.go#L64).
 
-Knowing what data and fields are available to any given template is not obvious. The easiest approach to determine what is available is to use the `debug` template on any given operation.  For eample to find out what is available to the "view" templates, you can use:
+Knowing what data and fields are available to any given template is not obvious. The easiest approach to determine what is available is to use the `debug` template on any given operation.  For example to find out what is available to the "view" templates, you can use:
 ```
 jira view GOJIRA-321 -t debug
 ```
@@ -176,29 +280,63 @@ This will print out the data in JSON format that is available to the template.
 jira list -t debug
 ```
 
-Figuring out what is available to input templates (like for the `create` operation) is a bit more tricky, but similar.  To find the data available for a `create` template you can run:
-```
-jira create --dryrun -t debug --editor /bin/cat
-```
-This will attempt to fetch metadata for your default project (you can provide any options that you would normally specify for the `create` operation).  It uses the `--dryrun` option to prevent any actual updates being sent to Jira.  The `-t debug` is like before to cause the input to be serialized to JSON and printed for your inspection.  Finally the `--editor /bin/cat` will cause `go-jira` to just print the template rather than open up an editor and wait for you to edit/save it.
-
 ### Authentication
 
-By default `go-jira` will prompt for a password automatically when we receive an 403 http response.  Then after authentication we cache the JSESSSION cookie returned by the service and reuse that on subsequent requests.  Typically this cookie will be valid for several hours (depending on the service configuration).  Many deployments of Jira (like the cloud services on atlassian.net) have "websudo" enabled which will prevent the cookie based authentcation from working.  On these deployments you have a few options with `go-jira`.  You can enable a `password-source` via `.jira.d/config.yml` with possible values of `keyring` or `pass`.
+#### Atlassian Cloud
 
-#### keyring password source
-**Note: Version 0.1.9 required.**
+For Atlassian Cloud hosted Jira [API Tokens are now required](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-basic-auth-and-cookie-based-auth/).  You will automatically be prompted for an API Token if your jira endpoint ends in `.atlassian.net`.
+
+##### Quickstart API Token and Keychain
+
+1. Edit your config or execute the snippit (make sure to replace `<SUBDOMAIN>` and `<EMAIL>`)
+```
+export SUBDOMAIN="https://<SUBDOMAIN>.atlassian.net"
+export EMAIL="<EMAIL>"
+mkdir -p ~/.jira.d
+printf "endpoint: $SUBDOMAIN\nuser: $EMAIL\npassword-source: keyring" > ~/.jira.d/config.yml
+```
+2. Create a new API Token at [id.atlassian.com](https://id.atlassian.com/manage-profile/security)
+3. Execute `jira session` and enter your API Token. `jira` will add your session to the keyring.
+
+#### Private Jira Service
+If you are using a private Jira service, you can force `jira` to use an api-token by setting the `authentication-method: api-token` property in your `$HOME/.jira.d/config.yml` file.  The API Token needs to be presented to the Jira service on every request, so it is recommended to store this API Token security within your OS's keyring, or using the `pass`/`gopass` service as documented below so that it can be programmatically accessed via `jira` and not prompt you every time.  For a less-secure option you can also provide the API token via a `JIRA_API_TOKEN` environment variable.  If you are unable to use an api-token for an Atlassian Cloud hosted Jira then you can still force `jira` to use the old session based authentication (until it the hosted system stops accepting it) by setting `authentication-method: session`.
+
+The API Token authentication requires both the token and the email of the user. The email mut be set in the  `user:` in your config.yml. Failure to provide the `user` will result in a 401 error.
+
+If your Jira service still allows you to use the Session based authentication method then `jira` will prompt for a password automatically when get a response header from the Jira service that indicates you do not have an active session (ie the `X-Ausername` header is set to `anonymous`).  Then after authentication we cache the `cloud.session.token` cookie returned by the service [session login api](https://docs.atlassian.com/jira/REST/cloud/#auth/1/session-login) and reuse that on subsequent requests.  Typically this cookie will be valid for several hours (depending on the service configuration).  To automatically securely store your password for easy reuse by jira You can enable a `password-source` via `.jira.d/config.yml` with possible values of `keyring`, `pass` or `gopass`.
+
+Depending on how your private Jira service is configured, API tokens may require the "[Bearer][]" authentication scheme instead of the traditional "[Basic][]" [authentication scheme][scheme]. In this case, set the `authentication-method: bearer-token` property in your `$HOME/.jira.d/config.yml` file.
+
+[scheme]: https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication#authentication_schemes
+[Bearer]: https://datatracker.ietf.org/doc/html/rfc6750
+[Basic]: https://tools.ietf.org/html/rfc7617
+
+| **API token [scheme][]** | `authentication-method` | **Example HTTP request header**                 |
+|:------------------------:|-------------------------|-------------------------------------------------|
+|        [Basic][]         | `api-token`             | `Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQK` |
+|        [Bearer][]        | `bearer-token`          | `Authorization: Bearer MY_TOKEN`                |
+
+#### User vs Login
+The Jira service has sometimes differing opinions about how a user is identified.  In other words the ID you login with might not be ID that the jira system recognized you as.  This matters when trying to identify a user via various Jira REST APIs (like issue assignment).  This is especially relevant when trying to authenticate with an API Token where the authentication user is usually an email address, but within the Jira system the user is identified by a user name.  To accommodate this `jira` now supports two different properties in the config file.  So when authentication using the API Tokens you will likely want something like this in your `$HOME/.jira.d/config.yml` file:
+```yaml
+user: person
+login: person@example.com
+```
+
+You can also override these values on the command line with `jira --user person --login person@example.com`.  The `login` value will be used only for authentication purposes, the `user` value will be used when a user name is required for any Jira service API calls.
+
+#### `keyring` password source
 On OSX and Linux there are a few keyring providers that `go-jira` can use (via this [golang module](https://github.com/tmc/keyring)).  To integrate `go-jira` with a supported keyring just add this configuration to `$HOME/.jira.d/config.yml`:
 ```yaml
 password-source: keyring
 ```
-After setting this and issuing a `jira login`, your credentials will be stored in your platform's backend (e.g. Keychain for Mac OS X) automatically. Subsequent operations, like a `jira ls`, should "just work" from there.
+After setting this and issuing a `jira login`, your credentials will be stored in your platform's backend (e.g. Keychain for Mac OS X) automatically. Subsequent operations, like a `jira ls`, should automatically login.
 
 #### `pass` password source
-**Note: Version 0.1.9 required.**
 An alternative to the keyring password source is the `pass` tool (documentation [here](https://www.passwordstore.org/)).  This uses gpg to encrypt/decrypt passwords on demand and by using `gpg-agent` you can cache the gpg credentials for a period of time so you will not be prompted repeatedly for decrypting the passwords.  The advantage over the keyring integration is that `pass` can be used on more platforms than OSX and Linux, although it does require more setup.  To use `pass` for password storage and retrieval via `go-jira` just add this configuration to `$HOME/.jira.d/config.yml`:
 ```yaml
 password-source: pass
+password-name: jira.example.com/myuser
 ```
 
 This assumes you have already setup `pass` correctly on your system.  Specifically you will need to have created a gpg key like this:
@@ -222,84 +360,69 @@ Then initialize the `pass` tool to use the correct key:
 $ pass init "Go Jira <gojira@example.com>"
 ```
 
-You probably want to setup gpg-agent so that you dont have to type in your gpg passphrase all the time.  You can get `gpg-agent` to automatically start by adding something like this to your `$HOME/.bashrc`
+Now insert your password with the name you configured.
+
+```
+$ pass insert jira.example.com/myuser
+```
+
+You probably want to setup gpg-agent so that you don't have to type in your gpg passphrase all the time.  You can get `gpg-agent` to automatically start by adding something like this to your `$HOME/.bashrc`
 ```bash
 if [ -f $HOME/.gpg-agent-info ]; then
     . $HOME/.gpg-agent-info
     export GPG_AGENT_INFO
 fi
-# verify sock file from GPG_AGENT_INFO is actually present
-if [ ! -S "${GPG_AGENT_INFO%%:*}" ]; then
-    # set passphrase cache so I only have to type my passphrase once a day
-    eval $(gpg-agent --default-cache-ttl 604800 --daemon --write-env-file $HOME/.gpg-agent-info)
+
+if [ ! -f $HOME/.gpg-agent.conf ]; then
+  cat <<EOM >$HOME/.gpg-agent.conf
+default-cache-ttl 604800
+max-cache-ttl 604800
+default-cache-ttl-ssh 604800
+max-cache-ttl-ssh 604800
+EOM
+fi
+
+if [ -n "${GPG_AGENT_INFO}" ]; then
+    nc  -U "${GPG_AGENT_INFO%%:*}" >/dev/null </dev/null
+    if [ ! -S "${GPG_AGENT_INFO%%:*}" -o $? != 0 ]; then
+        # set passphrase cache so I only have to type my passphrase once a day
+        eval $(gpg-agent --options $HOME/.gpg-agent.conf --daemon --write-env-file $HOME/.gpg-agent-info --use-standard-socket --log-file $HOME/tmp/gpg-agent.log --verbose)
+    fi
 fi
 export GPG_TTY=$(tty)
 ```
 
-
-## Usage
-
+#### `gopass` password source
+There is also the possibility to use [gopass](https://www.gopass.pw/) as a password source. `gopass` (like `pass`) uses gpg to encrypt/decrypt passwords. To use `gopass` for password storagte and retrieval via `go-jira` just add this configuration to `$HOME/.jira.d/config.yml`:
+```yaml
+password-source: gopass
+password-name: jira.example.com/myuser
 ```
-Usage:
-  jira (ls|list) <Query Options> 
-  jira view ISSUE
-  jira edit [--noedit] <Edit Options> [ISSUE | <Query Options>]
-  jira create [--noedit] [-p PROJECT] <Create Options>
-  jira DUPLICATE dups ISSUE
-  jira BLOCKER blocks ISSUE
-  jira watch ISSUE [-w WATCHER]
-  jira (trans|transition) TRANSITION ISSUE [--noedit] <Edit Options>
-  jira ack ISSUE [--edit] <Edit Options>
-  jira close ISSUE [--edit] <Edit Options>
-  jira resolve ISSUE [--edit] <Edit Options>
-  jira reopen ISSUE [--edit] <Edit Options>
-  jira start ISSUE [--edit] <Edit Options>
-  jira stop ISSUE [--edit] <Edit Options>
-  jira comment ISSUE [--noedit] <Edit Options>
-  jira take ISSUE
-  jira (assign|give) ISSUE ASSIGNEE
-  jira fields
-  jira issuelinktypes
-  jira transmeta ISSUE
-  jira editmeta ISSUE
-  jira issuetypes [-p PROJECT] 
-  jira createmeta [-p PROJECT] [-i ISSUETYPE] 
-  jira transitions ISSUE
-  jira export-templates [-d DIR] [-t template]
-  jira (b|browse) ISSUE
-  jira login
-  jira ISSUE
 
-General Options:
-  -b --browse         Open your browser to the Jira issue
-  -e --endpoint=URI   URI to use for jira
-  -h --help           Show this usage
-  -t --template=FILE  Template file to use for output/editing
-  -u --user=USER      Username to use for authentication (default: $USER)
-  -v --verbose        Increase output logging
+For this to work, you need a working `gopass` installation. 
 
-Query Options:
-  -a --assignee=USER        Username assigned the issue
-  -c --component=COMPONENT  Component to Search for
-  -f --queryfields=FIELDS   Fields that are used in "list" template: (default: summary,created,updated,priority,status,reporter,assignee)
-  -i --issuetype=ISSUETYPE  The Issue Type
-  -l --limit=VAL            Maximum number of results to return in query (default: 500)
-  -p --project=PROJECT      Project to Search for
-  -q --query=JQL            Jira Query Language expression for the search
-  -r --reporter=USER        Reporter to search for
-  -s --sort=ORDER           For list operations, sort issues (default: priority asc, created)
-  -w --watcher=USER         Watcher to add to issue (default: $USER)
-                            or Watcher to search for
+To configure your `gpg-agent` to cache your gpg passphrase take a look at the `pass` section of the readme. 
 
-Edit Options:
-  -m --comment=COMMENT      Comment message for transition
-  -o --override=KEY=VAL     Set custom key/value pairs
+#### `stdin` password source
 
-Create Options:
-  -i --issuetype=ISSUETYPE  Jira Issue Type (default: Bug)
-  -m --comment=COMMENT      Comment message for transition
-  -o --override=KEY=VAL     Set custom key/value pairs
+When `password-source` is set to `stdin`, the `jira login` command will read from stdin until EOF, and the bytes read will be the used as the password. This is useful if you have some other programmatic method for fetching passwords. For example, if `password-generator` creates a one-time password and prints it to stdout, you could use it like this.
 
-Command Options:
-  -d --directory=DIR        Directory to export templates to (default: $HOME/.jira.d/templates)
+```bash
+$ ./password-generator | jira login --endpoint=https://my.jira.endpoint.com --user=USERNAME
 ```
+
+#### Switch path  used for password source
+For `gopass` and `pass` it is possible to specify the full path for the `password-source` tool  used for retrieval of the password. This can be accomplised
+by setting the `password-source-path` option in the configuration file. 
+
+E.g.
+```yaml
+password-source: gopass
+password-name: jira.example.com/myuser
+password-source-path: /path/to/my-special-gopass
+```
+
+This will cause go-jira to use the `gopass` style cli interaction with the `my-special-gopass` binary.
+
+If you ommit the `password-source-path` option, either `gopass` (for `gopass`) or `pass` (for `pass`) 
+will be used.

_t/.jira.d/config.yml

@@ -0,0 +1,49 @@
+config:
+  stop: true
+password-source: pass
+endpoint: https://go-jira.atlassian.net
+user: gojira
+login: gojira@corybennett.org
+
+project: BASIC
+
+queries:
+  todo: >-
+    resolution = unresolved {{if .project}}AND project = '{{.project}}'{{end}} AND status = 'To Do'
+
+custom-commands:
+  - name: env
+    help: print the JIRA environment variables available to custom commands
+    script: |-
+      env | sort | grep JIRA
+  - name: print-project
+    help: print the name of the configured project
+    script: "echo $JIRA_PROJECT"
+  - name: jira-path
+    help: print the path the jira command that is running this alias
+    script: |-
+      echo {{jira}}
+  - name: mine
+    help: display issues assigned to me
+    script: |-
+      if [ -n "$JIRA_PROJECT" ]; then
+          # if `project: ...` configured just list the issues for current project
+          {{jira}} list --template table --query "resolution = unresolved and assignee=currentuser() and project = $JIRA_PROJECT ORDER BY priority asc, created"
+      else
+          # otherwise list issues for all project
+          {{jira}} list --template table --query "resolution = unresolved and assignee=currentuser() ORDER BY priority asc, created"
+      fi
+  - name: argtest
+    help: testing passing args
+    script: |-
+      echo {{args.ARG}}
+    args:
+      - name: ARG
+        help: string to echo for testing
+  - name: opttest
+    help: testing passing option flags
+    script: |-
+      echo {{options.OPT}}
+    options:
+      - name: OPT
+        help: string to echo for testing

_t/.jira.d/list.yml

@@ -0,0 +1 @@
+template: list

_t/000setup.t

@@ -3,6 +3,8 @@ eval "$(curl -q -s https://raw.githubusercontent.com/coryb/osht/master/osht.sh)"
 cd $(dirname $0)
 jira="../jira --user admin"
 
+. env.sh
+
 SKIP test -n "$JIRACLOUD" # using Jira Cloud at go-jira.atlassian.net
 PLAN 15
 

_t/010login.t

@@ -2,6 +2,7 @@
 eval "$(curl -q -s https://raw.githubusercontent.com/coryb/osht/master/osht.sh)"
 cd $(dirname $0)
 jira=../jira
+. env.sh
 
 SKIP test -n "$JIRACLOUD" # using Jira Cloud at go-jira.atlassian.net
 

_t/100basic.t

@@ -1,27 +1,22 @@
 #!/bin/bash
 eval "$(curl -q -s https://raw.githubusercontent.com/coryb/osht/master/osht.sh)"
 cd $(dirname $0)
-jira="../jira --project BASIC"
-export JIRA_LOG_FORMAT="%{level:-5s} %{message}"
+jira="../jira"
+. env.sh
 
-ENDPOINT="http://localhost:8080"
-if [ -n "$JIRACLOUD" ]; then
-    ENDPOINT="https://go-jira.atlassian.net"
-fi
-
-PLAN 86
+PLAN 98
 
 # reset login
 RUNS $jira logout
 RUNS $jira login
 
 # cleanup from previous failed test executions
-($jira ls | awk -F: '{print $1}' | while read issue; do ../jira done $issue; done) | sed 's/^/# CLEANUP: /g'
+($jira ls --project BASIC | awk -F: '{print $1}' | while read issue; do ../jira done $issue; done) | sed 's/^/# CLEANUP: /g'
 
 ###############################################################################
 ## Create an issue
 ###############################################################################
-RUNS $jira create -o summary=summary -o description=description --noedit --saveFile issue.props
+RUNS $jira create --project BASIC -o summary=summary -o description=description --noedit --saveFile issue.props
 issue=$(awk '/issue/{print $2}' issue.props)
 
 DIFF <<EOF
@@ -40,8 +35,8 @@ status: To Do
 summary: summary
 project: BASIC
 issuetype: Bug
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 priority: Medium
 votes: 0
 description: |
@@ -52,7 +47,15 @@ EOF
 ## List all issues, should be just the one we created
 ###############################################################################
 
-RUNS $jira ls
+RUNS $jira ls --project BASIC
+DIFF <<EOF
+$(printf %-12s $issue:) summary
+EOF
+
+###############################################################################
+## List issues using a named query
+###############################################################################
+RUNS $jira ls --project BASIC -n todo
 DIFF <<EOF
 $(printf %-12s $issue:) summary
 EOF
@@ -61,13 +64,52 @@ EOF
 ## List all issues, using the table template
 ###############################################################################
 
-RUNS $jira ls --template table
+RUNS $jira ls --project BASIC --template table
 DIFF <<EOF
-+----------------+---------------------------------------------------------+--------------+--------------+------------+--------------+--------------+
-| Issue          | Summary                                                 | Priority     | Status       | Age        | Reporter     | Assignee     |
-+----------------+---------------------------------------------------------+--------------+--------------+------------+--------------+--------------+
-| $(printf %-14s $issue) | summary                                                 | Medium       | To Do        | a minute   | gojira       | gojira       |
-+----------------+---------------------------------------------------------+--------------+--------------+------------+--------------+--------------+
++------------+---------+------+----------+--------+----------+----------+----------+
+|   Issue    | Summary | Type | Priority | Status |   Age    | Reporter | Assignee |
++------------+---------+------+----------+--------+----------+----------+----------+
+| $issue | summary | Bug  | Medium   | To Do  | a minute | GoJira   | GoJira   |
++------------+---------+------+----------+--------+----------+----------+----------+
+EOF
+
+###############################################################################
+## Edit an issue
+###############################################################################
+RUNS $jira edit $issue -m "edit comment" --override priority=High --noedit
+DIFF <<EOF
+OK $issue $ENDPOINT/browse/$issue
+EOF
+
+###############################################################################
+## Edit multiple issues with query
+###############################################################################
+RUNS $jira edit -m "bulk edit comment" --override priority=High --noedit --query "resolution = unresolved AND project = 'BASIC' AND status = 'To Do'"
+DIFF <<EOF
+OK $issue $ENDPOINT/browse/$issue
+EOF
+
+RUNS $jira $issue
+DIFF <<EOF
+issue: $issue
+created: a minute ago
+status: To Do
+summary: summary
+project: BASIC
+issuetype: Bug
+assignee: GoJira
+reporter: GoJira
+priority: High
+votes: 0
+description: |
+  description
+
+comments:
+  - | # GoJira, a minute ago
+    edit comment
+  - | # GoJira, a minute ago
+    bulk edit comment
+
 EOF
 
 ###############################################################################
@@ -76,7 +118,7 @@ EOF
 
 NRUNS $jira close $issue
 EDIFF <<EOF
-ERROR Invalid Transition 'close', Available: To Do, In Progress, In Review, Done
+ERROR Invalid Transition "close" from "To Do", Available: To Do, In Progress, In Review, Done
 EOF
 
 ###############################################################################
@@ -92,7 +134,7 @@ EOF
 ## Verify there are no unresolved issues
 ###############################################################################
 
-RUNS $jira ls
+RUNS $jira ls --project BASIC
 DIFF <<EOF
 EOF
 
@@ -100,13 +142,13 @@ EOF
 ## Setup 2 more issues so we can test duping
 ###############################################################################
 
-RUNS $jira create -o summary=summary -o description=description --noedit --saveFile issue.props
+RUNS $jira create --project BASIC -o summary=summary -o description=description --noedit --saveFile issue.props
 issue=$(awk '/issue/{print $2}' issue.props)
 DIFF <<EOF
 OK $issue $ENDPOINT/browse/$issue
 EOF
 
-RUNS $jira create -o summary=dup -o description=dup --noedit --saveFile issue.props
+RUNS $jira create --project BASIC -o summary=dup -o description=dup --noedit --saveFile issue.props
 dup=$(awk '/issue/{print $2}' issue.props)
 DIFF <<EOF
 OK $dup $ENDPOINT/browse/$dup
@@ -118,7 +160,7 @@ EOF
 ## that issue should be resolved
 ###############################################################################
 
-RUNS $jira $dup dups $issue --noedit
+RUNS $jira dup $dup $issue
 DIFF <<EOF
 OK $issue $ENDPOINT/browse/$issue
 OK $dup $ENDPOINT/browse/$dup
@@ -132,8 +174,8 @@ status: To Do
 summary: summary
 project: BASIC
 issuetype: Bug
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: 
 depends: $dup[Done]
 priority: Medium
@@ -146,7 +188,7 @@ EOF
 ## We should see only one unresolved issue, the Dup should be resolved
 ###############################################################################
 
-RUNS $jira ls
+RUNS $jira ls --project BASIC
 DIFF <<EOF
 $(printf %-12s $issue:) summary
 EOF
@@ -155,7 +197,7 @@ EOF
 ## Setup for testing blocking issues
 ###############################################################################
 
-RUNS $jira create -o summary=blocks -o description=blocks --noedit --saveFile issue.props
+RUNS $jira create --project BASIC -o summary=blocks -o description=blocks --noedit --saveFile issue.props
 blocker=$(awk '/issue/{print $2}' issue.props)
 DIFF <<EOF
 OK $blocker $ENDPOINT/browse/$blocker
@@ -165,9 +207,10 @@ EOF
 ## Set blocker and verify it shows up when viewing the main issue
 ###############################################################################
 
-RUNS $jira $blocker blocks $issue
+RUNS $jira block $blocker $issue
 DIFF <<EOF
 OK $issue $ENDPOINT/browse/$issue
+OK $blocker $ENDPOINT/browse/$blocker
 EOF
 
 RUNS $jira $issue
@@ -178,8 +221,8 @@ status: To Do
 summary: summary
 project: BASIC
 issuetype: Bug
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: $blocker[To Do]
 depends: $dup[Done]
 priority: Medium
@@ -192,7 +235,7 @@ EOF
 ## Both issues are unresolved now
 ###############################################################################
 
-RUNS $jira ls
+RUNS $jira ls --project BASIC
 DIFF <<EOF
 $(printf %-12s $issue:) summary
 $(printf %-12s $blocker:) blocks
@@ -202,7 +245,7 @@ EOF
 # reset login for mothra for voting
 ###############################################################################
 
-jira="$jira --user mothra"
+jira="$jira --user mothra --login mothra@corybennett.org"
 
 RUNS $jira logout
 RUNS $jira login
@@ -224,8 +267,8 @@ status: To Do
 summary: summary
 project: BASIC
 issuetype: Bug
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: $blocker[To Do]
 depends: $dup[Done]
 priority: Medium
@@ -251,8 +294,8 @@ status: To Do
 summary: summary
 project: BASIC
 issuetype: Bug
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: $blocker[To Do]
 depends: $dup[Done]
 priority: Medium
@@ -271,10 +314,10 @@ OK $issue $ENDPOINT/browse/$issue
 EOF
 
 # FIXME we probably need a watchers command to wrap this?
-RUNS sh -c "$jira req /rest/api/2/issue/$issue/watchers | jq -r .watchers[].name | sort"
+RUNS sh -c "$jira req /rest/api/2/issue/$issue/watchers | jq -r .watchers[].displayName | sort"
 DIFF <<EOF
-gojira
-mothra
+GoJira
+Mothra
 EOF
 
 ###############################################################################
@@ -343,8 +386,8 @@ status: To Do
 summary: summary
 project: BASIC
 issuetype: Bug
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: $blocker[Done]
 depends: $dup[Done]
 priority: Medium
@@ -370,8 +413,8 @@ status: To Do
 summary: summary
 project: BASIC
 issuetype: Bug
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: $blocker[Done]
 depends: $dup[Done]
 priority: Medium
@@ -380,7 +423,7 @@ description: |
   description
 
 comments:
-  - | # mothra, a minute ago
+  - | # Mothra, a minute ago
     Yo, Comment
 
 EOF
@@ -389,7 +432,7 @@ EOF
 ## Verify we can add labels to an issue
 ###############################################################################
 
-RUNS $jira add labels $blocker test-label another-label
+RUNS $jira labels add $blocker test-label another-label
 DIFF <<EOF
 OK $blocker $ENDPOINT/browse/$blocker
 EOF
@@ -402,8 +445,8 @@ status: Done
 summary: blocks
 project: BASIC
 issuetype: Bug
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: 
 depends: $issue[To Do]
 priority: Medium
@@ -417,7 +460,7 @@ EOF
 ## Verify we can remove a label
 ###############################################################################
 
-RUNS $jira remove labels $blocker another-label
+RUNS $jira labels remove $blocker another-label
 DIFF <<EOF
 OK $blocker $ENDPOINT/browse/$blocker
 EOF
@@ -430,8 +473,8 @@ status: Done
 summary: blocks
 project: BASIC
 issuetype: Bug
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: 
 depends: $issue[To Do]
 priority: Medium
@@ -445,7 +488,7 @@ EOF
 ## Verify we can replace the labels with a new set
 ###############################################################################
 
-RUNS $jira set labels $blocker more-label better-label
+RUNS $jira labels set $blocker more-label better-label
 DIFF <<EOF
 OK $blocker $ENDPOINT/browse/$blocker
 EOF
@@ -458,8 +501,8 @@ status: Done
 summary: blocks
 project: BASIC
 issuetype: Bug
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: 
 depends: $issue[To Do]
 priority: Medium
@@ -486,8 +529,8 @@ status: Done
 summary: blocks
 project: BASIC
 issuetype: Bug
-assignee: mothra
-reporter: gojira
+assignee: Mothra
+reporter: GoJira
 blockers: 
 depends: $issue[To Do]
 priority: Medium
@@ -514,8 +557,8 @@ status: Done
 summary: blocks
 project: BASIC
 issuetype: Bug
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: 
 depends: $issue[To Do]
 priority: Medium
@@ -524,3 +567,15 @@ labels: better-label, more-label
 description: |
   blocks
 EOF
+ 
+###############################################################################
+## List 102 closed issues, should be more than 100 (max page size), verify pagination
+###############################################################################
+RUNS $jira ls -q "project = 'BASIC' AND status = 'Done'" --limit 102
+IS $(wc -l <$OSHT_STDOUT) -eq 102
+
+###############################################################################
+## List 1 issue, verify we dont get full page
+###############################################################################
+RUNS $jira ls -q "project = 'BASIC' AND status = 'Done'" --limit 1
+IS $(wc -l <$OSHT_STDOUT) -eq 1

_t/101default.t

@@ -0,0 +1,48 @@
+#!/bin/bash
+eval "$(curl -q -s https://raw.githubusercontent.com/coryb/osht/master/osht.sh)"
+cd $(dirname $0)
+jira="../jira"
+. env.sh
+
+PLAN 6
+
+# reset login
+RUNS $jira logout
+RUNS $jira login
+
+# cleanup from previous failed test executions
+($jira ls --project BASIC | awk -F: '{print $1}' | while read issue; do ../jira done $issue; done) | sed 's/^/# CLEANUP: /g'
+
+###############################################################################
+## Create an issue
+###############################################################################
+RUNS $jira create --project BASIC -o summary=summary -o description=description --noedit --saveFile issue.props
+issue=$(awk '/issue/{print $2}' issue.props)
+
+DIFF <<EOF
+OK $issue $ENDPOINT/browse/$issue
+EOF
+
+# just get the number
+shortIssue=${issue#BASIC-}
+
+###############################################################################
+## View the issue we just created
+###############################################################################
+
+RUNS $jira view $shortIssue
+DIFF <<EOF
+issue: $issue
+created: a minute ago
+status: To Do
+summary: summary
+project: BASIC
+issuetype: Bug
+assignee: GoJira
+reporter: GoJira
+priority: Medium
+votes: 0
+description: |
+  description
+EOF
+

_t/110basic-worklog.t

@@ -1,13 +1,8 @@
 #!/bin/bash
 eval "$(curl -q -s https://raw.githubusercontent.com/coryb/osht/master/osht.sh)"
 cd $(dirname $0)
-jira="../jira --project BASIC"
-export JIRA_LOG_FORMAT="%{level:-5s} %{message}"
-
-ENDPOINT="http://localhost:8080"
-if [ -n "$JIRACLOUD" ]; then
-    ENDPOINT="https://go-jira.atlassian.net"
-fi
+jira="../jira"
+. env.sh
 
 PLAN 8
 
@@ -16,12 +11,12 @@ RUNS $jira logout
 RUNS $jira login
 
 # cleanup from previous failed test executions
-($jira ls | awk -F: '{print $1}' | while read issue; do ../jira done $issue; done) | sed 's/^/# CLEANUP: /g'
+($jira ls --project BASIC | awk -F: '{print $1}' | while read issue; do ../jira done $issue; done) | sed 's/^/# CLEANUP: /g'
 
 ###############################################################################
 ## Create an issue
 ###############################################################################
-RUNS $jira create -o summary=summary -o description=description --noedit --saveFile issue.props
+RUNS $jira create --project BASIC -o summary=summary -o description=description --noedit --saveFile issue.props
 issue=$(awk '/issue/{print $2}' issue.props)
 
 DIFF <<EOF
@@ -31,7 +26,7 @@ EOF
 ###############################################################################
 ## Add a worklog to an issue
 ###############################################################################
-RUNS $jira add worklog $issue --comment "work is hard" --time-spent "1h 12m" --noedit
+RUNS $jira worklog add $issue --comment "work is hard" --time-spent "1h 12m" -S "2017-01-29T09:17:00.000-0500" --noedit
 DIFF <<EOF
 OK $issue $ENDPOINT/browse/$issue
 EOF
@@ -41,8 +36,9 @@ EOF
 ###############################################################################
 RUNS $jira worklog $issue
 DIFF <<EOF
-- # gojira, a minute ago
+- # GoJira, a minute ago
   comment: work is hard
+  started: 2017-01-29T06:17:00.000-0800
   timeSpent: 1h 12m
 
 EOF

_t/120custom-commands.t

@@ -0,0 +1,80 @@
+#!/bin/bash
+eval "$(curl -q -s https://raw.githubusercontent.com/coryb/osht/master/osht.sh)"
+cd $(dirname $0)
+jira="../jira"
+. env.sh
+
+PLAN 16
+
+# reset login
+RUNS $jira logout
+RUNS $jira login
+
+# cleanup from previous failed test executions
+($jira ls --project BASIC | awk -F: '{print $1}' | while read issue; do ../jira done $issue; done) | sed 's/^/# CLEANUP: /g'
+
+###############################################################################
+## Create an issue
+###############################################################################
+RUNS $jira create --project BASIC -o summary=summary -o description=description --noedit --saveFile issue.props
+issue=$(awk '/issue/{print $2}' issue.props)
+
+DIFF <<EOF
+OK $issue $ENDPOINT/browse/$issue
+EOF
+
+###############################################################################
+## Testing the example custom commands, print-project
+###############################################################################
+
+RUNS $jira print-project
+DIFF <<EOF
+BASIC
+EOF
+
+###############################################################################
+## Testing the example custom commands, jira-path
+###############################################################################
+
+RUNS $jira jira-path
+DIFF <<EOF
+../jira
+EOF
+
+###############################################################################
+## Testing the example custom commands, env
+###############################################################################
+
+RUNS $jira env
+GREP ^JIRA_PROJECT=BASIC
+
+###############################################################################
+## Testing the example custom commands, argtest
+###############################################################################
+
+RUNS $jira argtest TEST
+DIFF <<EOF
+TEST
+EOF
+
+###############################################################################
+## Testing the example custom commands, opttest
+###############################################################################
+
+RUNS $jira opttest --OPT TEST
+DIFF <<EOF
+TEST
+EOF
+
+###############################################################################
+## Use the "mine" alias to list issues assigned to self
+###############################################################################
+
+RUNS $jira mine
+DIFF <<EOF
++------------+---------+------+----------+--------+----------+----------+----------+
+|   Issue    | Summary | Type | Priority | Status |   Age    | Reporter | Assignee |
++------------+---------+------+----------+--------+----------+----------+----------+
+| $issue | summary | Bug  | Medium   | To Do  | a minute | GoJira   | GoJira   |
++------------+---------+------+----------+--------+----------+----------+----------+
+EOF

_t/130basic-epics.t

@@ -0,0 +1,121 @@
+#!/bin/bash
+eval "$(curl -q -s https://raw.githubusercontent.com/coryb/osht/master/osht.sh)"
+cd $(dirname $0)
+jira="../jira"
+. env.sh
+
+PLAN 22
+
+# reset login
+RUNS $jira logout
+RUNS $jira login
+
+# cleanup from previous failed test executions
+($jira ls --project BASIC | awk -F: '{print $1}' | while read issue; do ../jira done $issue; done) | sed 's/^/# CLEANUP: /g'
+
+###############################################################################
+## Create an epic
+###############################################################################
+RUNS $jira epic create --project BASIC -o summary="Totally Epic" -o description=description --epic-name "Basic Epic" --noedit --saveFile issue.props
+epic=$(awk '/issue/{print $2}' issue.props)
+
+DIFF <<EOF
+OK $epic $ENDPOINT/browse/$epic
+EOF
+
+###############################################################################
+## Create issues we can assign to epic
+###############################################################################
+RUNS $jira create --project BASIC -o summary="summary" -o description=description --noedit --saveFile issue.props
+issue1=$(awk '/issue/{print $2}' issue.props)
+
+DIFF <<EOF
+OK $issue1 $ENDPOINT/browse/$issue1
+EOF
+
+RUNS $jira create --project BASIC -o summary="summary" -o description=description --noedit --saveFile issue.props
+issue2=$(awk '/issue/{print $2}' issue.props)
+
+DIFF <<EOF
+OK $issue2 $ENDPOINT/browse/$issue2
+EOF
+
+###############################################################################
+## List the issues for the epic
+###############################################################################
+RUNS $jira epic list $epic
+
+DIFF<<EOF
++-------+---------+------+----------+--------+-----+----------+----------+
+| Issue | Summary | Type | Priority | Status | Age | Reporter | Assignee |
++-------+---------+------+----------+--------+-----+----------+----------+
++-------+---------+------+----------+--------+-----+----------+----------+
+EOF
+
+###############################################################################
+## Add issues to an epic
+###############################################################################
+RUNS $jira epic add $epic $issue1 $issue2
+
+DIFF<<EOF
+OK $epic $ENDPOINT/browse/$epic
+OK $issue1 $ENDPOINT/browse/$issue1
+OK $issue2 $ENDPOINT/browse/$issue2
+EOF
+
+###############################################################################
+## List the issues for the epic
+###############################################################################
+RUNS $jira epic list $epic
+
+DIFF<<EOF
++------------+---------+------+----------+--------+----------+----------+----------+
+|   Issue    | Summary | Type | Priority | Status |   Age    | Reporter | Assignee |
++------------+---------+------+----------+--------+----------+----------+----------+
+| $issue1 | summary | Bug  | Medium   | To Do  | a minute | GoJira   | GoJira   |
+| $issue2 | summary | Bug  | Medium   | To Do  | a minute | GoJira   | GoJira   |
++------------+---------+------+----------+--------+----------+----------+----------+
+EOF
+
+###############################################################################
+## Remove an issue from an Epic
+###############################################################################
+RUNS $jira epic remove $issue1
+
+DIFF<<EOF
+OK $issue1 $ENDPOINT/browse/$issue1
+EOF
+
+###############################################################################
+## List the issues for the epic
+###############################################################################
+RUNS $jira epic list $epic
+
+DIFF<<EOF
++------------+---------+------+----------+--------+----------+----------+----------+
+|   Issue    | Summary | Type | Priority | Status |   Age    | Reporter | Assignee |
++------------+---------+------+----------+--------+----------+----------+----------+
+| $issue2 | summary | Bug  | Medium   | To Do  | a minute | GoJira   | GoJira   |
++------------+---------+------+----------+--------+----------+----------+----------+
+EOF
+
+###############################################################################
+## Remove last issue from an Epic
+###############################################################################
+RUNS $jira epic remove $issue2
+
+DIFF<<EOF
+OK $issue2 $ENDPOINT/browse/$issue2
+EOF
+
+###############################################################################
+## List the issues for the epic
+###############################################################################
+RUNS $jira epic list $epic
+
+DIFF<<EOF
++-------+---------+------+----------+--------+-----+----------+----------+
+| Issue | Summary | Type | Priority | Status | Age | Reporter | Assignee |
++-------+---------+------+----------+--------+-----+----------+----------+
++-------+---------+------+----------+--------+-----+----------+----------+
+EOF

_t/140basic-attach.t

@@ -0,0 +1,189 @@
+#!/bin/bash
+eval "$(curl -q -s https://raw.githubusercontent.com/coryb/osht/master/osht.sh)"
+cd $(dirname $0)
+jira="../jira"
+. env.sh
+
+PLAN 43
+
+# reset login
+RUNS $jira logout
+RUNS $jira login
+
+# cleanup from previous failed test executions
+($jira ls --project BASIC | awk -F: '{print $1}' | while read issue; do ../jira done $issue; done) | sed 's/^/# CLEANUP: /g'
+
+###############################################################################
+## Create an issue
+###############################################################################
+RUNS $jira create --project BASIC -o summary="Attach To Me" -o description=description --noedit --saveFile issue.props
+issue=$(awk '/issue/{print $2}' issue.props)
+
+DIFF <<EOF
+OK $issue $ENDPOINT/browse/$issue
+EOF
+
+###############################################################################
+## Attach via stdin
+###############################################################################
+RUNS $jira attach create $issue --filename README.md --saveFile attach.props < ./README.md
+attach1=$(awk '/^id:/{print $2}' attach.props)
+
+DIFF <<EOF
+OK $attach1 $ENDPOINT/secure/attachment/$attach1/README.md
+EOF
+
+###############################################################################
+## Attach binary file
+###############################################################################
+RUNS dd of=garbage.bin if=/dev/urandom count=1k bs=1k
+RUNS $jira attach create $issue garbage.bin --saveFile attach.props
+attach2=$(awk '/^id:/{print $2}' attach.props)
+
+DIFF <<EOF
+OK $attach2 $ENDPOINT/secure/attachment/$attach2/garbage.bin
+EOF
+
+###############################################################################
+## Attach binary file with different name
+###############################################################################
+RUNS $jira attach create $issue garbage.bin --filename foobar.bin --saveFile attach.props
+attach3=$(awk '/^id:/{print $2}' attach.props)
+
+DIFF <<EOF
+OK $attach3 $ENDPOINT/secure/attachment/$attach3/foobar.bin
+EOF
+
+###############################################################################
+## List attachments
+###############################################################################
+RUNS $jira attach list $issue
+DIFF <<EOF
++-------+-------------+---------+--------+----------+
+|  id   |  filename   |  bytes  |  user  | created  |
++-------+-------------+---------+--------+----------+
+| $attach1 | README.md   |    1239 | GoJira | a minute |
+| $attach2 | garbage.bin | 1048576 | GoJira | a minute |
+| $attach3 | foobar.bin  | 1048576 | GoJira | a minute |
++-------+-------------+---------+--------+----------+
+EOF
+
+###############################################################################
+## Fetch text attachment
+###############################################################################
+RUNS $jira attach get $attach1 -o attach1.txt
+DIFF <<EOF
+OK Wrote attach1.txt
+EOF
+
+# verify no diffs
+RUNS diff -q README.md attach1.txt
+
+###############################################################################
+## Fetch text attachment to stdout
+###############################################################################
+RUNS sh -c "$jira attach get $attach1 -o- > attach1.txt"
+
+# verify no diffs
+RUNS diff -q README.md attach1.txt
+
+###############################################################################
+## Fetch text attachment as same name
+###############################################################################
+RUNS $jira attach get $attach1
+DIFF <<EOF
+OK Wrote README.md
+EOF
+
+# verify no diffs
+RUNS git diff README.md
+
+###############################################################################
+## Fetch binary attachment
+###############################################################################
+RUNS $jira attach get $attach2 --output binary.out
+DIFF <<EOF
+OK Wrote binary.out
+EOF
+
+# verify no diffs
+RUNS diff -q garbage.bin binary.out
+
+###############################################################################
+## Fetch binary attachment to stdout
+###############################################################################
+RUNS sh -c "$jira attach get $attach2 -o- > binary.out"
+
+# verify no diffs
+RUNS diff -q garbage.bin binary.out
+
+###############################################################################
+## Fetch binary attachment
+###############################################################################
+RUNS $jira attach get $attach3
+DIFF <<EOF
+OK Wrote foobar.bin
+EOF
+
+# verify no diffs
+RUNS diff -q garbage.bin foobar.bin
+
+###############################################################################
+## Fetch binary attachment to stdout
+###############################################################################
+RUNS sh -c "$jira attach get $attach3 --output=- > binary.out"
+
+# verify no diffs
+RUNS diff -q garbage.bin binary.out
+
+###############################################################################
+## Delete attachment
+###############################################################################
+RUNS $jira attach remove $attach1
+DIFF <<EOF
+OK Deleted Attachment $attach1
+EOF
+
+RUNS $jira attach list $issue
+DIFF <<EOF
++-------+-------------+---------+--------+----------+
+|  id   |  filename   |  bytes  |  user  | created  |
++-------+-------------+---------+--------+----------+
+| $attach2 | garbage.bin | 1048576 | GoJira | a minute |
+| $attach3 | foobar.bin  | 1048576 | GoJira | a minute |
++-------+-------------+---------+--------+----------+
+EOF
+
+
+###############################################################################
+## Delete attachment
+###############################################################################
+RUNS $jira attach rm $attach2
+DIFF <<EOF
+OK Deleted Attachment $attach2
+EOF
+
+RUNS $jira attach list $issue
+DIFF <<EOF
++-------+------------+---------+--------+----------+
+|  id   |  filename  |  bytes  |  user  | created  |
++-------+------------+---------+--------+----------+
+| $attach3 | foobar.bin | 1048576 | GoJira | a minute |
++-------+------------+---------+--------+----------+
+EOF
+
+###############################################################################
+## Delete last
+###############################################################################
+RUNS $jira attach rm $attach3
+DIFF <<EOF
+OK Deleted Attachment $attach3
+EOF
+
+RUNS $jira attach list $issue
+DIFF <<EOF
++----+----------+-------+------+---------+
+| id | filename | bytes | user | created |
++----+----------+-------+------+---------+
++----+----------+-------+------+---------+
+EOF

_t/200scrum.t

@@ -1,18 +1,13 @@
 #!/bin/bash
 eval "$(curl -q -s https://raw.githubusercontent.com/coryb/osht/master/osht.sh)"
 cd $(dirname $0)
-jira="../jira --project SCRUM"
-export JIRA_LOG_FORMAT="%{level:-5s} %{message}"
-
-ENDPOINT="http://localhost:8080"
-if [ -n "$JIRACLOUD" ]; then
-    ENDPOINT="https://go-jira.atlassian.net"
-fi
+jira="../jira"
+. env.sh
 
 PLAN 84
 
 # cleanup from previous failed test executions
-($jira ls | awk -F: '{print $1}' | while read issue; do ../jira done $issue; done) | sed 's/^/# CLEANUP: /g'
+($jira ls --project SCRUM | awk -F: '{print $1}' | while read issue; do ../jira done $issue; done) | sed 's/^/# CLEANUP: /g'
 
 # reset login
 RUNS $jira logout
@@ -21,7 +16,7 @@ echo "gojira123" | RUNS $jira login
 ###############################################################################
 ## Create an issue
 ###############################################################################
-RUNS $jira create -o summary=summary -o description=description --noedit --saveFile issue.props
+RUNS $jira create --project SCRUM -o summary=summary -o description=description --noedit --saveFile issue.props
 issue=$(awk '/issue/{print $2}' issue.props)
 
 DIFF <<EOF
@@ -40,8 +35,8 @@ status: To Do
 summary: summary
 project: SCRUM
 issuetype: Bug
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 priority: Medium
 votes: 0
 description: |
@@ -52,7 +47,7 @@ EOF
 ## List all issues, should be just the one we created
 ###############################################################################
 
-RUNS $jira ls
+RUNS $jira ls --project SCRUM
 DIFF <<EOF
 $(printf %-12s $issue:) summary
 EOF
@@ -63,7 +58,7 @@ EOF
 
 NRUNS $jira close $issue
 EDIFF <<EOF
-ERROR Invalid Transition 'close', Available: To Do, In Progress, Done
+ERROR Invalid Transition "close" from "To Do", Available: To Do, In Progress, Done
 EOF
 
 ###############################################################################
@@ -79,7 +74,7 @@ EOF
 ## Verify there are no unresolved issues
 ###############################################################################
 
-RUNS $jira ls
+RUNS $jira ls --project SCRUM
 DIFF <<EOF
 EOF
 
@@ -87,13 +82,13 @@ EOF
 ## Setup 2 more issues so we can test duping
 ###############################################################################
 
-RUNS $jira create -o summary=summary -o description=description --noedit --saveFile issue.props
+RUNS $jira create --project SCRUM -o summary=summary -o description=description --noedit --saveFile issue.props
 issue=$(awk '/issue/{print $2}' issue.props)
 DIFF <<EOF
 OK $issue $ENDPOINT/browse/$issue
 EOF
 
-RUNS $jira create -o summary=dup -o description=dup --noedit --saveFile issue.props
+RUNS $jira create --project SCRUM -o summary=dup -o description=dup --noedit --saveFile issue.props
 dup=$(awk '/issue/{print $2}' issue.props)
 DIFF <<EOF
 OK $dup $ENDPOINT/browse/$dup
@@ -105,7 +100,7 @@ EOF
 ## that issue should be resolved
 ###############################################################################
 
-RUNS $jira $dup dups $issue --noedit
+RUNS $jira dup $dup $issue
 DIFF <<EOF
 OK $issue $ENDPOINT/browse/$issue
 OK $dup $ENDPOINT/browse/$dup
@@ -119,8 +114,8 @@ status: To Do
 summary: summary
 project: SCRUM
 issuetype: Bug
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: 
 depends: $dup[Done]
 priority: Medium
@@ -133,7 +128,7 @@ EOF
 ## We should see only one unresolved issue, the Dup should be resolved
 ###############################################################################
 
-RUNS $jira ls
+RUNS $jira ls --project SCRUM
 DIFF <<EOF
 $(printf %-12s $issue:) summary
 EOF
@@ -142,7 +137,7 @@ EOF
 ## Setup for testing blocking issues
 ###############################################################################
 
-RUNS $jira create -o summary=blocks -o description=blocks --noedit --saveFile issue.props
+RUNS $jira create --project SCRUM -o summary=blocks -o description=blocks --noedit --saveFile issue.props
 blocker=$(awk '/issue/{print $2}' issue.props)
 DIFF <<EOF
 OK $blocker $ENDPOINT/browse/$blocker
@@ -152,9 +147,10 @@ EOF
 ## Set blocker and verify it shows up when viewing the main issue
 ###############################################################################
 
-RUNS $jira $blocker blocks $issue
+RUNS $jira block $blocker $issue
 DIFF <<EOF
 OK $issue $ENDPOINT/browse/$issue
+OK $blocker $ENDPOINT/browse/$blocker
 EOF
 
 RUNS $jira $issue
@@ -165,8 +161,8 @@ status: To Do
 summary: summary
 project: SCRUM
 issuetype: Bug
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: $blocker[To Do]
 depends: $dup[Done]
 priority: Medium
@@ -179,7 +175,7 @@ EOF
 ## Both issues are unresolved now
 ###############################################################################
 
-RUNS $jira ls
+RUNS $jira ls --project SCRUM
 DIFF <<EOF
 $(printf %-12s $issue:) summary
 $(printf %-12s $blocker:) blocks
@@ -189,7 +185,7 @@ EOF
 # reset login for mothra for voting
 ###############################################################################
 
-jira="$jira --user mothra"
+jira="$jira --user mothra --login mothra@corybennett.org"
 
 RUNS $jira logout
 echo "mothra123" | RUNS $jira login
@@ -211,8 +207,8 @@ status: To Do
 summary: summary
 project: SCRUM
 issuetype: Bug
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: $blocker[To Do]
 depends: $dup[Done]
 priority: Medium
@@ -238,8 +234,8 @@ status: To Do
 summary: summary
 project: SCRUM
 issuetype: Bug
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: $blocker[To Do]
 depends: $dup[Done]
 priority: Medium
@@ -258,10 +254,10 @@ OK $issue $ENDPOINT/browse/$issue
 EOF
 
 # FIXME we probably need a watchers command to wrap this?
-RUNS sh -c "$jira req /rest/api/2/issue/$issue/watchers | jq -r .watchers[].name | sort"
+RUNS sh -c "$jira req /rest/api/2/issue/$issue/watchers | jq -r .watchers[].displayName | sort"
 DIFF <<EOF
-gojira
-mothra
+GoJira
+Mothra
 EOF
 
 ###############################################################################
@@ -288,7 +284,7 @@ EOF
 
 NRUNS $jira trans "review" $blocker --noedit
 DIFF <<EOF
-ERROR Invalid Transition 'review', Available: To Do, In Progress, Done
+ERROR Invalid Transition "review" from "To Do", Available: To Do, In Progress, Done
 EOF
 
 ###############################################################################
@@ -330,8 +326,8 @@ status: To Do
 summary: summary
 project: SCRUM
 issuetype: Bug
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: $blocker[Done]
 depends: $dup[Done]
 priority: Medium
@@ -357,8 +353,8 @@ status: To Do
 summary: summary
 project: SCRUM
 issuetype: Bug
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: $blocker[Done]
 depends: $dup[Done]
 priority: Medium
@@ -367,7 +363,7 @@ description: |
   description
 
 comments:
-  - | # mothra, a minute ago
+  - | # Mothra, a minute ago
     Yo, Comment
 
 EOF
@@ -376,7 +372,7 @@ EOF
 ## Verify we can add labels to an issue
 ###############################################################################
 
-RUNS $jira add labels $blocker test-label another-label
+RUNS $jira labels add $blocker test-label another-label
 DIFF <<EOF
 OK $blocker $ENDPOINT/browse/$blocker
 EOF
@@ -389,8 +385,8 @@ status: Done
 summary: blocks
 project: SCRUM
 issuetype: Bug
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: 
 depends: $issue[To Do]
 priority: Medium
@@ -404,7 +400,7 @@ EOF
 ## Verify we can remove a label
 ###############################################################################
 
-RUNS $jira remove labels $blocker another-label
+RUNS $jira labels remove $blocker another-label
 DIFF <<EOF
 OK $blocker $ENDPOINT/browse/$blocker
 EOF
@@ -417,8 +413,8 @@ status: Done
 summary: blocks
 project: SCRUM
 issuetype: Bug
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: 
 depends: $issue[To Do]
 priority: Medium
@@ -432,7 +428,7 @@ EOF
 ## Verify we can replace the labels with a new set
 ###############################################################################
 
-RUNS $jira set labels $blocker more-label better-label
+RUNS $jira labels set $blocker more-label better-label
 DIFF <<EOF
 OK $blocker $ENDPOINT/browse/$blocker
 EOF
@@ -445,8 +441,8 @@ status: Done
 summary: blocks
 project: SCRUM
 issuetype: Bug
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: 
 depends: $issue[To Do]
 priority: Medium
@@ -473,8 +469,8 @@ status: Done
 summary: blocks
 project: SCRUM
 issuetype: Bug
-assignee: mothra
-reporter: gojira
+assignee: Mothra
+reporter: GoJira
 blockers: 
 depends: $issue[To Do]
 priority: Medium
@@ -501,8 +497,8 @@ status: Done
 summary: blocks
 project: SCRUM
 issuetype: Bug
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: 
 depends: $issue[To Do]
 priority: Medium

_t/300kanban.t

@@ -1,18 +1,13 @@
 #!/bin/bash
 eval "$(curl -q -s https://raw.githubusercontent.com/coryb/osht/master/osht.sh)"
 cd $(dirname $0)
-jira="../jira --project KANBAN"
-export JIRA_LOG_FORMAT="%{level:-5s} %{message}"
-
-ENDPOINT="http://localhost:8080"
-if [ -n "$JIRACLOUD" ]; then
-    ENDPOINT="https://go-jira.atlassian.net"
-fi
+jira="../jira"
+. env.sh
 
 PLAN 86
 
 # cleanup from previous failed test executions
-($jira ls | awk -F: '{print $1}' | while read issue; do ../jira done $issue; done) | sed 's/^/# CLEANUP: /g'
+($jira ls --project KANBAN | awk -F: '{print $1}' | while read issue; do ../jira done $issue; done) | sed 's/^/# CLEANUP: /g'
 
 # reset login
 RUNS $jira logout
@@ -21,7 +16,7 @@ echo "gojira123" | RUNS $jira login
 ###############################################################################
 ## Create an issue
 ###############################################################################
-RUNS $jira create -o summary=summary -o description=description --noedit --saveFile issue.props
+RUNS $jira create --project KANBAN -o summary=summary -o description=description --noedit --saveFile issue.props
 issue=$(awk '/issue/{print $2}' issue.props)
 
 DIFF <<EOF
@@ -40,8 +35,8 @@ status: Backlog
 summary: summary
 project: KANBAN
 issuetype: Bug
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 priority: Medium
 votes: 0
 description: |
@@ -52,7 +47,7 @@ EOF
 ## List all issues, should be just the one we created
 ###############################################################################
 
-RUNS $jira ls
+RUNS $jira ls --project KANBAN
 DIFF <<EOF
 $(printf %-12s $issue:) summary
 EOF
@@ -63,7 +58,7 @@ EOF
 
 NRUNS $jira close $issue
 EDIFF <<EOF
-ERROR Invalid Transition 'close', Available: Backlog, Selected for Development, In Progress, Done
+ERROR Invalid Transition "close" from "Backlog", Available: Backlog, Selected for Development, In Progress, Done
 EOF
 
 ###############################################################################
@@ -79,7 +74,7 @@ EOF
 ## Verify there are no unresolved issues
 ###############################################################################
 
-RUNS $jira ls
+RUNS $jira ls --project KANBAN
 DIFF <<EOF
 EOF
 
@@ -87,13 +82,13 @@ EOF
 ## Setup 2 more issues so we can test duping
 ###############################################################################
 
-RUNS $jira create -o summary=summary -o description=description --noedit --saveFile issue.props
+RUNS $jira create --project KANBAN -o summary=summary -o description=description --noedit --saveFile issue.props
 issue=$(awk '/issue/{print $2}' issue.props)
 DIFF <<EOF
 OK $issue $ENDPOINT/browse/$issue
 EOF
 
-RUNS $jira create -o summary=dup -o description=dup --noedit --saveFile issue.props
+RUNS $jira create --project KANBAN -o summary=dup -o description=dup --noedit --saveFile issue.props
 dup=$(awk '/issue/{print $2}' issue.props)
 DIFF <<EOF
 OK $dup $ENDPOINT/browse/$dup
@@ -105,7 +100,7 @@ EOF
 ## that issue should be resolved
 ###############################################################################
 
-RUNS $jira $dup dups $issue --noedit
+RUNS $jira dup $dup $issue
 DIFF <<EOF
 OK $issue $ENDPOINT/browse/$issue
 OK $dup $ENDPOINT/browse/$dup
@@ -119,8 +114,8 @@ status: Backlog
 summary: summary
 project: KANBAN
 issuetype: Bug
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: 
 depends: $dup[Done]
 priority: Medium
@@ -133,7 +128,7 @@ EOF
 ## We should see only one unresolved issue, the Dup should be resolved
 ###############################################################################
 
-RUNS $jira ls
+RUNS $jira ls --project KANBAN
 DIFF <<EOF
 $(printf %-12s $issue:) summary
 EOF
@@ -142,7 +137,7 @@ EOF
 ## Setup for testing blocking issues
 ###############################################################################
 
-RUNS $jira create -o summary=blocks -o description=blocks --noedit --saveFile issue.props
+RUNS $jira create --project KANBAN -o summary=blocks -o description=blocks --noedit --saveFile issue.props
 blocker=$(awk '/issue/{print $2}' issue.props)
 DIFF <<EOF
 OK $blocker $ENDPOINT/browse/$blocker
@@ -152,9 +147,10 @@ EOF
 ## Set blocker and verify it shows up when viewing the main issue
 ###############################################################################
 
-RUNS $jira $blocker blocks $issue
+RUNS $jira block $blocker $issue
 DIFF <<EOF
 OK $issue $ENDPOINT/browse/$issue
+OK $blocker $ENDPOINT/browse/$blocker
 EOF
 
 RUNS $jira $issue
@@ -165,8 +161,8 @@ status: Backlog
 summary: summary
 project: KANBAN
 issuetype: Bug
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: $blocker[Backlog]
 depends: $dup[Done]
 priority: Medium
@@ -179,7 +175,7 @@ EOF
 ## Both issues are unresolved now
 ###############################################################################
 
-RUNS $jira ls
+RUNS $jira ls --project KANBAN
 DIFF <<EOF
 $(printf %-12s $issue:) summary
 $(printf %-12s $blocker:) blocks
@@ -189,7 +185,7 @@ EOF
 # reset login for mothra for voting
 ###############################################################################
 
-jira="$jira --user mothra"
+jira="$jira --user mothra --login mothra@corybennett.org"
 
 RUNS $jira logout
 echo "mothra123" | RUNS $jira login
@@ -211,8 +207,8 @@ status: Backlog
 summary: summary
 project: KANBAN
 issuetype: Bug
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: $blocker[Backlog]
 depends: $dup[Done]
 priority: Medium
@@ -238,8 +234,8 @@ status: Backlog
 summary: summary
 project: KANBAN
 issuetype: Bug
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: $blocker[Backlog]
 depends: $dup[Done]
 priority: Medium
@@ -258,10 +254,10 @@ OK $issue $ENDPOINT/browse/$issue
 EOF
 
 # FIXME we probably need a watchers command to wrap this?
-RUNS sh -c "$jira req /rest/api/2/issue/$issue/watchers | jq -r .watchers[].name | sort"
+RUNS sh -c "$jira req /rest/api/2/issue/$issue/watchers | jq -r .watchers[].displayName | sort"
 DIFF <<EOF
-gojira
-mothra
+GoJira
+Mothra
 EOF
 
 ###############################################################################
@@ -279,7 +275,7 @@ EOF
 
 NRUNS $jira todo $blocker
 DIFF <<EOF
-ERROR Invalid Transition 'To Do', Available: Backlog, Selected for Development, In Progress, Done
+ERROR Invalid Transition "To Do" from "In Progress", Available: Backlog, Selected for Development, In Progress, Done
 EOF
 
 ###############################################################################
@@ -297,7 +293,7 @@ EOF
 
 NRUNS $jira trans "review" $blocker --noedit
 DIFF <<EOF
-ERROR Invalid Transition 'review', Available: Backlog, Selected for Development, In Progress, Done
+ERROR Invalid Transition "review" from "Backlog", Available: Backlog, Selected for Development, In Progress, Done
 EOF
 
 ###############################################################################
@@ -339,8 +335,8 @@ status: Backlog
 summary: summary
 project: KANBAN
 issuetype: Bug
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: $blocker[Done]
 depends: $dup[Done]
 priority: Medium
@@ -366,8 +362,8 @@ status: Backlog
 summary: summary
 project: KANBAN
 issuetype: Bug
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: $blocker[Done]
 depends: $dup[Done]
 priority: Medium
@@ -376,7 +372,7 @@ description: |
   description
 
 comments:
-  - | # mothra, a minute ago
+  - | # Mothra, a minute ago
     Yo, Comment
 
 EOF
@@ -385,7 +381,7 @@ EOF
 ## Verify we can add labels to an issue
 ###############################################################################
 
-RUNS $jira add labels $blocker test-label another-label
+RUNS $jira labels add $blocker test-label another-label
 DIFF <<EOF
 OK $blocker $ENDPOINT/browse/$blocker
 EOF
@@ -398,8 +394,8 @@ status: Done
 summary: blocks
 project: KANBAN
 issuetype: Bug
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: 
 depends: $issue[Backlog]
 priority: Medium
@@ -413,7 +409,7 @@ EOF
 ## Verify we can remove a label
 ###############################################################################
 
-RUNS $jira remove labels $blocker another-label
+RUNS $jira labels remove $blocker another-label
 DIFF <<EOF
 OK $blocker $ENDPOINT/browse/$blocker
 EOF
@@ -426,8 +422,8 @@ status: Done
 summary: blocks
 project: KANBAN
 issuetype: Bug
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: 
 depends: $issue[Backlog]
 priority: Medium
@@ -441,7 +437,7 @@ EOF
 ## Verify we can replace the labels with a new set
 ###############################################################################
 
-RUNS $jira set labels $blocker more-label better-label
+RUNS $jira labels set $blocker more-label better-label
 DIFF <<EOF
 OK $blocker $ENDPOINT/browse/$blocker
 EOF
@@ -454,8 +450,8 @@ status: Done
 summary: blocks
 project: KANBAN
 issuetype: Bug
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: 
 depends: $issue[Backlog]
 priority: Medium
@@ -482,8 +478,8 @@ status: Done
 summary: blocks
 project: KANBAN
 issuetype: Bug
-assignee: mothra
-reporter: gojira
+assignee: Mothra
+reporter: GoJira
 blockers: 
 depends: $issue[Backlog]
 priority: Medium
@@ -510,8 +506,8 @@ status: Done
 summary: blocks
 project: KANBAN
 issuetype: Bug
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: 
 depends: $issue[Backlog]
 priority: Medium

_t/400project.t

@@ -1,18 +1,13 @@
 #!/bin/bash
 eval "$(curl -q -s https://raw.githubusercontent.com/coryb/osht/master/osht.sh)"
 cd $(dirname $0)
-jira="../jira --project PROJECT"
-export JIRA_LOG_FORMAT="%{level:-5s} %{message}"
-
-ENDPOINT="http://localhost:8080"
-if [ -n "$JIRACLOUD" ]; then
-    ENDPOINT="https://go-jira.atlassian.net"
-fi
+jira="../jira"
+. env.sh
 
 PLAN 84
 
 # cleanup from previous failed test executions
-($jira ls | awk -F: '{print $1}' | while read issue; do ../jira done $issue; done) | sed 's/^/# CLEANUP: /g'
+($jira ls --project PROJECT | awk -F: '{print $1}' | while read issue; do ../jira done $issue; done) | sed 's/^/# CLEANUP: /g'
 
 # reset login
 RUNS $jira logout
@@ -21,7 +16,7 @@ echo "gojira123" | RUNS $jira login
 ###############################################################################
 ## Create an issue
 ###############################################################################
-RUNS $jira create -o summary=summary -o description=description --noedit --saveFile issue.props
+RUNS $jira create --project PROJECT -o summary=summary -o description=description --noedit --saveFile issue.props
 issue=$(awk '/issue/{print $2}' issue.props)
 
 DIFF <<EOF
@@ -40,8 +35,8 @@ status: To Do
 summary: summary
 project: PROJECT
 issuetype: Task
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 priority: Medium
 votes: 0
 description: |
@@ -52,7 +47,7 @@ EOF
 ## List all issues, should be just the one we created
 ###############################################################################
 
-RUNS $jira ls
+RUNS $jira ls --project PROJECT
 DIFF <<EOF
 $(printf %-12s $issue:) summary
 EOF
@@ -63,7 +58,7 @@ EOF
 
 NRUNS $jira close $issue
 EDIFF <<EOF
-ERROR Invalid Transition 'close', Available: Start Progress, Done
+ERROR Invalid Transition "close" from "To Do", Available: Start Progress, Done
 EOF
 
 ###############################################################################
@@ -79,7 +74,7 @@ EOF
 ## Verify there are no unresolved issues
 ###############################################################################
 
-RUNS $jira ls
+RUNS $jira ls --project PROJECT
 DIFF <<EOF
 EOF
 
@@ -87,13 +82,13 @@ EOF
 ## Setup 2 more issues so we can test duping
 ###############################################################################
 
-RUNS $jira create -o summary=summary -o description=description --noedit --saveFile issue.props
+RUNS $jira create --project PROJECT -o summary=summary -o description=description --noedit --saveFile issue.props
 issue=$(awk '/issue/{print $2}' issue.props)
 DIFF <<EOF
 OK $issue $ENDPOINT/browse/$issue
 EOF
 
-RUNS $jira create -o summary=dup -o description=dup --noedit --saveFile issue.props
+RUNS $jira create --project PROJECT -o summary=dup -o description=dup --noedit --saveFile issue.props
 dup=$(awk '/issue/{print $2}' issue.props)
 DIFF <<EOF
 OK $dup $ENDPOINT/browse/$dup
@@ -105,7 +100,7 @@ EOF
 ## that issue should be resolved
 ###############################################################################
 
-RUNS $jira $dup dups $issue --noedit
+RUNS $jira dup $dup $issue
 DIFF <<EOF
 OK $issue $ENDPOINT/browse/$issue
 OK $dup $ENDPOINT/browse/$dup
@@ -119,8 +114,8 @@ status: To Do
 summary: summary
 project: PROJECT
 issuetype: Task
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: 
 depends: $dup[Done]
 priority: Medium
@@ -133,7 +128,7 @@ EOF
 ## We should see only one unresolved issue, the Dup should be resolved
 ###############################################################################
 
-RUNS $jira ls
+RUNS $jira ls --project PROJECT
 DIFF <<EOF
 $(printf %-12s $issue:) summary
 EOF
@@ -142,7 +137,7 @@ EOF
 ## Setup for testing blocking issues
 ###############################################################################
 
-RUNS $jira create -o summary=blocks -o description=blocks --noedit --saveFile issue.props
+RUNS $jira create --project PROJECT -o summary=blocks -o description=blocks --noedit --saveFile issue.props
 blocker=$(awk '/issue/{print $2}' issue.props)
 DIFF <<EOF
 OK $blocker $ENDPOINT/browse/$blocker
@@ -152,9 +147,10 @@ EOF
 ## Set blocker and verify it shows up when viewing the main issue
 ###############################################################################
 
-RUNS $jira $blocker blocks $issue
+RUNS $jira block $blocker $issue
 DIFF <<EOF
 OK $issue $ENDPOINT/browse/$issue
+OK $blocker $ENDPOINT/browse/$blocker
 EOF
 
 RUNS $jira $issue
@@ -165,8 +161,8 @@ status: To Do
 summary: summary
 project: PROJECT
 issuetype: Task
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: $blocker[To Do]
 depends: $dup[Done]
 priority: Medium
@@ -179,7 +175,7 @@ EOF
 ## Both issues are unresolved now
 ###############################################################################
 
-RUNS $jira ls
+RUNS $jira ls --project PROJECT
 DIFF <<EOF
 $(printf %-12s $issue:) summary
 $(printf %-12s $blocker:) blocks
@@ -189,7 +185,7 @@ EOF
 # reset login for mothra for voting
 ###############################################################################
 
-jira="$jira --user mothra"
+jira="$jira --user mothra --login mothra@corybennett.org"
 
 RUNS $jira logout
 echo "mothra123" | RUNS $jira login
@@ -211,8 +207,8 @@ status: To Do
 summary: summary
 project: PROJECT
 issuetype: Task
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: $blocker[To Do]
 depends: $dup[Done]
 priority: Medium
@@ -238,8 +234,8 @@ status: To Do
 summary: summary
 project: PROJECT
 issuetype: Task
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: $blocker[To Do]
 depends: $dup[Done]
 priority: Medium
@@ -258,10 +254,10 @@ OK $issue $ENDPOINT/browse/$issue
 EOF
 
 # FIXME we probably need a watchers command to wrap this?
-RUNS sh -c "$jira req /rest/api/2/issue/$issue/watchers | jq -r .watchers[].name | sort"
+RUNS sh -c "$jira req /rest/api/2/issue/$issue/watchers | jq -r .watchers[].displayName | sort"
 DIFF <<EOF
-gojira
-mothra
+GoJira
+Mothra
 EOF
 
 ###############################################################################
@@ -270,7 +266,7 @@ EOF
 
 NRUNS $jira trans "In Progress" $blocker --noedit
 DIFF <<EOF
-ERROR Invalid Transition 'In Progress', Available: Start Progress, Done
+ERROR Invalid Transition "In Progress" from "To Do", Available: Start Progress, Done
 EOF
 
 
@@ -280,7 +276,7 @@ EOF
 
 NRUNS $jira trans "review" $blocker --noedit
 DIFF <<EOF
-ERROR Invalid Transition 'review', Available: Start Progress, Done
+ERROR Invalid Transition "review" from "To Do", Available: Start Progress, Done
 EOF
 
 ###############################################################################
@@ -300,8 +296,8 @@ status: In Progress
 summary: blocks
 project: PROJECT
 issuetype: Task
-assignee: mothra
-reporter: gojira
+assignee: Mothra
+reporter: GoJira
 blockers: 
 depends: $issue[To Do]
 priority: Medium
@@ -341,8 +337,8 @@ status: To Do
 summary: summary
 project: PROJECT
 issuetype: Task
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: $blocker[Done]
 depends: $dup[Done]
 priority: Medium
@@ -368,8 +364,8 @@ status: To Do
 summary: summary
 project: PROJECT
 issuetype: Task
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: $blocker[Done]
 depends: $dup[Done]
 priority: Medium
@@ -378,7 +374,7 @@ description: |
   description
 
 comments:
-  - | # mothra, a minute ago
+  - | # Mothra, a minute ago
     Yo, Comment
 
 EOF
@@ -387,7 +383,7 @@ EOF
 ## Verify we can add labels to an issue
 ###############################################################################
 
-RUNS $jira add labels $blocker test-label another-label
+RUNS $jira labels add $blocker test-label another-label
 DIFF <<EOF
 OK $blocker $ENDPOINT/browse/$blocker
 EOF
@@ -400,8 +396,8 @@ status: Done
 summary: blocks
 project: PROJECT
 issuetype: Task
-assignee: mothra
-reporter: gojira
+assignee: Mothra
+reporter: GoJira
 blockers: 
 depends: $issue[To Do]
 priority: Medium
@@ -415,7 +411,7 @@ EOF
 ## Verify we can remove a label
 ###############################################################################
 
-RUNS $jira remove labels $blocker another-label
+RUNS $jira labels remove $blocker another-label
 DIFF <<EOF
 OK $blocker $ENDPOINT/browse/$blocker
 EOF
@@ -428,8 +424,8 @@ status: Done
 summary: blocks
 project: PROJECT
 issuetype: Task
-assignee: mothra
-reporter: gojira
+assignee: Mothra
+reporter: GoJira
 blockers: 
 depends: $issue[To Do]
 priority: Medium
@@ -443,7 +439,7 @@ EOF
 ## Verify we can replace the labels with a new set
 ###############################################################################
 
-RUNS $jira set labels $blocker more-label better-label
+RUNS $jira labels set $blocker more-label better-label
 DIFF <<EOF
 OK $blocker $ENDPOINT/browse/$blocker
 EOF
@@ -456,8 +452,8 @@ status: Done
 summary: blocks
 project: PROJECT
 issuetype: Task
-assignee: mothra
-reporter: gojira
+assignee: Mothra
+reporter: GoJira
 blockers: 
 depends: $issue[To Do]
 priority: Medium
@@ -484,8 +480,8 @@ status: Done
 summary: blocks
 project: PROJECT
 issuetype: Task
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: 
 depends: $issue[To Do]
 priority: Medium
@@ -512,8 +508,8 @@ status: Done
 summary: blocks
 project: PROJECT
 issuetype: Task
-assignee: mothra
-reporter: gojira
+assignee: Mothra
+reporter: GoJira
 blockers: 
 depends: $issue[To Do]
 priority: Medium

_t/500process.t

@@ -1,19 +1,18 @@
 #!/bin/bash
 eval "$(curl -q -s https://raw.githubusercontent.com/coryb/osht/master/osht.sh)"
 cd $(dirname $0)
-jira="../jira --project PROCESS"
-export JIRA_LOG_FORMAT="%{level:-5s} %{message}"
-
-ENDPOINT="http://localhost:8080"
-if [ -n "$JIRACLOUD" ]; then
-    ENDPOINT="https://go-jira.atlassian.net"
-fi
+jira="../jira"
+. env.sh
 
 PLAN 84
 
 # cleanup from previous failed test executions
-($jira ls | awk -F: '{print $1}' | while read issue; do ../jira start $issue; done) | sed 's/^/# CLEANUP: /g'
-($jira ls | awk -F: '{print $1}' | while read issue; do ../jira stop $issue; done) | sed 's/^/# CLEANUP: /g'
+($jira ls --project PROCESS | awk -F: '{print $1}' | while read issue; do ../jira start $issue; done) | sed 's/^/# CLEANUP: /g'
+($jira ls --project PROCESS | awk -F: '{print $1}' | while read issue; do ../jira stop $issue; done) | sed 's/^/# CLEANUP: /g'
+
+# for any issues still remaining, they are stuck in "Under Review" status
+($jira ls --project PROCESS | awk -F: '{print $1}' | while read issue; do ../jira transition --noedit -m  "approve" "Approve" $issue; done) | sed 's/^/# CLEANUP: /g'
+($jira ls --project PROCESS | awk -F: '{print $1}' | while read issue; do ../jira transition --noedit -m  "done" "Done" $issue; done) | sed 's/^/# CLEANUP: /g'
 
 # reset login
 RUNS $jira logout
@@ -22,7 +21,7 @@ echo "gojira123" | RUNS $jira login
 ###############################################################################
 ## Create an issue
 ###############################################################################
-RUNS $jira create -o summary=summary -o description=description --noedit --saveFile issue.props
+RUNS $jira create --project PROCESS -o summary=summary -o description=description --noedit --saveFile issue.props
 issue=$(awk '/issue/{print $2}' issue.props)
 
 DIFF <<EOF
@@ -41,8 +40,8 @@ status: Open
 summary: summary
 project: PROCESS
 issuetype: Task
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 priority: Medium
 votes: 0
 description: |
@@ -53,7 +52,7 @@ EOF
 ## List all issues, should be just the one we created
 ###############################################################################
 
-RUNS $jira ls
+RUNS $jira ls --project PROCESS
 DIFF <<EOF
 $(printf %-12s $issue:) summary
 EOF
@@ -64,7 +63,7 @@ EOF
 
 NRUNS $jira close $issue
 EDIFF <<EOF
-ERROR Invalid Transition 'close', Available: Start Progress
+ERROR Invalid Transition "close" from "Open", Available: Start Progress
 EOF
 
 ###############################################################################
@@ -87,7 +86,7 @@ EOF
 ## Verify there are no unresolved issues
 ###############################################################################
 
-RUNS $jira ls
+RUNS $jira ls --project PROCESS
 DIFF <<EOF
 EOF
 
@@ -95,13 +94,13 @@ EOF
 ## Setup 2 more issues so we can test duping
 ###############################################################################
 
-RUNS $jira create -o summary=summary -o description=description --noedit --saveFile issue.props
+RUNS $jira create --project PROCESS -o summary=summary -o description=description --noedit --saveFile issue.props
 issue=$(awk '/issue/{print $2}' issue.props)
 DIFF <<EOF
 OK $issue $ENDPOINT/browse/$issue
 EOF
 
-RUNS $jira create -o summary=dup -o description=dup --noedit --saveFile issue.props
+RUNS $jira create --project PROCESS -o summary=dup -o description=dup --noedit --saveFile issue.props
 dup=$(awk '/issue/{print $2}' issue.props)
 DIFF <<EOF
 OK $dup $ENDPOINT/browse/$dup
@@ -114,12 +113,10 @@ EOF
 ## 2 steps to resolve, one is "Start Progress" then resolved with "Stop
 ## Progress", so we see 3 updates in total
 ###############################################################################
-
-RUNS $jira $dup dups $issue --noedit
+RUNS $jira dup $dup $issue
 DIFF <<EOF
 OK $issue $ENDPOINT/browse/$issue
 OK $dup $ENDPOINT/browse/$dup
-OK $dup $ENDPOINT/browse/$dup
 EOF
 
 RUNS $jira $issue
@@ -130,8 +127,8 @@ status: Open
 summary: summary
 project: PROCESS
 issuetype: Task
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: 
 depends: $dup[Cancelled]
 priority: Medium
@@ -144,7 +141,7 @@ EOF
 ## We should see only one unresolved issue, the Dup should be resolved
 ###############################################################################
 
-RUNS $jira ls
+RUNS $jira ls --project PROCESS
 DIFF <<EOF
 $(printf %-12s $issue:) summary
 EOF
@@ -153,7 +150,7 @@ EOF
 ## Setup for testing blocking issues
 ###############################################################################
 
-RUNS $jira create -o summary=blocks -o description=blocks --noedit --saveFile issue.props
+RUNS $jira create --project PROCESS -o summary=blocks -o description=blocks --noedit --saveFile issue.props
 blocker=$(awk '/issue/{print $2}' issue.props)
 DIFF <<EOF
 OK $blocker $ENDPOINT/browse/$blocker
@@ -163,9 +160,10 @@ EOF
 ## Set blocker and verify it shows up when viewing the main issue
 ###############################################################################
 
-RUNS $jira $blocker blocks $issue
+RUNS $jira block $blocker $issue
 DIFF <<EOF
 OK $issue $ENDPOINT/browse/$issue
+OK $blocker $ENDPOINT/browse/$blocker
 EOF
 
 RUNS $jira $issue
@@ -176,8 +174,8 @@ status: Open
 summary: summary
 project: PROCESS
 issuetype: Task
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: $blocker[Open]
 depends: $dup[Cancelled]
 priority: Medium
@@ -190,7 +188,7 @@ EOF
 ## Both issues are unresolved now
 ###############################################################################
 
-RUNS $jira ls
+RUNS $jira ls --project PROCESS
 DIFF <<EOF
 $(printf %-12s $issue:) summary
 $(printf %-12s $blocker:) blocks
@@ -200,7 +198,7 @@ EOF
 # reset login for mothra for voting
 ###############################################################################
 
-jira="$jira --user mothra"
+jira="$jira --user mothra --login mothra@corybennett.org"
 
 RUNS $jira logout
 echo "mothra123" | RUNS $jira login
@@ -222,8 +220,8 @@ status: Open
 summary: summary
 project: PROCESS
 issuetype: Task
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: $blocker[Open]
 depends: $dup[Cancelled]
 priority: Medium
@@ -249,8 +247,8 @@ status: Open
 summary: summary
 project: PROCESS
 issuetype: Task
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: $blocker[Open]
 depends: $dup[Cancelled]
 priority: Medium
@@ -269,10 +267,10 @@ OK $issue $ENDPOINT/browse/$issue
 EOF
 
 # FIXME we probably need a watchers command to wrap this?
-RUNS sh -c "$jira req /rest/api/2/issue/$issue/watchers | jq -r .watchers[].name | sort"
+RUNS sh -c "$jira req /rest/api/2/issue/$issue/watchers | jq -r .watchers[].displayName | sort"
 DIFF <<EOF
-gojira
-mothra
+GoJira
+Mothra
 EOF
 
 ###############################################################################
@@ -281,7 +279,7 @@ EOF
 
 NRUNS $jira trans "In Progress" $blocker --noedit
 DIFF <<EOF
-ERROR Invalid Transition 'In Progress', Available: Start Progress
+ERROR Invalid Transition "In Progress" from "Open", Available: Start Progress
 EOF
 
 
@@ -291,7 +289,7 @@ EOF
 
 NRUNS $jira trans "review" $blocker --noedit
 DIFF <<EOF
-ERROR Invalid Transition 'review', Available: Start Progress
+ERROR Invalid Transition "review" from "Open", Available: Start Progress
 EOF
 
 ###############################################################################
@@ -334,8 +332,8 @@ status: Open
 summary: summary
 project: PROCESS
 issuetype: Task
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: $blocker[Open]
 depends: $dup[Cancelled]
 priority: Medium
@@ -361,8 +359,8 @@ status: Open
 summary: summary
 project: PROCESS
 issuetype: Task
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: $blocker[Open]
 depends: $dup[Cancelled]
 priority: Medium
@@ -371,7 +369,7 @@ description: |
   description
 
 comments:
-  - | # mothra, a minute ago
+  - | # Mothra, a minute ago
     Yo, Comment
 
 EOF
@@ -380,7 +378,7 @@ EOF
 ## Verify we can add labels to an issue
 ###############################################################################
 
-RUNS $jira add labels $blocker test-label another-label
+RUNS $jira labels add $blocker test-label another-label
 DIFF <<EOF
 OK $blocker $ENDPOINT/browse/$blocker
 EOF
@@ -393,8 +391,8 @@ status: Open
 summary: blocks
 project: PROCESS
 issuetype: Task
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: 
 depends: $issue[Open]
 priority: Medium
@@ -408,7 +406,7 @@ EOF
 ## Verify we can remove a label
 ###############################################################################
 
-RUNS $jira remove labels $blocker another-label
+RUNS $jira labels remove $blocker another-label
 DIFF <<EOF
 OK $blocker $ENDPOINT/browse/$blocker
 EOF
@@ -421,8 +419,8 @@ status: Open
 summary: blocks
 project: PROCESS
 issuetype: Task
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: 
 depends: $issue[Open]
 priority: Medium
@@ -436,7 +434,7 @@ EOF
 ## Verify we can replace the labels with a new set
 ###############################################################################
 
-RUNS $jira set labels $blocker more-label better-label
+RUNS $jira labels set $blocker more-label better-label
 DIFF <<EOF
 OK $blocker $ENDPOINT/browse/$blocker
 EOF
@@ -449,8 +447,8 @@ status: Open
 summary: blocks
 project: PROCESS
 issuetype: Task
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: 
 depends: $issue[Open]
 priority: Medium
@@ -477,8 +475,8 @@ status: Open
 summary: blocks
 project: PROCESS
 issuetype: Task
-assignee: mothra
-reporter: gojira
+assignee: Mothra
+reporter: GoJira
 blockers: 
 depends: $issue[Open]
 priority: Medium
@@ -505,8 +503,8 @@ status: Open
 summary: blocks
 project: PROCESS
 issuetype: Task
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: 
 depends: $issue[Open]
 priority: Medium

_t/600task.t

@@ -1,18 +1,13 @@
 #!/bin/bash
 eval "$(curl -q -s https://raw.githubusercontent.com/coryb/osht/master/osht.sh)"
 cd $(dirname $0)
-jira="../jira --project TASK"
-export JIRA_LOG_FORMAT="%{level:-5s} %{message}"
-
-ENDPOINT="http://localhost:8080"
-if [ -n "$JIRACLOUD" ]; then
-    ENDPOINT="https://go-jira.atlassian.net"
-fi
+jira="../jira"
+. env.sh
 
 PLAN 82
 
 # cleanup from previous failed test executions
-($jira ls | awk -F: '{print $1}' | while read issue; do ../jira done $issue; done) | sed 's/^/# CLEANUP: /g'
+($jira ls --project TASK | awk -F: '{print $1}' | while read issue; do ../jira done $issue; done) | sed 's/^/# CLEANUP: /g'
 
 # reset login
 RUNS $jira logout
@@ -21,7 +16,7 @@ echo "gojira123" | RUNS $jira login
 ###############################################################################
 ## Create an issue
 ###############################################################################
-RUNS $jira create -o summary=summary -o description=description --noedit --saveFile issue.props
+RUNS $jira create --project TASK -o summary=summary -o description=description --noedit --saveFile issue.props
 issue=$(awk '/issue/{print $2}' issue.props)
 
 DIFF <<EOF
@@ -40,8 +35,8 @@ status: To Do
 summary: summary
 project: TASK
 issuetype: Task
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 priority: Medium
 votes: 0
 description: |
@@ -52,7 +47,7 @@ EOF
 ## List all issues, should be just the one we created
 ###############################################################################
 
-RUNS $jira ls
+RUNS $jira ls --project TASK
 DIFF <<EOF
 $(printf %-12s $issue:) summary
 EOF
@@ -63,7 +58,7 @@ EOF
 
 NRUNS $jira close $issue
 EDIFF <<EOF
-ERROR Invalid Transition 'close', Available: Done
+ERROR Invalid Transition "close" from "To Do", Available: Done
 EOF
 
 ###############################################################################
@@ -79,7 +74,7 @@ EOF
 ## Verify there are no unresolved issues
 ###############################################################################
 
-RUNS $jira ls
+RUNS $jira ls --project TASK
 DIFF <<EOF
 EOF
 
@@ -87,13 +82,13 @@ EOF
 ## Setup 2 more issues so we can test duping
 ###############################################################################
 
-RUNS $jira create -o summary=summary -o description=description --noedit --saveFile issue.props
+RUNS $jira create --project TASK -o summary=summary -o description=description --noedit --saveFile issue.props
 issue=$(awk '/issue/{print $2}' issue.props)
 DIFF <<EOF
 OK $issue $ENDPOINT/browse/$issue
 EOF
 
-RUNS $jira create -o summary=dup -o description=dup --noedit --saveFile issue.props
+RUNS $jira create --project TASK -o summary=dup -o description=dup --noedit --saveFile issue.props
 dup=$(awk '/issue/{print $2}' issue.props)
 DIFF <<EOF
 OK $dup $ENDPOINT/browse/$dup
@@ -107,7 +102,7 @@ EOF
 ## Progress", so we see 3 updates in total
 ###############################################################################
 
-RUNS $jira $dup dups $issue --noedit
+RUNS $jira dup $dup $issue
 DIFF <<EOF
 OK $issue $ENDPOINT/browse/$issue
 OK $dup $ENDPOINT/browse/$dup
@@ -121,8 +116,8 @@ status: To Do
 summary: summary
 project: TASK
 issuetype: Task
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: 
 depends: $dup[Done]
 priority: Medium
@@ -135,7 +130,7 @@ EOF
 ## We should see only one unresolved issue, the Dup should be resolved
 ###############################################################################
 
-RUNS $jira ls
+RUNS $jira ls --project TASK
 DIFF <<EOF
 $(printf %-12s $issue:) summary
 EOF
@@ -144,7 +139,7 @@ EOF
 ## Setup for testing blocking issues
 ###############################################################################
 
-RUNS $jira create -o summary=blocks -o description=blocks --noedit --saveFile issue.props
+RUNS $jira create --project TASK -o summary=blocks -o description=blocks --noedit --saveFile issue.props
 blocker=$(awk '/issue/{print $2}' issue.props)
 DIFF <<EOF
 OK $blocker $ENDPOINT/browse/$blocker
@@ -154,9 +149,10 @@ EOF
 ## Set blocker and verify it shows up when viewing the main issue
 ###############################################################################
 
-RUNS $jira $blocker blocks $issue
+RUNS $jira block $blocker $issue
 DIFF <<EOF
 OK $issue $ENDPOINT/browse/$issue
+OK $blocker $ENDPOINT/browse/$blocker
 EOF
 
 RUNS $jira $issue
@@ -167,8 +163,8 @@ status: To Do
 summary: summary
 project: TASK
 issuetype: Task
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: $blocker[To Do]
 depends: $dup[Done]
 priority: Medium
@@ -181,7 +177,7 @@ EOF
 ## Both issues are unresolved now
 ###############################################################################
 
-RUNS $jira ls
+RUNS $jira ls --project TASK
 DIFF <<EOF
 $(printf %-12s $issue:) summary
 $(printf %-12s $blocker:) blocks
@@ -191,7 +187,7 @@ EOF
 # reset login for mothra for voting
 ###############################################################################
 
-jira="$jira --user mothra"
+jira="$jira --user mothra --login mothra@corybennett.org"
 
 RUNS $jira logout
 echo "mothra123" | RUNS $jira login
@@ -213,8 +209,8 @@ status: To Do
 summary: summary
 project: TASK
 issuetype: Task
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: $blocker[To Do]
 depends: $dup[Done]
 priority: Medium
@@ -240,8 +236,8 @@ status: To Do
 summary: summary
 project: TASK
 issuetype: Task
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: $blocker[To Do]
 depends: $dup[Done]
 priority: Medium
@@ -260,10 +256,10 @@ OK $issue $ENDPOINT/browse/$issue
 EOF
 
 # FIXME we probably need a watchers command to wrap this?
-RUNS sh -c "$jira req /rest/api/2/issue/$issue/watchers | jq -r .watchers[].name | sort"
+RUNS sh -c "$jira req /rest/api/2/issue/$issue/watchers | jq -r .watchers[].displayName | sort"
 DIFF <<EOF
-gojira
-mothra
+GoJira
+Mothra
 EOF
 
 ###############################################################################
@@ -272,7 +268,7 @@ EOF
 
 NRUNS $jira trans "In Progress" $blocker --noedit
 DIFF <<EOF
-ERROR Invalid Transition 'In Progress', Available: Done
+ERROR Invalid Transition "In Progress" from "To Do", Available: Done
 EOF
 
 
@@ -282,7 +278,7 @@ EOF
 
 NRUNS $jira trans "review" $blocker --noedit
 DIFF <<EOF
-ERROR Invalid Transition 'review', Available: Done
+ERROR Invalid Transition "review" from "To Do", Available: Done
 EOF
 
 ###############################################################################
@@ -291,7 +287,7 @@ EOF
 
 NRUNS $jira start $blocker
 DIFF <<EOF
-ERROR Invalid Transition 'start', Available: Done
+ERROR Invalid Transition "start" from "To Do", Available: Done
 EOF
 
 ###############################################################################
@@ -300,7 +296,7 @@ EOF
 
 NRUNS $jira stop $blocker
 DIFF <<EOF
-ERROR Invalid Transition 'stop', Available: Done
+ERROR Invalid Transition "stop" from "To Do", Available: Done
 EOF
 
 
@@ -325,8 +321,8 @@ status: To Do
 summary: summary
 project: TASK
 issuetype: Task
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: $blocker[Done]
 depends: $dup[Done]
 priority: Medium
@@ -352,8 +348,8 @@ status: To Do
 summary: summary
 project: TASK
 issuetype: Task
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: $blocker[Done]
 depends: $dup[Done]
 priority: Medium
@@ -362,7 +358,7 @@ description: |
   description
 
 comments:
-  - | # mothra, a minute ago
+  - | # Mothra, a minute ago
     Yo, Comment
 
 EOF
@@ -371,7 +367,7 @@ EOF
 ## Verify we can add labels to an issue
 ###############################################################################
 
-RUNS $jira add labels $blocker test-label another-label
+RUNS $jira labels add $blocker test-label another-label
 DIFF <<EOF
 OK $blocker $ENDPOINT/browse/$blocker
 EOF
@@ -384,8 +380,8 @@ status: Done
 summary: blocks
 project: TASK
 issuetype: Task
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: 
 depends: $issue[To Do]
 priority: Medium
@@ -399,7 +395,7 @@ EOF
 ## Verify we can remove a label
 ###############################################################################
 
-RUNS $jira remove labels $blocker another-label
+RUNS $jira labels remove $blocker another-label
 DIFF <<EOF
 OK $blocker $ENDPOINT/browse/$blocker
 EOF
@@ -412,8 +408,8 @@ status: Done
 summary: blocks
 project: TASK
 issuetype: Task
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: 
 depends: $issue[To Do]
 priority: Medium
@@ -427,7 +423,7 @@ EOF
 ## Verify we can replace the labels with a new set
 ###############################################################################
 
-RUNS $jira set labels $blocker more-label better-label
+RUNS $jira labels set $blocker more-label better-label
 DIFF <<EOF
 OK $blocker $ENDPOINT/browse/$blocker
 EOF
@@ -440,8 +436,8 @@ status: Done
 summary: blocks
 project: TASK
 issuetype: Task
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: 
 depends: $issue[To Do]
 priority: Medium
@@ -468,8 +464,8 @@ status: Done
 summary: blocks
 project: TASK
 issuetype: Task
-assignee: mothra
-reporter: gojira
+assignee: Mothra
+reporter: GoJira
 blockers: 
 depends: $issue[To Do]
 priority: Medium
@@ -496,8 +492,8 @@ status: Done
 summary: blocks
 project: TASK
 issuetype: Task
-assignee: gojira
-reporter: gojira
+assignee: GoJira
+reporter: GoJira
 blockers: 
 depends: $issue[To Do]
 priority: Medium

_t/README.md

@@ -9,7 +9,7 @@ From the top level of the project you can run:
 # this creates a local "jira" binary
 make
 
-# this runs the integration tests in the "t" directory
+# this runs the integration tests in the "_t" directory
 prove
 ```
 

_t/dockerroot/jiratestservice/pom.xml

@@ -173,7 +173,7 @@
 
     <properties>
         <jira.version>7.2.0</jira.version>
-        <amps.version>6.2.6</amps.version>
+        <amps.version>6.3.15</amps.version>
         <plugin.testrunner.version>1.2.3</plugin.testrunner.version>
         <atlassian.spring.scanner.version>1.2.13</atlassian.spring.scanner.version>
         <!-- This key is used to keep the consistency between the key in atlassian-plugin.xml and the key to generate bundle. -->

_t/env.sh

@@ -0,0 +1,7 @@
+export COLUMNS=149
+export JIRA_LOG_FORMAT="%{level:-5s} %{message}"
+export ENDPOINT="https://go-jira.atlassian.net"
+export GNUPGHOME=$(pwd)/.gnupg
+export PASSWORD_STORE_DIR=$(pwd)/.password-store
+export JIRACLOUD=1
+

_t/test_binaries.sh

@@ -0,0 +1,40 @@
+#!/bin/bash
+
+#dist/github.com/go-jira/jira-darwin-amd64      dist/github.com/go-jira/jira-linux-amd64       dist/github.com/go-jira/jira-windows-amd64.exe
+#dist/github.com/go-jira/jira-linux-386         dist/github.com/go-jira/jira-windows-386.exe
+
+EXIT_CODE=0
+
+function error() {
+  echo $1
+  EXIT_CODE=1
+}
+
+DIST_DIR="dist/github.com/go-jira"
+
+out=`file ${DIST_DIR}/jira-darwin-amd64 2>&1`
+if ! [[ "$out" =~ "Mach-O 64-bit" ]]; then
+   error "darwin/amd64 build not as expected: $out"
+fi
+
+out=`file ${DIST_DIR}/jira-linux-amd64 2>&1`
+if ! [[ "$out" =~ "ELF 64-bit LSB executable, x86-64" ]]; then
+   error "linux/amd64 build not as expected: $out"
+fi
+
+out=`file ${DIST_DIR}/jira-linux-386 2>&1`
+if ! [[ "$out" =~ "ELF 32-bit LSB executable, Intel 80386" ]]; then
+   error "linux/i386 build not as expected: $out"
+fi
+
+out=`file ${DIST_DIR}/jira-windows-amd64.exe 2>&1`
+if ! [[ "$out" =~ "PE32+ executable (console) x86-64" ]]; then
+   error "windows/amd64 build not as expected: $out"
+fi
+
+out=`file ${DIST_DIR}/jira-windows-386.exe 2>&1`
+if ! [[ "$out" =~ "PE32 executable (console) Intel 80386" ]]; then
+   error "windows/i386 build not as expected: $out"
+fi
+
+exit $EXIT_CODE

attachment.go

@@ -0,0 +1,46 @@
+package jira
+
+import (
+	"encoding/json"
+
+	"github.com/go-jira/jira/jiradata"
+)
+
+// https://docs.atlassian.com/jira/REST/cloud/#api/2/attachment-getAttachment
+func (j *Jira) GetAttachment(id string) (*jiradata.Attachment, error) {
+	return GetAttachment(j.UA, j.Endpoint, id)
+}
+
+func GetAttachment(ua HttpClient, endpoint string, id string) (*jiradata.Attachment, error) {
+	uri := URLJoin(endpoint, "rest/api/2/attachment", id)
+	resp, err := ua.GetJSON(uri)
+	if err != nil {
+		return nil, err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode == 200 {
+		results := &jiradata.Attachment{}
+		return results, json.NewDecoder(resp.Body).Decode(results)
+	}
+	return nil, responseError(resp)
+}
+
+// https://docs.atlassian.com/jira/REST/cloud/#api/2/attachment-removeAttachment
+func (j *Jira) RemoveAttachment(id string) error {
+	return RemoveAttachment(j.UA, j.Endpoint, id)
+}
+
+func RemoveAttachment(ua HttpClient, endpoint string, id string) error {
+	uri := URLJoin(endpoint, "rest/api/2/attachment", id)
+	resp, err := ua.Delete(uri)
+	if err != nil {
+		return err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode == 204 {
+		return nil
+	}
+	return responseError(resp)
+}

cli.go

@@ -1,646 +0,0 @@
-package jira
-
-import (
-	"bytes"
-	"crypto/tls"
-	"encoding/json"
-	"fmt"
-	"io/ioutil"
-	"net/http"
-	"net/http/cookiejar"
-	"net/http/httputil"
-	"net/url"
-	"os"
-	"os/exec"
-	"path"
-	"path/filepath"
-	"runtime"
-	"strings"
-	"time"
-
-	"github.com/kballard/go-shellquote"
-	"gopkg.in/coryb/yaml.v2"
-	"gopkg.in/op/go-logging.v1"
-)
-
-var (
-	log = logging.MustGetLogger("jira")
-	// VERSION is the go-jira library version
-	VERSION string
-)
-
-// Cli is go-jira client object
-type Cli struct {
-	endpoint   *url.URL
-	opts       map[string]interface{}
-	cookieFile string
-	ua         *http.Client
-}
-
-// New creates go-jira client object
-func New(opts map[string]interface{}) *Cli {
-	homedir := homedir()
-	cookieJar, _ := cookiejar.New(nil)
-	endpoint, _ := opts["endpoint"].(string)
-	url, _ := url.Parse(strings.TrimRight(endpoint, "/"))
-
-	if project, ok := opts["project"].(string); ok {
-		opts["project"] = strings.ToUpper(project)
-	}
-
-	var ua *http.Client
-	if unixProxyPath, ok := opts["unixproxy"].(string); ok {
-		ua = &http.Client{
-			Jar:       cookieJar,
-			Transport: UnixProxy(unixProxyPath),
-		}
-	} else {
-		transport := &http.Transport{
-			Proxy:           http.ProxyFromEnvironment,
-			TLSClientConfig: &tls.Config{},
-		}
-		if insecureSkipVerify, ok := opts["insecure"].(bool); ok {
-			transport.TLSClientConfig.InsecureSkipVerify = insecureSkipVerify
-		}
-
-		ua = &http.Client{
-			Jar:       cookieJar,
-			Transport: transport,
-		}
-	}
-
-	cli := &Cli{
-		endpoint:   url,
-		opts:       opts,
-		cookieFile: filepath.Join(homedir, ".jira.d", "cookies.js"),
-		ua:         ua,
-	}
-
-	cli.ua.Jar.SetCookies(url, cli.loadCookies())
-
-	return cli
-}
-
-func (c *Cli) saveCookies(resp *http.Response) {
-	if _, ok := resp.Header["Set-Cookie"]; !ok {
-		return
-	}
-
-	cookies := resp.Cookies()
-	for _, cookie := range cookies {
-		if cookie.Domain == "" {
-			// if it is host:port then we need to split off port
-			parts := strings.Split(resp.Request.URL.Host, ":")
-			host := parts[0]
-			log.Debugf("Setting DOMAIN to %s for Cookie: %s", host, cookie)
-			cookie.Domain = host
-		}
-	}
-
-	// expiry in one week from now
-	expiry := time.Now().Add(24 * 7 * time.Hour)
-	for _, cookie := range cookies {
-		cookie.Expires = expiry
-	}
-
-	if currentCookies := c.loadCookies(); currentCookies != nil {
-		currentCookiesByName := make(map[string]*http.Cookie)
-		for _, cookie := range currentCookies {
-			currentCookiesByName[cookie.Name+cookie.Domain] = cookie
-		}
-
-		for _, cookie := range cookies {
-			currentCookiesByName[cookie.Name+cookie.Domain] = cookie
-		}
-
-		mergedCookies := make([]*http.Cookie, 0, len(currentCookiesByName))
-		for _, v := range currentCookiesByName {
-			mergedCookies = append(mergedCookies, v)
-		}
-		jsonWrite(c.cookieFile, mergedCookies)
-	} else {
-		mkdir(path.Dir(c.cookieFile))
-		jsonWrite(c.cookieFile, cookies)
-	}
-}
-
-func (c *Cli) loadCookies() []*http.Cookie {
-	bytes, err := ioutil.ReadFile(c.cookieFile)
-	if err != nil && os.IsNotExist(err) {
-		// dont load cookies if the file does not exist
-		return nil
-	}
-	if err != nil {
-		log.Errorf("Failed to open %s: %s", c.cookieFile, err)
-		panic(err)
-	}
-	cookies := []*http.Cookie{}
-	err = json.Unmarshal(bytes, &cookies)
-	if err != nil {
-		log.Errorf("Failed to parse json from file %s: %s", c.cookieFile, err)
-	}
-
-	if os.Getenv("LOG_TRACE") != "" && log.IsEnabledFor(logging.DEBUG) {
-		log.Debugf("Loading Cookies: %s", cookies)
-	}
-	return cookies
-}
-
-func (c *Cli) post(uri string, content string) (*http.Response, error) {
-	return c.makeRequestWithContent("POST", uri, content)
-}
-
-func (c *Cli) put(uri string, content string) (*http.Response, error) {
-	return c.makeRequestWithContent("PUT", uri, content)
-}
-
-func (c *Cli) delete(uri string) (resp *http.Response, err error) {
-	method := "DELETE"
-	req, _ := http.NewRequest(method, uri, nil)
-	log.Infof("%s %s", req.Method, req.URL.String())
-	if resp, err = c.makeRequest(req); err != nil {
-		return nil, err
-	}
-	if resp.StatusCode == 401 {
-		if err = c.CmdLogin(); err != nil {
-			return nil, err
-		}
-		req, _ = http.NewRequest(method, uri, nil)
-		return c.makeRequest(req)
-	}
-	return resp, err
-}
-
-func (c *Cli) makeRequestWithContent(method string, uri string, content string) (resp *http.Response, err error) {
-	buffer := bytes.NewBufferString(content)
-	req, _ := http.NewRequest(method, uri, buffer)
-
-	log.Infof("%s %s", req.Method, req.URL.String())
-	if resp, err = c.makeRequest(req); err != nil {
-		return nil, err
-	}
-	if resp.StatusCode == 401 {
-		if err = c.CmdLogin(); err != nil {
-			return nil, err
-		}
-		req, _ = http.NewRequest(method, uri, bytes.NewBufferString(content))
-		return c.makeRequest(req)
-	}
-	return resp, err
-}
-
-func (c *Cli) get(uri string) (resp *http.Response, err error) {
-	req, _ := http.NewRequest("GET", uri, nil)
-	log.Infof("%s %s", req.Method, req.URL.String())
-	if log.IsEnabledFor(logging.DEBUG) {
-		logBuffer := bytes.NewBuffer(make([]byte, 0))
-		req.Write(logBuffer)
-		log.Debugf("%s", logBuffer)
-	}
-
-	if resp, err = c.makeRequest(req); err != nil {
-		return nil, err
-	}
-	if resp.StatusCode == 401 {
-		if err := c.CmdLogin(); err != nil {
-			return nil, err
-		}
-		return c.makeRequest(req)
-	}
-	return resp, err
-}
-
-func (c *Cli) makeRequest(req *http.Request) (resp *http.Response, err error) {
-	req.Header.Set("Accept", "application/json")
-	req.Header.Set("Content-Type", "application/json")
-
-	if source, ok := c.opts["password-source"]; ok && !strings.HasSuffix(req.URL.Path, "/rest/auth/1/session") {
-		user, _ := c.opts["user"].(string)
-		password := c.GetPass(user)
-		if password == "" {
-			log.Warning("No password for user %s in %s, please run the 'login' command first", user, source)
-		} else {
-			req.SetBasicAuth(user, password)
-		}
-	}
-
-	// this is actually done in http.send but doing it
-	// here so we can log it in DumpRequest for debugging
-	for _, cookie := range c.ua.Jar.Cookies(req.URL) {
-		req.AddCookie(cookie)
-	}
-
-	if log.IsEnabledFor(logging.DEBUG) {
-		out, _ := httputil.DumpRequest(req, true)
-		log.Debugf("Request: %s", out)
-	}
-
-	if resp, err = c.ua.Do(req); err != nil {
-		log.Errorf("Failed to %s %s: %s", req.Method, req.URL.String(), err)
-		return nil, err
-	}
-	if resp.StatusCode < 200 || resp.StatusCode >= 300 && resp.StatusCode != 401 {
-		log.Errorf("response status: %s", resp.Status)
-	}
-
-	runtime.SetFinalizer(resp, func(r *http.Response) {
-		r.Body.Close()
-	})
-
-	if _, ok := resp.Header["Set-Cookie"]; ok {
-		c.saveCookies(resp)
-	}
-	if log.IsEnabledFor(logging.DEBUG) {
-		out, _ := httputil.DumpResponse(resp, true)
-		log.Debugf("Response: %s", out)
-	}
-	return resp, nil
-}
-
-// GetTemplate will return the text/template for the given command name
-func (c *Cli) GetTemplate(name string) string {
-	return c.getTemplate(name)
-}
-
-func getLookedUpTemplate(name string, dflt string) string {
-	if file, err := FindClosestParentPath(filepath.Join(".jira.d", "templates", name)); err == nil {
-		return readFile(file)
-	}
-	if _, err := os.Stat(fmt.Sprintf("/etc/go-jira/templates/%s", name)); err == nil {
-		file := fmt.Sprintf("/etc/go-jira/templates/%s", name)
-		return readFile(file)
-	}
-	return dflt
-}
-
-func (c *Cli) getTemplate(name string) string {
-	if override, ok := c.opts["template"].(string); ok {
-		if _, err := os.Stat(override); err == nil {
-			return readFile(override)
-		}
-		if t := getLookedUpTemplate(override, allTemplates[override]); t != "" {
-			return t
-		}
-	}
-	// create-bug etc are special, if we dont find it in the path
-	// then just return the create template
-	if strings.HasPrefix(name, "create-") {
-		return getLookedUpTemplate(name, c.getTemplate("create"))
-	}
-	return getLookedUpTemplate(name, allTemplates[name])
-}
-
-// NoChangesFound is an error returned from when editing templates
-// and no modifications were made while editing
-type NoChangesFound struct{}
-
-func (f NoChangesFound) Error() string {
-	return "No changes found, aborting"
-}
-
-func (c *Cli) editTemplate(template string, tmpFilePrefix string, templateData map[string]interface{}, templateProcessor func(string) error) error {
-
-	tmpdir := filepath.Join(homedir(), ".jira.d", "tmp")
-	if err := mkdir(tmpdir); err != nil {
-		return err
-	}
-
-	fh, err := ioutil.TempFile(tmpdir, tmpFilePrefix)
-	if err != nil {
-		log.Errorf("Failed to make temp file in %s: %s", tmpdir, err)
-		return err
-	}
-
-	oldFileName := fh.Name()
-	tmpFileName := fmt.Sprintf("%s.yml", oldFileName)
-
-	// close tmpfile so we can rename on windows
-	fh.Close()
-
-	if err := os.Rename(oldFileName, tmpFileName); err != nil {
-		log.Errorf("Failed to rename %s to %s: %s", oldFileName, tmpFileName, err)
-		return err
-	}
-
-	fh, err = os.OpenFile(tmpFileName, os.O_RDWR|os.O_EXCL, 0600)
-	if err != nil {
-		log.Errorf("Failed to reopen temp file file in %s: %s", tmpFileName, err)
-		return err
-	}
-
-	defer fh.Close()
-	defer func() {
-		os.Remove(tmpFileName)
-	}()
-
-	err = runTemplate(template, templateData, fh)
-	if err != nil {
-		return err
-	}
-
-	fh.Close()
-
-	editor, ok := c.opts["editor"].(string)
-	if !ok {
-		editor = os.Getenv("JIRA_EDITOR")
-		if editor == "" {
-			editor = os.Getenv("EDITOR")
-			if editor == "" {
-				editor = "vim"
-			}
-		}
-	}
-
-	editing := c.getOptBool("edit", true)
-
-	tmpFileNameOrig := fmt.Sprintf("%s.orig", tmpFileName)
-	copyFile(tmpFileName, tmpFileNameOrig)
-	defer func() {
-		os.Remove(tmpFileNameOrig)
-	}()
-
-	for true {
-		if editing {
-			shell, _ := shellquote.Split(editor)
-			shell = append(shell, tmpFileName)
-			log.Debugf("Running: %#v", shell)
-			cmd := exec.Command(shell[0], shell[1:]...)
-			cmd.Stdout, cmd.Stderr, cmd.Stdin = os.Stdout, os.Stderr, os.Stdin
-			if err := cmd.Run(); err != nil {
-				log.Errorf("Failed to edit template with %s: %s", editor, err)
-				if promptYN("edit again?", true) {
-					continue
-				}
-				return err
-			}
-
-			diff := exec.Command("diff", "-q", tmpFileNameOrig, tmpFileName)
-			// if err == nil then diff found no changes
-			if err := diff.Run(); err == nil {
-				return NoChangesFound{}
-			}
-		}
-
-		edited := make(map[string]interface{})
-		var data []byte
-		if data, err = ioutil.ReadFile(tmpFileName); err != nil {
-			log.Errorf("Failed to read tmpfile %s: %s", tmpFileName, err)
-			if editing && promptYN("edit again?", true) {
-				continue
-			}
-			return err
-		}
-		if err := yaml.Unmarshal(data, &edited); err != nil {
-			log.Errorf("Failed to parse YAML: %s", err)
-			if editing && promptYN("edit again?", true) {
-				continue
-			}
-			return err
-		}
-
-		var fixed interface{}
-		if fixed, err = yamlFixup(edited); err != nil {
-			return err
-		}
-		edited = fixed.(map[string]interface{})
-
-		// if you want to abort editing a jira issue then
-		// you can add the "abort: true" flag to the document
-		// and we will abort now
-		if val, ok := edited["abort"].(bool); ok && val {
-			log.Infof("abort flag found in template, quiting")
-			return fmt.Errorf("abort flag found in template, quiting")
-		}
-
-		if _, ok := templateData["meta"]; ok {
-			mf := templateData["meta"].(map[string]interface{})["fields"]
-			if f, ok := edited["fields"].(map[string]interface{}); ok {
-				for k := range f {
-					if _, ok := mf.(map[string]interface{})[k]; !ok {
-						err := fmt.Errorf("Field %s is not editable", k)
-						log.Errorf("%s", err)
-						if editing && promptYN("edit again?", true) {
-							continue
-						}
-						return err
-					}
-				}
-			}
-		}
-
-		json, err := jsonEncode(edited)
-		if err != nil {
-			return err
-		}
-
-		if err := templateProcessor(json); err != nil {
-			log.Errorf("%s", err)
-			if editing && promptYN("edit again?", true) {
-				continue
-			}
-		}
-		return nil
-	}
-	return nil
-}
-
-// Browse will open up your default browser to the provided issue
-func (c *Cli) Browse(issue string) error {
-	if val, ok := c.opts["browse"].(bool); ok && val {
-		if runtime.GOOS == "darwin" {
-			return exec.Command("open", fmt.Sprintf("%s/browse/%s", c.endpoint, issue)).Run()
-		} else if runtime.GOOS == "linux" {
-			return exec.Command("xdg-open", fmt.Sprintf("%s/browse/%s", c.endpoint, issue)).Run()
-		} else if runtime.GOOS == "windows" {
-			return exec.Command("cmd", "/c", "start", fmt.Sprintf("%s/browse/%s", c.endpoint, issue)).Run()
-		}
-	}
-	return nil
-}
-
-// SaveData will write out the yaml formated --saveFile file with provided data
-func (c *Cli) SaveData(data interface{}) error {
-	if val, ok := c.opts["saveFile"].(string); ok && val != "" {
-		yamlWrite(val, data)
-	}
-	return nil
-}
-
-// ViewIssueWorkLogs gets the worklog data for the given issue
-func (c *Cli) ViewIssueWorkLogs(issue string) (interface{}, error) {
-	uri := fmt.Sprintf("%s/rest/api/2/issue/%s/worklog", c.endpoint, issue)
-	data, err := responseToJSON(c.get(uri))
-	if err != nil {
-		return nil, err
-	}
-	return data, nil
-}
-
-// ViewIssue will return the details for the given issue id
-func (c *Cli) ViewIssue(issue string) (interface{}, error) {
-	uri := fmt.Sprintf("%s/rest/api/2/issue/%s", c.endpoint, issue)
-	if x := c.expansions(); len(x) > 0 {
-		uri = fmt.Sprintf("%s?expand=%s", uri, strings.Join(x, ","))
-	}
-
-	data, err := responseToJSON(c.get(uri))
-	if err != nil {
-		return nil, err
-	}
-	return data, nil
-}
-
-// FindIssues will return a list of issues that match the given options.
-// If the "query" option is undefined it will generate a JQL query
-// using any/all of the provide options: project, component, assignee,
-// issuetype, watcher, reporter, sort
-// Further it will restrict the fields being extracted from the jira
-// response with the 'queryfields' option
-func (c *Cli) FindIssues() (interface{}, error) {
-	var query string
-	var ok bool
-	// project = BAKERY and status not in (Resolved, Closed)
-	if query, ok = c.opts["query"].(string); !ok {
-		qbuff := bytes.NewBufferString("resolution = unresolved")
-		var project string
-		if project, ok = c.opts["project"].(string); !ok {
-			err := fmt.Errorf("Missing required arguments, either 'query' or 'project' are required")
-			log.Errorf("%s", err)
-			return nil, err
-		}
-		qbuff.WriteString(fmt.Sprintf(" AND project = '%s'", project))
-
-		if component, ok := c.opts["component"]; ok {
-			qbuff.WriteString(fmt.Sprintf(" AND component = '%s'", component))
-		}
-
-		if assignee, ok := c.opts["assignee"]; ok {
-			qbuff.WriteString(fmt.Sprintf(" AND assignee = '%s'", assignee))
-		}
-
-		if issuetype, ok := c.opts["issuetype"]; ok {
-			qbuff.WriteString(fmt.Sprintf(" AND issuetype = '%s'", issuetype))
-		}
-
-		if watcher, ok := c.opts["watcher"]; ok {
-			qbuff.WriteString(fmt.Sprintf(" AND watcher = '%s'", watcher))
-		}
-
-		if reporter, ok := c.opts["reporter"]; ok {
-			qbuff.WriteString(fmt.Sprintf(" AND reporter = '%s'", reporter))
-		}
-
-		if sort, ok := c.opts["sort"]; ok && sort != "" {
-			qbuff.WriteString(fmt.Sprintf(" ORDER BY %s", sort))
-		}
-
-		query = qbuff.String()
-	}
-
-	fields := []string{"summary"}
-	if qf, ok := c.opts["queryfields"].(string); ok {
-		fields = strings.Split(qf, ",")
-	}
-
-	json, err := jsonEncode(map[string]interface{}{
-		"jql":        query,
-		"startAt":    "0",
-		"maxResults": c.opts["max_results"],
-		"fields":     fields,
-		"expand":     c.expansions(),
-	})
-	if err != nil {
-		return nil, err
-	}
-
-	uri := fmt.Sprintf("%s/rest/api/2/search", c.endpoint)
-	var data interface{}
-	if data, err = responseToJSON(c.post(uri, json)); err != nil {
-		return nil, err
-	}
-	return data, nil
-}
-
-// RankOrder type used to specify before/after ranking arguments to RankIssue
-type RankOrder int
-
-const (
-	// RANKBEFORE should be used to rank issue before the target issue
-	RANKBEFORE RankOrder = iota
-	// RANKAFTER should be used to rank issue after the target issue
-	RANKAFTER RankOrder = iota
-)
-
-// RankIssue will modify issue to have rank before or after the target issue
-func (c *Cli) RankIssue(issue, target string, order RankOrder) error {
-	type RankRequest struct {
-		Issues []string `json:"issues"`
-		Before string   `json:"rankBeforeIssue,omitempty"`
-		After  string   `json:"rankAfterIssue,omitempty"`
-	}
-	req := &RankRequest{
-		Issues: []string{
-			issue,
-		},
-	}
-	if order == RANKBEFORE {
-		req.Before = target
-	} else {
-		req.After = target
-	}
-
-	json, err := jsonEncode(req)
-	if err != nil {
-		return err
-	}
-
-	uri := fmt.Sprintf("%s/rest/agile/1.0/issue/rank", c.endpoint)
-	if c.getOptBool("dryrun", false) {
-		log.Debugf("PUT: %s", json)
-		log.Debugf("Dryrun mode, skipping PUT")
-		return nil
-	}
-	resp, err := c.put(uri, json)
-	if err != nil {
-		return err
-	}
-	if resp.StatusCode != 204 {
-		return fmt.Errorf("failed to modify issue rank: %s", resp.Status)
-	}
-	return nil
-}
-
-// GetOptString will extract the string from the Cli object options
-// otherwise return the provided default
-func (c *Cli) GetOptString(optName string, dflt string) string {
-	return c.getOptString(optName, dflt)
-}
-
-func (c *Cli) getOptString(optName string, dflt string) string {
-	if val, ok := c.opts[optName].(string); ok {
-		return val
-	}
-	return dflt
-}
-
-// GetOptBool will extract the boolean value from the Client object options
-// otherwise return the provided default\
-func (c *Cli) GetOptBool(optName string, dflt bool) bool {
-	return c.getOptBool(optName, dflt)
-}
-
-func (c *Cli) getOptBool(optName string, dflt bool) bool {
-	if val, ok := c.opts[optName].(bool); ok {
-		return val
-	}
-	return dflt
-}
-
-// expansions returns a comma-separated list of values for field expansion
-func (c *Cli) expansions() []string {
-	var expansions []string
-	if x, ok := c.opts["expand"].(string); ok {
-		expansions = strings.Split(x, ",")
-	}
-	return expansions
-}

cmd/jira/main.go

@@ -0,0 +1,54 @@
+package main
+
+import (
+	"os"
+	"path/filepath"
+	"reflect"
+
+	"github.com/coryb/figtree"
+	"github.com/coryb/oreo"
+
+	"github.com/go-jira/jira/jiracli"
+	"github.com/go-jira/jira/jiracmd"
+	"gopkg.in/coryb/yaml.v2"
+	"gopkg.in/op/go-logging.v1"
+)
+
+type oreoLogger struct {
+	logger *logging.Logger
+}
+
+var log = logging.MustGetLogger("jira")
+
+func (ol *oreoLogger) Printf(format string, args ...interface{}) {
+	ol.logger.Debugf(format, args...)
+}
+
+func main() {
+	defer jiracli.HandleExit()
+
+	jiracli.InitLogging()
+
+	configDir := ".jira.d"
+
+	yaml.UseMapType(reflect.TypeOf(map[string]interface{}{}))
+	defer yaml.RestoreMapType()
+
+	fig := figtree.NewFigTree(
+		figtree.WithHome(jiracli.Homedir()),
+		figtree.WithEnvPrefix("JIRA"),
+		figtree.WithConfigDir(configDir),
+	)
+
+	if err := os.MkdirAll(filepath.Join(jiracli.Homedir(), configDir), 0755); err != nil {
+		log.Errorf("%s", err)
+		panic(jiracli.Exit{Code: 1})
+	}
+
+	o := oreo.New().WithCookieFile(filepath.Join(jiracli.Homedir(), configDir, "cookies.js")).WithLogger(&oreoLogger{log})
+
+	jiracmd.RegisterAllCommands()
+
+	app := jiracli.CommandLine(fig, o)
+	jiracli.ParseCommandLine(app, os.Args[1:])
+}

component.go

@@ -0,0 +1,37 @@
+package jira
+
+import (
+	"bytes"
+	"encoding/json"
+
+	"github.com/go-jira/jira/jiradata"
+)
+
+type ComponentProvider interface {
+	ProvideComponent() *jiradata.Component
+}
+
+// https://docs.atlassian.com/jira/REST/cloud/#api/2/component-createComponent
+func (j *Jira) CreateComponent(cp ComponentProvider) (*jiradata.Component, error) {
+	return CreateComponent(j.UA, j.Endpoint, cp)
+}
+
+func CreateComponent(ua HttpClient, endpoint string, cp ComponentProvider) (*jiradata.Component, error) {
+	req := cp.ProvideComponent()
+	encoded, err := json.Marshal(req)
+	if err != nil {
+		return nil, err
+	}
+	uri := URLJoin(endpoint, "rest/api/2/component")
+	resp, err := ua.Post(uri, "application/json", bytes.NewBuffer(encoded))
+	if err != nil {
+		return nil, err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode == 201 {
+		results := &jiradata.Component{}
+		return results, json.NewDecoder(resp.Body).Decode(results)
+	}
+	return nil, responseError(resp)
+}

epic.go

@@ -0,0 +1,113 @@
+package jira
+
+import (
+	"bytes"
+	"encoding/json"
+	"fmt"
+	"net/url"
+	"strings"
+
+	"github.com/coryb/oreo"
+
+	"github.com/go-jira/jira/jiradata"
+)
+
+// https://docs.atlassian.com/jira-software/REST/latest/#agile/1.0/epic-getIssuesForEpic
+func (j *Jira) EpicSearch(epic string, sp SearchProvider) (*jiradata.SearchResults, error) {
+	return EpicSearch(j.UA, j.Endpoint, epic, sp)
+}
+
+func EpicSearch(ua HttpClient, endpoint string, epic string, sp SearchProvider) (*jiradata.SearchResults, error) {
+	req := sp.ProvideSearchRequest()
+	// encoded, err := json.Marshal(req)
+	// if err != nil {
+	// 	return nil, err
+	// }
+	uri, err := url.Parse(URLJoin(endpoint, "rest/agile/1.0/epic", epic, "issue"))
+	if err != nil {
+		return nil, err
+	}
+	params := url.Values{}
+	if len(req.Fields) > 0 {
+		params.Add("fields", strings.Join(req.Fields, ","))
+	}
+	if req.JQL != "" {
+		params.Add("jql", req.JQL)
+	}
+	if req.MaxResults != 0 {
+		params.Add("maxResults", fmt.Sprintf("%d", req.MaxResults))
+	}
+	if req.StartAt != 0 {
+		params.Add("startAt", fmt.Sprintf("%d", req.StartAt))
+	}
+	if req.ValidateQuery != "" {
+		params.Add("validateQuery", req.ValidateQuery)
+	}
+	uri.RawQuery = params.Encode()
+
+	resp, err := ua.Do(oreo.RequestBuilder(uri).WithHeader("Accept", "application/json").Build())
+	if err != nil {
+		return nil, err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode == 200 {
+		results := &jiradata.SearchResults{}
+		return results, json.NewDecoder(resp.Body).Decode(results)
+	}
+	return nil, responseError(resp)
+}
+
+type EpicIssuesProvider interface {
+	ProvideEpicIssues() *jiradata.EpicIssues
+}
+
+// https://docs.atlassian.com/jira-software/REST/latest/#agile/1.0/epic-moveIssuesToEpic
+func (j *Jira) EpicAddIssues(epic string, eip EpicIssuesProvider) error {
+	return EpicAddIssues(j.UA, j.Endpoint, epic, eip)
+}
+
+func EpicAddIssues(ua HttpClient, endpoint string, epic string, eip EpicIssuesProvider) error {
+	req := eip.ProvideEpicIssues()
+	encoded, err := json.Marshal(req)
+	if err != nil {
+		return err
+	}
+
+	uri := URLJoin(endpoint, "rest/agile/1.0/epic", epic, "issue")
+	resp, err := ua.Post(uri, "application/json", bytes.NewBuffer(encoded))
+	if err != nil {
+		return err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode == 204 {
+		return nil
+	}
+	return responseError(resp)
+}
+
+// https://docs.atlassian.com/jira-software/REST/latest/#agile/1.0/epic-removeIssuesFromEpic
+func (j *Jira) EpicRemoveIssues(eip EpicIssuesProvider) error {
+	return EpicRemoveIssues(j.UA, j.Endpoint, eip)
+}
+
+func EpicRemoveIssues(ua HttpClient, endpoint string, eip EpicIssuesProvider) error {
+	req := eip.ProvideEpicIssues()
+	encoded, err := json.Marshal(req)
+	if err != nil {
+		return err
+	}
+
+	uri := URLJoin(endpoint, "rest/agile/1.0/epic/none/issue")
+	resp, err := ua.Post(uri, "application/json", bytes.NewBuffer(encoded))
+	if err != nil {
+		return err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode == 204 {
+		return nil
+	}
+	return responseError(resp)
+}

error.go

@@ -0,0 +1,21 @@
+package jira
+
+import (
+	"encoding/json"
+	"net/http"
+
+	"github.com/go-jira/jira/jiradata"
+)
+
+func responseError(resp *http.Response) error {
+	results := &jiradata.ErrorCollection{}
+	if err := json.NewDecoder(resp.Body).Decode(results); err != nil {
+		results.Status = resp.StatusCode
+		results.ErrorMessages = append(results.ErrorMessages, err.Error())
+	}
+	if len(results.ErrorMessages) == 0 && len(results.Errors) == 0 {
+		results.Status = resp.StatusCode
+		results.ErrorMessages = append(results.ErrorMessages, resp.Status)
+	}
+	return results
+}

fields.go

@@ -0,0 +1,26 @@
+package jira
+
+import (
+	"encoding/json"
+
+	"github.com/go-jira/jira/jiradata"
+)
+
+// https://docs.atlassian.com/jira/REST/cloud/#api/2/field-getFields
+func (j *Jira) GetFields() ([]jiradata.Field, error) {
+	return GetFields(j.UA, j.Endpoint)
+}
+
+func GetFields(ua HttpClient, endpoint string) ([]jiradata.Field, error) {
+	uri := URLJoin(endpoint, "rest/api/2/field")
+	resp, err := ua.GetJSON(uri)
+	if err != nil {
+		return nil, err
+	}
+	defer resp.Body.Close()
+	if resp.StatusCode == 200 {
+		results := []jiradata.Field{}
+		return results, json.NewDecoder(resp.Body).Decode(&results)
+	}
+	return nil, responseError(resp)
+}

go.mod

@@ -0,0 +1,50 @@
+module github.com/go-jira/jira
+
+go 1.12
+
+require (
+	github.com/Masterminds/goutils v1.1.0 // indirect
+	github.com/Masterminds/semver v1.5.0 // indirect
+	github.com/Masterminds/sprig v2.21.0+incompatible
+	github.com/Netflix/go-expect v0.0.0-20180928190340-9d1f4485533b // indirect
+	github.com/alecthomas/template v0.0.0-20160405071501-a0175ee3bccc // indirect
+	github.com/alecthomas/units v0.0.0-20151022065526-2efee857e7cf // indirect
+	github.com/cheekybits/genny v1.0.0 // indirect
+	github.com/coryb/figtree v1.0.1-0.20190907170512-58176d03ef0d
+	github.com/coryb/kingpeon v0.0.0-20180107011214-9a669f143f2e
+	github.com/coryb/oreo v0.0.0-20180804211640-3e1b88fc08f1
+	github.com/davecgh/go-spew v1.1.0 // indirect
+	github.com/fatih/camelcase v1.0.0 // indirect
+	github.com/google/go-cmp v0.5.2
+	github.com/google/uuid v1.1.1 // indirect
+	github.com/guelfey/go.dbus v0.0.0-20131113121618-f6a3a2366cc3 // indirect
+	github.com/hinshun/vt10x v0.0.0-20180809195222-d55458df857c // indirect
+	github.com/huandu/xstrings v1.2.0 // indirect
+	github.com/imdario/mergo v0.3.7 // indirect
+	github.com/jinzhu/copier v0.0.0-20180308034124-7e38e58719c3
+	github.com/kballard/go-shellquote v0.0.0-20180428030007-95032a82bc51
+	github.com/kr/pretty v0.1.0 // indirect
+	github.com/kr/pty v1.1.4 // indirect
+	github.com/mattn/go-colorable v0.0.9 // indirect
+	github.com/mattn/go-isatty v0.0.3 // indirect
+	github.com/mgutz/ansi v0.0.0-20170206155736-9520e82c474b
+	github.com/mitchellh/go-wordwrap v1.0.1
+	github.com/olekukonko/tablewriter v0.0.3
+	github.com/pkg/browser v0.0.0-20170505125900-c90ca0c84f15
+	github.com/pkg/errors v0.8.0
+	github.com/pmezard/go-difflib v1.0.0 // indirect
+	github.com/stretchr/testify v1.2.2
+	github.com/theckman/go-flock v0.4.0 // indirect
+	github.com/tidwall/gjson v0.0.0-20180711011033-ba784d767ac7
+	github.com/tidwall/match v1.0.0 // indirect
+	github.com/tmc/keyring v0.0.0-20171121202319-839169085ae1
+	golang.org/x/crypto v0.0.0-20180723164146-c126467f60eb
+	golang.org/x/net v0.0.0-20171102191033-01c190206fbd
+	golang.org/x/sys v0.0.0-20180727230415-bd9dbc187b6e // indirect
+	gopkg.in/AlecAivazis/survey.v1 v1.6.1
+	gopkg.in/alecthomas/kingpin.v2 v2.2.6
+	gopkg.in/check.v1 v1.0.0-20180628173108-788fd7840127 // indirect
+	gopkg.in/coryb/yaml.v2 v2.0.0-20180616071044-0e40e46f7153
+	gopkg.in/op/go-logging.v1 v1.0.0-20160211212156-b2cb9fa56473
+	gopkg.in/yaml.v2 v2.2.2 // indirect
+)

go.sum

@@ -0,0 +1,96 @@
+github.com/Masterminds/goutils v1.1.0 h1:zukEsf/1JZwCMgHiK3GZftabmxiCw4apj3a28RPBiVg=
+github.com/Masterminds/goutils v1.1.0/go.mod h1:8cTjp+g8YejhMuvIA5y2vz3BpJxksy863GQaJW2MFNU=
+github.com/Masterminds/semver v1.5.0 h1:H65muMkzWKEuNDnfl9d70GUjFniHKHRbFPGBuZ3QEww=
+github.com/Masterminds/semver v1.5.0/go.mod h1:MB6lktGJrhw8PrUyiEoblNEGEQ+RzHPF078ddwwvV3Y=
+github.com/Masterminds/sprig v2.21.0+incompatible h1:nPETddHHEG1ucL7H5t5T95IuWaDe5qB9ImEaztiXgRc=
+github.com/Masterminds/sprig v2.21.0+incompatible/go.mod h1:y6hNFY5UBTIWBxnzTeuNhlNS5hqE0NB0E6fgfo2Br3o=
+github.com/Netflix/go-expect v0.0.0-20180928190340-9d1f4485533b h1:sSQK05nvxs4UkgCJaxihteu+r+6ela3dNMm7NVmsS3c=
+github.com/Netflix/go-expect v0.0.0-20180928190340-9d1f4485533b/go.mod h1:oX5x61PbNXchhh0oikYAH+4Pcfw5LKv21+Jnpr6r6Pc=
+github.com/alecthomas/template v0.0.0-20160405071501-a0175ee3bccc h1:cAKDfWh5VpdgMhJosfJnn5/FoN2SRZ4p7fJNX58YPaU=
+github.com/alecthomas/template v0.0.0-20160405071501-a0175ee3bccc/go.mod h1:LOuyumcjzFXgccqObfd/Ljyb9UuFJ6TxHnclSeseNhc=
+github.com/alecthomas/units v0.0.0-20151022065526-2efee857e7cf h1:qet1QNfXsQxTZqLG4oE62mJzwPIB8+Tee4RNCL9ulrY=
+github.com/alecthomas/units v0.0.0-20151022065526-2efee857e7cf/go.mod h1:ybxpYRFXyAe+OPACYpWeL0wqObRcbAqCMya13uyzqw0=
+github.com/cheekybits/genny v1.0.0 h1:uGGa4nei+j20rOSeDeP5Of12XVm7TGUd4dJA9RDitfE=
+github.com/cheekybits/genny v1.0.0/go.mod h1:+tQajlRqAUrPI7DOSpB0XAqZYtQakVtB7wXkRAgjxjQ=
+github.com/coryb/figtree v1.0.1-0.20190907170512-58176d03ef0d h1:99xxg8FYj+5TYg88DxA4xL8ODuI6OvuSu35WQOVPDPg=
+github.com/coryb/figtree v1.0.1-0.20190907170512-58176d03ef0d/go.mod h1:uAkZUEGm6dROpxfy+8vXLs7JrLCI4O+gQyKAuISxI/g=
+github.com/coryb/kingpeon v0.0.0-20180107011214-9a669f143f2e h1:tGmk9Tuyz7fKuBq/d3nFJvVWRvc48MEBKQC4uYV3wb0=
+github.com/coryb/kingpeon v0.0.0-20180107011214-9a669f143f2e/go.mod h1:gBc0uEH6swbOMoR7VkVuW7w5fGvZu/KHeSgxBR4Ta7Q=
+github.com/coryb/oreo v0.0.0-20180804211640-3e1b88fc08f1 h1:Hh0qSvmvoAGL8VxvEoUv9UuUf9XlKcQtSxAMTz1kqfE=
+github.com/coryb/oreo v0.0.0-20180804211640-3e1b88fc08f1/go.mod h1:l/wuS2rM8ostk0aApWje8tsZNWJPOc2TVr85B0n3e6M=
+github.com/davecgh/go-spew v1.1.0 h1:ZDRjVQ15GmhC3fiQ8ni8+OwkZQO4DARzQgrnXU1Liz8=
+github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/fatih/camelcase v1.0.0 h1:hxNvNX/xYBp0ovncs8WyWZrOrpBNub/JfaMvbURyft8=
+github.com/fatih/camelcase v1.0.0/go.mod h1:yN2Sb0lFhZJUdVvtELVWefmrXpuZESvPmqwoZc+/fpc=
+github.com/google/go-cmp v0.5.2 h1:X2ev0eStA3AbceY54o37/0PQ/UWqKEiiO2dKL5OPaFM=
+github.com/google/go-cmp v0.5.2/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE=
+github.com/google/uuid v1.1.1 h1:Gkbcsh/GbpXz7lPftLA3P6TYMwjCLYm83jiFQZF/3gY=
+github.com/google/uuid v1.1.1/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
+github.com/guelfey/go.dbus v0.0.0-20131113121618-f6a3a2366cc3 h1:fngCxKbvZdctIsWj2hYijhAt4iK0JXSSA78B36xP0yI=
+github.com/guelfey/go.dbus v0.0.0-20131113121618-f6a3a2366cc3/go.mod h1:0CNX5Cvi77WEH8llpfZ/ieuqyceb1cnO5//b5zzsnF8=
+github.com/hinshun/vt10x v0.0.0-20180809195222-d55458df857c h1:kp3AxgXgDOmIJFR7bIwqFhwJ2qWar8tEQSE5XXhCfVk=
+github.com/hinshun/vt10x v0.0.0-20180809195222-d55458df857c/go.mod h1:DqJ97dSdRW1W22yXSB90986pcOyQ7r45iio1KN2ez1A=
+github.com/huandu/xstrings v1.2.0 h1:yPeWdRnmynF7p+lLYz0H2tthW9lqhMJrQV/U7yy4wX0=
+github.com/huandu/xstrings v1.2.0/go.mod h1:DvyZB1rfVYsBIigL8HwpZgxHwXozlTgGqn63UyNX5k4=
+github.com/imdario/mergo v0.3.7 h1:Y+UAYTZ7gDEuOfhxKWy+dvb5dRQ6rJjFSdX2HZY1/gI=
+github.com/imdario/mergo v0.3.7/go.mod h1:2EnlNZ0deacrJVfApfmtdGgDfMuh/nq6Ok1EcJh5FfA=
+github.com/jinzhu/copier v0.0.0-20180308034124-7e38e58719c3 h1:sHsPfNMAG70QAvKbddQ0uScZCHQoZsT5NykGRCeeeIs=
+github.com/jinzhu/copier v0.0.0-20180308034124-7e38e58719c3/go.mod h1:yL958EeXv8Ylng6IfnvG4oflryUi3vgA3xPs9hmII1s=
+github.com/kballard/go-shellquote v0.0.0-20180428030007-95032a82bc51 h1:Z9n2FFNUXsshfwJMBgNA0RU6/i7WVaAegv3PtuIHPMs=
+github.com/kballard/go-shellquote v0.0.0-20180428030007-95032a82bc51/go.mod h1:CzGEWj7cYgsdH8dAjBGEr58BoE7ScuLd+fwFZ44+/x8=
+github.com/kr/pretty v0.1.0 h1:L/CwN0zerZDmRFUapSPitk6f+Q3+0za1rQkzVuMiMFI=
+github.com/kr/pretty v0.1.0/go.mod h1:dAy3ld7l9f0ibDNOQOHHMYYIIbhfbHSm3C4ZsoJORNo=
+github.com/kr/pty v1.1.1/go.mod h1:pFQYn66WHrOpPYNljwOMqo10TkYh1fy3cYio2l3bCsQ=
+github.com/kr/pty v1.1.4 h1:5Myjjh3JY/NaAi4IsUbHADytDyl1VE1Y9PXDlL+P/VQ=
+github.com/kr/pty v1.1.4/go.mod h1:pFQYn66WHrOpPYNljwOMqo10TkYh1fy3cYio2l3bCsQ=
+github.com/kr/text v0.1.0 h1:45sCR5RtlFHMR4UwH9sdQ5TC8v0qDQCHnXt+kaKSTVE=
+github.com/kr/text v0.1.0/go.mod h1:4Jbv+DJW3UT/LiOwJeYQe1efqtUx/iVham/4vfdArNI=
+github.com/mattn/go-colorable v0.0.9 h1:UVL0vNpWh04HeJXV0KLcaT7r06gOH2l4OW6ddYRUIY4=
+github.com/mattn/go-colorable v0.0.9/go.mod h1:9vuHe8Xs5qXnSaW/c/ABM9alt+Vo+STaOChaDxuIBZU=
+github.com/mattn/go-isatty v0.0.3 h1:ns/ykhmWi7G9O+8a448SecJU3nSMBXJfqQkl0upE1jI=
+github.com/mattn/go-isatty v0.0.3/go.mod h1:M+lRXTBqGeGNdLjl/ufCoiOlB5xdOkqRJdNxMWT7Zi4=
+github.com/mattn/go-runewidth v0.0.6 h1:V2iyH+aX9C5fsYCpK60U8BYIvmhqxuOL3JZcqc1NB7k=
+github.com/mattn/go-runewidth v0.0.6/go.mod h1:H031xJmbD/WCDINGzjvQ9THkh0rPKHF+m2gUSrubnMI=
+github.com/mgutz/ansi v0.0.0-20170206155736-9520e82c474b h1:j7+1HpAFS1zy5+Q4qx1fWh90gTKwiN4QCGoY9TWyyO4=
+github.com/mgutz/ansi v0.0.0-20170206155736-9520e82c474b/go.mod h1:01TrycV0kFyexm33Z7vhZRXopbI8J3TDReVlkTgMUxE=
+github.com/mitchellh/go-wordwrap v1.0.1 h1:TLuKupo69TCn6TQSyGxwI1EblZZEsQ0vMlAFQflz0v0=
+github.com/mitchellh/go-wordwrap v1.0.1/go.mod h1:R62XHJLzvMFRBbcrT7m7WgmE1eOyTSsCt+hzestvNj0=
+github.com/olekukonko/tablewriter v0.0.3 h1:i0LBnzgiChAWHJYTQAZJDOgf8MNxAVYZJ2m63SIDimI=
+github.com/olekukonko/tablewriter v0.0.3/go.mod h1:YZeBtGzYYEsCHp2LST/u/0NDwGkRoBtmn1cIWCJiS6M=
+github.com/pkg/browser v0.0.0-20170505125900-c90ca0c84f15 h1:mrI+6Ae64Wjt+uahGe5we/sPS1sXjvfT3YjtawAVgps=
+github.com/pkg/browser v0.0.0-20170505125900-c90ca0c84f15/go.mod h1:4OwLy04Bl9Ef3GJJCoec+30X3LQs/0/m4HFRt/2LUSA=
+github.com/pkg/errors v0.8.0 h1:WdK/asTD0HN+q6hsWO3/vpuAkAr+tw6aNJNDFFf0+qw=
+github.com/pkg/errors v0.8.0/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0=
+github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
+github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/stretchr/testify v1.2.2 h1:bSDNvY7ZPG5RlJ8otE/7V6gMiyenm9RtJ7IUVIAoJ1w=
+github.com/stretchr/testify v1.2.2/go.mod h1:a8OnRcib4nhh0OaRAV+Yts87kKdq0PP7pXfy6kDkUVs=
+github.com/theckman/go-flock v0.4.0 h1:bcqNkS4RTQBGWybG7IBimUMxnLz53Qes1+D4QaOhzJc=
+github.com/theckman/go-flock v0.4.0/go.mod h1:kjuth3y9VJ2aNlkNEO99G/8lp9fMIKaGyBmh84IBheM=
+github.com/tidwall/gjson v0.0.0-20180711011033-ba784d767ac7 h1:PW7TzL8BOpYMcUYSv4qWDoH1Y5iRzVABteynvfF7pwE=
+github.com/tidwall/gjson v0.0.0-20180711011033-ba784d767ac7/go.mod h1:c/nTNbUr0E0OrXEhq1pwa8iEgc2DOt4ZZqAt1HtCkPA=
+github.com/tidwall/match v1.0.0 h1:Ym1EcFkp+UQ4ptxfWlW+iMdq5cPH5nEuGzdf/Pb7VmI=
+github.com/tidwall/match v1.0.0/go.mod h1:LujAq0jyVjBy028G1WhWfIzbpQfMO8bBZ6Tyb0+pL9E=
+github.com/tmc/keyring v0.0.0-20171121202319-839169085ae1 h1:+gXfyhy0t28Guz+vFztBg45yIquB2bNtiFvbItzJtUc=
+github.com/tmc/keyring v0.0.0-20171121202319-839169085ae1/go.mod h1:gsa3jftQ3xia55nzIN4lXLYzDcWdxjojdKoz+N0St2Y=
+golang.org/x/crypto v0.0.0-20180723164146-c126467f60eb h1:Ah9YqXLj6fEgeKqcmBuLCbAsrF3ScD7dJ/bYM0C6tXI=
+golang.org/x/crypto v0.0.0-20180723164146-c126467f60eb/go.mod h1:6SG95UA2DQfeDnfUPMdvaQW0Q7yPrPDi9nlGo2tz2b4=
+golang.org/x/net v0.0.0-20171102191033-01c190206fbd h1:CLQSRrSDQMOMkogMxky7XOkERftMegAnxjT2re4E66M=
+golang.org/x/net v0.0.0-20171102191033-01c190206fbd/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4=
+golang.org/x/sys v0.0.0-20180727230415-bd9dbc187b6e h1:3dQ4fR8k5KugjVKO0oqSd1odxuk2yaE2CIfxWP2WarQ=
+golang.org/x/sys v0.0.0-20180727230415-bd9dbc187b6e/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
+golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543 h1:E7g+9GITq07hpfrRu66IVDexMakfv52eLZ2CXBWiKr4=
+golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
+gopkg.in/AlecAivazis/survey.v1 v1.6.1 h1:HyWkjKGBpzhNxrpaKRLDqoa4L1f4cMVBNU4bnVmU8Mw=
+gopkg.in/AlecAivazis/survey.v1 v1.6.1/go.mod h1:2Ehl7OqkBl3Xb8VmC4oFW2bItAhnUfzIjrOzwRxCrOU=
+gopkg.in/alecthomas/kingpin.v2 v2.2.6 h1:jMFz6MfLP0/4fUyZle81rXUoxOBFi19VUFKVDOQfozc=
+gopkg.in/alecthomas/kingpin.v2 v2.2.6/go.mod h1:FMv+mEhP44yOT+4EoQTLFTRgOQ1FBLkstjWtayDeSgw=
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
+gopkg.in/check.v1 v1.0.0-20180628173108-788fd7840127 h1:qIbj1fsPNlZgppZ+VLlY7N33q108Sa+fhmuc+sWQYwY=
+gopkg.in/check.v1 v1.0.0-20180628173108-788fd7840127/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
+gopkg.in/coryb/yaml.v2 v2.0.0-20180616071044-0e40e46f7153 h1:3KfEubBNUdXqlEXuMz13dXy4cYK2AvuPhp8fKTYuPdU=
+gopkg.in/coryb/yaml.v2 v2.0.0-20180616071044-0e40e46f7153/go.mod h1:Vth2iKfSejHZ3p6akgWO0iSjuuiu6mNCEgzcYUCnumw=
+gopkg.in/op/go-logging.v1 v1.0.0-20160211212156-b2cb9fa56473 h1:6D+BvnJ/j6e222UW8s2qTSe3wGBtvo0MbVQG/c5k8RE=
+gopkg.in/op/go-logging.v1 v1.0.0-20160211212156-b2cb9fa56473/go.mod h1:N1eN2tsCx0Ydtgjl4cqmbRCsY4/+z4cYDeqwZTk6zog=
+gopkg.in/yaml.v2 v2.2.2 h1:ZCJp+EgiOT7lHqUV2J862kp8Qj64Jo6az82+3Td9dZw=
+gopkg.in/yaml.v2 v2.2.2/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=

httpClient.go

@@ -0,0 +1,14 @@
+package jira
+
+import (
+	"io"
+	"net/http"
+)
+
+type HttpClient interface {
+	Delete(url string) (*http.Response, error)
+	Do(*http.Request) (*http.Response, error)
+	GetJSON(url string) (*http.Response, error)
+	Post(url, bodyType string, body io.Reader) (*http.Response, error)
+	Put(url, bodyType string, body io.Reader) (*http.Response, error)
+}

issue.go

@@ -0,0 +1,648 @@
+package jira
+
+import (
+	"bytes"
+	"encoding/json"
+	"fmt"
+	"io"
+	"mime/multipart"
+	"net/url"
+	"strings"
+
+	"github.com/coryb/oreo"
+
+	"github.com/go-jira/jira/jiradata"
+)
+
+type IssueQueryProvider interface {
+	ProvideIssueQueryString() string
+}
+
+type IssueOptions struct {
+	Fields        []string `json:"fields,omitempty" yaml:"fields,omitempty"`
+	Expand        []string `json:"expand,omitempty" yaml:"expand,omitempty"`
+	Properties    []string `json:"properties,omitempty" yaml:"properties,omitempty"`
+	FieldsByKeys  bool     `json:"fieldsByKeys,omitempty" yaml:"fieldsByKeys,omitempty"`
+	UpdateHistory bool     `json:"updateHistory,omitempty" yaml:"updateHistory,omitempty"`
+}
+
+func (o *IssueOptions) ProvideIssueQueryString() string {
+	params := []string{}
+	if len(o.Fields) > 0 {
+		params = append(params, "fields="+strings.Join(o.Fields, ","))
+	}
+	if len(o.Expand) > 0 {
+		params = append(params, "expand="+strings.Join(o.Expand, ","))
+	}
+	if len(o.Properties) > 0 {
+		params = append(params, "properties="+strings.Join(o.Properties, ","))
+	}
+	if o.FieldsByKeys {
+		params = append(params, "fieldsByKeys=true")
+	}
+	if o.UpdateHistory {
+		params = append(params, "updateHistory=true")
+	}
+	if len(params) > 0 {
+		return "?" + strings.Join(params, "&")
+	}
+	return ""
+}
+
+// https://docs.atlassian.com/jira/REST/cloud/#api/2/issue-getIssue
+func (j *Jira) GetIssue(issue string, iqg IssueQueryProvider) (*jiradata.Issue, error) {
+	return GetIssue(j.UA, j.Endpoint, issue, iqg)
+}
+
+func GetIssue(ua HttpClient, endpoint string, issue string, iqg IssueQueryProvider) (*jiradata.Issue, error) {
+	query := ""
+	if iqg != nil {
+		query = iqg.ProvideIssueQueryString()
+	}
+	uri := URLJoin(endpoint, "rest/api/2/issue", issue)
+	uri += query
+	resp, err := ua.GetJSON(uri)
+	if err != nil {
+		return nil, err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode == 200 {
+		results := &jiradata.Issue{}
+		return results, json.NewDecoder(resp.Body).Decode(results)
+	}
+	return nil, responseError(resp)
+}
+
+func (j *Jira) GetIssueWorklog(issue string) (*jiradata.Worklogs, error) {
+	return GetIssueWorklog(j.UA, j.Endpoint, issue)
+}
+
+// https://docs.atlassian.com/jira/REST/cloud/#api/2/issue/{issueIdOrKey}/worklog-getIssueWorklog
+func GetIssueWorklog(ua HttpClient, endpoint string, issue string) (*jiradata.Worklogs, error) {
+	startAt := 0
+	total := 1
+	maxResults := 100
+	worklogs := jiradata.Worklogs{}
+	for startAt < total {
+		uri := URLJoin(endpoint, "rest/api/2/issue", issue, "worklog")
+		uri += fmt.Sprintf("?startAt=%d&maxResults=%d", startAt, maxResults)
+		resp, err := ua.GetJSON(uri)
+		if err != nil {
+			return nil, err
+		}
+		defer resp.Body.Close()
+
+		if resp.StatusCode == 200 {
+			results := &jiradata.WorklogWithPagination{}
+			err := json.NewDecoder(resp.Body).Decode(results)
+			if err != nil {
+				return nil, err
+			}
+			startAt = startAt + maxResults
+			total = results.Total
+			worklogs = append(worklogs, results.Worklogs...)
+		} else {
+			return nil, responseError(resp)
+		}
+	}
+	return &worklogs, nil
+}
+
+func (j *Jira) GetIssueComment(issue string) (*jiradata.Comments, error) {
+	return GetIssueComment(j.UA, j.Endpoint, issue)
+}
+
+// https://docs.atlassian.com/software/jira/docs/api/REST/7.12.0/#api/2/issue-getComments
+func GetIssueComment(ua HttpClient, endpoint string, issue string) (*jiradata.Comments, error) {
+	startAt := 0
+	total := 1
+	maxResults := 100
+	comments := jiradata.Comments{}
+	for startAt < total {
+		uri := URLJoin(endpoint, "rest/api/2/issue", issue, "comment")
+		uri += fmt.Sprintf("?startAt=%d&maxResults=%d", startAt, maxResults)
+		resp, err := ua.GetJSON(uri)
+		if err != nil {
+			return nil, err
+		}
+		defer resp.Body.Close()
+
+		if resp.StatusCode == 200 {
+			results := &jiradata.CommentsWithPagination{}
+			err := json.NewDecoder(resp.Body).Decode(results)
+			if err != nil {
+				return nil, err
+			}
+			startAt = startAt + maxResults
+			total = results.Total
+			comments = append(comments, results.Comments...)
+		} else {
+			return nil, responseError(resp)
+		}
+	}
+	return &comments, nil
+}
+
+type WorklogProvider interface {
+	ProvideWorklog() *jiradata.Worklog
+}
+
+// https://docs.atlassian.com/jira/REST/cloud/#api/2/issue/{issueIdOrKey}/worklog-addWorklog
+func (j *Jira) AddIssueWorklog(issue string, wp WorklogProvider) (*jiradata.Worklog, error) {
+	return AddIssueWorklog(j.UA, j.Endpoint, issue, wp)
+}
+
+func AddIssueWorklog(ua HttpClient, endpoint string, issue string, wp WorklogProvider) (*jiradata.Worklog, error) {
+	req := wp.ProvideWorklog()
+	encoded, err := json.Marshal(req)
+	if err != nil {
+		return nil, err
+	}
+	uri := URLJoin(endpoint, "rest/api/2/issue", issue, "worklog")
+	resp, err := ua.Post(uri, "application/json", bytes.NewBuffer(encoded))
+	if err != nil {
+		return nil, err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode == 201 {
+		results := &jiradata.Worklog{}
+		return results, json.NewDecoder(resp.Body).Decode(results)
+	}
+	return nil, responseError(resp)
+}
+
+// https://docs.atlassian.com/jira/REST/cloud/#api/2/issue-getEditIssueMeta
+func (j *Jira) GetIssueEditMeta(issue string) (*jiradata.EditMeta, error) {
+	return GetIssueEditMeta(j.UA, j.Endpoint, issue)
+}
+
+func GetIssueEditMeta(ua HttpClient, endpoint string, issue string) (*jiradata.EditMeta, error) {
+	uri := URLJoin(endpoint, "rest/api/2/issue", issue, "editmeta")
+	resp, err := ua.GetJSON(uri)
+	if err != nil {
+		return nil, err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode == 200 {
+		results := &jiradata.EditMeta{}
+		return results, json.NewDecoder(resp.Body).Decode(results)
+	}
+	return nil, responseError(resp)
+}
+
+type IssueUpdateProvider interface {
+	ProvideIssueUpdate() *jiradata.IssueUpdate
+}
+
+// https://docs.atlassian.com/jira/REST/cloud/#api/2/issue-editIssue
+func (j *Jira) EditIssue(issue string, iup IssueUpdateProvider) error {
+	return EditIssue(j.UA, j.Endpoint, issue, iup)
+}
+
+func EditIssue(ua HttpClient, endpoint string, issue string, iup IssueUpdateProvider) error {
+	req := iup.ProvideIssueUpdate()
+	encoded, err := json.Marshal(req)
+	if err != nil {
+		return err
+	}
+	uri := URLJoin(endpoint, "rest/api/2/issue", issue)
+	resp, err := ua.Put(uri, "application/json", bytes.NewBuffer(encoded))
+	if err != nil {
+		return err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode == 204 {
+		return nil
+	}
+	return responseError(resp)
+}
+
+// https://docs.atlassian.com/jira/REST/cloud/#api/2/issue-createIssue
+func (j *Jira) CreateIssue(iup IssueUpdateProvider) (*jiradata.IssueCreateResponse, error) {
+	return CreateIssue(j.UA, j.Endpoint, iup)
+}
+
+func CreateIssue(ua HttpClient, endpoint string, iup IssueUpdateProvider) (*jiradata.IssueCreateResponse, error) {
+	req := iup.ProvideIssueUpdate()
+	encoded, err := json.Marshal(req)
+	if err != nil {
+		return nil, err
+	}
+	uri := URLJoin(endpoint, "rest/api/2/issue")
+	resp, err := ua.Post(uri, "application/json", bytes.NewBuffer(encoded))
+	if err != nil {
+		return nil, err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode == 201 {
+		results := &jiradata.IssueCreateResponse{}
+		return results, json.NewDecoder(resp.Body).Decode(results)
+	}
+	return nil, responseError(resp)
+}
+
+// https://docs.atlassian.com/jira/REST/cloud/#api/2/issue-getCreateIssueMeta
+func (j *Jira) GetIssueCreateMetaProject(projectKey string) (*jiradata.CreateMetaProject, error) {
+	return GetIssueCreateMetaProject(j.UA, j.Endpoint, projectKey)
+}
+
+func GetIssueCreateMetaProject(ua HttpClient, endpoint string, projectKey string) (*jiradata.CreateMetaProject, error) {
+	uri := URLJoin(endpoint, "rest/api/2/issue/createmeta")
+	uri += fmt.Sprintf("?projectKeys=%s&expand=projects.issuetypes.fields", projectKey)
+	resp, err := ua.GetJSON(uri)
+	if err != nil {
+		return nil, err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode == 200 {
+		results := &jiradata.CreateMeta{}
+		err = json.NewDecoder(resp.Body).Decode(results)
+		if err != nil {
+			return nil, err
+		}
+		for _, project := range results.Projects {
+			if project.Key == projectKey {
+				return project, nil
+			}
+		}
+		return nil, fmt.Errorf("project %s not found", projectKey)
+	}
+	return nil, responseError(resp)
+}
+
+// https://docs.atlassian.com/jira/REST/cloud/#api/2/issue-getCreateIssueMeta
+func (j *Jira) GetIssueCreateMetaIssueType(projectKey, issueTypeName string) (*jiradata.IssueType, error) {
+	return GetIssueCreateMetaIssueType(j.UA, j.Endpoint, projectKey, issueTypeName)
+}
+
+func GetIssueCreateMetaIssueType(ua HttpClient, endpoint string, projectKey, issueTypeName string) (*jiradata.IssueType, error) {
+	uri := URLJoin(endpoint, "rest/api/2/issue/createmeta")
+	uri += fmt.Sprintf("?projectKeys=%s&issuetypeNames=%s&expand=projects.issuetypes.fields", projectKey, url.QueryEscape(issueTypeName))
+	resp, err := ua.GetJSON(uri)
+	if err != nil {
+		return nil, err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode != 200 {
+		return nil, responseError(resp)
+	}
+	results := &jiradata.CreateMeta{}
+	if err := json.NewDecoder(resp.Body).Decode(results); err != nil {
+		return nil, err
+	}
+	for _, project := range results.Projects {
+		if project.Key != projectKey {
+			continue
+		}
+		for _, issueType := range project.IssueTypes {
+			if issueType.Name == issueTypeName {
+				return issueType, nil
+			}
+		}
+	}
+	return nil, fmt.Errorf("project %s and IssueType %s not found", projectKey, issueTypeName)
+}
+
+type LinkIssueProvider interface {
+	ProvideLinkIssueRequest() *jiradata.LinkIssueRequest
+}
+
+// https://docs.atlassian.com/jira/REST/cloud/#api/2/issueLink-linkIssues
+func (j *Jira) LinkIssues(lip LinkIssueProvider) error {
+	return LinkIssues(j.UA, j.Endpoint, lip)
+}
+
+func LinkIssues(ua HttpClient, endpoint string, lip LinkIssueProvider) error {
+	req := lip.ProvideLinkIssueRequest()
+	encoded, err := json.Marshal(req)
+	if err != nil {
+		return err
+	}
+	uri := URLJoin(endpoint, "rest/api/2/issueLink")
+	resp, err := ua.Post(uri, "application/json", bytes.NewBuffer(encoded))
+	if err != nil {
+		return err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode == 201 {
+		return nil
+	}
+	return responseError(resp)
+}
+
+// https://docs.atlassian.com/jira/REST/cloud/#api/2/issue-getTransitions
+func (j *Jira) GetIssueTransitions(issue string) (*jiradata.TransitionsMeta, error) {
+	return GetIssueTransitions(j.UA, j.Endpoint, issue)
+}
+
+func GetIssueTransitions(ua HttpClient, endpoint string, issue string) (*jiradata.TransitionsMeta, error) {
+	uri := URLJoin(endpoint, "rest/api/2/issue", issue, "transitions")
+	uri += "?expand=transitions.fields"
+	resp, err := ua.GetJSON(uri)
+	if err != nil {
+		return nil, err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode == 200 {
+		results := &jiradata.TransitionsMeta{}
+		return results, json.NewDecoder(resp.Body).Decode(results)
+	}
+	return nil, responseError(resp)
+}
+
+// https://docs.atlassian.com/jira/REST/cloud/#api/2/issue-doTransition
+func (j *Jira) TransitionIssue(issue string, iup IssueUpdateProvider) error {
+	return TransitionIssue(j.UA, j.Endpoint, issue, iup)
+}
+
+func TransitionIssue(ua HttpClient, endpoint string, issue string, iup IssueUpdateProvider) error {
+	req := iup.ProvideIssueUpdate()
+	encoded, err := json.Marshal(req)
+	if err != nil {
+		return err
+	}
+	uri := URLJoin(endpoint, "rest/api/2/issue", issue, "transitions")
+	resp, err := ua.Post(uri, "application/json", bytes.NewBuffer(encoded))
+	if err != nil {
+		return err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode == 204 {
+		return nil
+	}
+	return responseError(resp)
+}
+
+// https://docs.atlassian.com/jira/REST/cloud/#api/2/issueLinkType-getIssueLinkTypes
+func (j *Jira) GetIssueLinkTypes() (*jiradata.IssueLinkTypes, error) {
+	return GetIssueLinkTypes(j.UA, j.Endpoint)
+}
+
+func GetIssueLinkTypes(ua HttpClient, endpoint string) (*jiradata.IssueLinkTypes, error) {
+	uri := URLJoin(endpoint, "rest/api/2/issueLinkType")
+	resp, err := ua.GetJSON(uri)
+	if err != nil {
+		return nil, err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode == 200 {
+		results := struct {
+			IssueLinkTypes jiradata.IssueLinkTypes
+		}{
+			IssueLinkTypes: jiradata.IssueLinkTypes{},
+		}
+		return &results.IssueLinkTypes, json.NewDecoder(resp.Body).Decode(&results)
+	}
+	return nil, responseError(resp)
+}
+
+// https://docs.atlassian.com/jira/REST/cloud/#api/2/issue-addVote
+func (j *Jira) IssueAddVote(issue string) error {
+	return IssueAddVote(j.UA, j.Endpoint, issue)
+}
+
+func IssueAddVote(ua HttpClient, endpoint string, issue string) error {
+	uri := URLJoin(endpoint, "rest/api/2/issue", issue, "votes")
+	resp, err := ua.Post(uri, "application/json", strings.NewReader("{}"))
+	if err != nil {
+		return err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode == 204 {
+		return nil
+	}
+	return responseError(resp)
+}
+
+// https://docs.atlassian.com/jira/REST/cloud/#api/2/issue-removeVote
+func (j *Jira) IssueRemoveVote(issue string) error {
+	return IssueRemoveVote(j.UA, j.Endpoint, issue)
+}
+
+func IssueRemoveVote(ua HttpClient, endpoint string, issue string) error {
+	uri := URLJoin(endpoint, "rest/api/2/issue", issue, "votes")
+	resp, err := ua.Delete(uri)
+	if err != nil {
+		return err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode == 204 {
+		return nil
+	}
+	return responseError(resp)
+}
+
+type RankRequestProvider interface {
+	ProvideRankRequest() *jiradata.RankRequest
+}
+
+// https://docs.atlassian.com/jira-software/REST/cloud/#agile/1.0/issue-rankIssues
+func (j *Jira) RankIssues(rrp RankRequestProvider) error {
+	return RankIssues(j.UA, j.Endpoint, rrp)
+}
+
+func RankIssues(ua HttpClient, endpoint string, rrp RankRequestProvider) error {
+	req := rrp.ProvideRankRequest()
+	encoded, err := json.Marshal(req)
+	if err != nil {
+		return err
+	}
+	uri := URLJoin(endpoint, "rest/agile/1.0/issue/rank")
+	resp, err := ua.Put(uri, "application/json", bytes.NewBuffer(encoded))
+	if err != nil {
+		return err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode == 204 {
+		return nil
+	}
+	return responseError(resp)
+}
+
+// https://docs.atlassian.com/jira/REST/cloud/#api/2/issue-addWatcher
+func (j *Jira) IssueAddWatcher(issue, user string) error {
+	return IssueAddWatcher(j.UA, j.Endpoint, issue, user)
+}
+
+func IssueAddWatcher(ua HttpClient, endpoint string, issue, user string) error {
+	uri := URLJoin(endpoint, "rest/api/2/issue", issue, "watchers")
+	resp, err := ua.Post(uri, "application/json", strings.NewReader(fmt.Sprintf("%q", user)))
+	if err != nil {
+		return err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode == 204 {
+		return nil
+	}
+	return responseError(resp)
+}
+
+// https://docs.atlassian.com/jira/REST/cloud/#api/2/issue-addWatcher
+func (j *Jira) IssueRemoveWatcher(issue, user string) error {
+	return IssueRemoveWatcher(j.UA, j.Endpoint, issue, user)
+}
+
+func IssueRemoveWatcher(ua HttpClient, endpoint string, issue, user string) error {
+	uri := URLJoin(endpoint, "rest/api/2/issue", issue, "watchers")
+	uri += fmt.Sprintf("?accountId=%s", user)
+	resp, err := ua.Delete(uri)
+	if err != nil {
+		return err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode == 204 {
+		return nil
+	}
+	return responseError(resp)
+}
+
+type CommentProvider interface {
+	ProvideComment() *jiradata.Comment
+}
+
+// https://docs.atlassian.com/jira/REST/cloud/#api/2/issue/{issueIdOrKey}/comment-addComment
+func (j *Jira) IssueAddComment(issue string, cp CommentProvider) (*jiradata.Comment, error) {
+	return IssueAddComment(j.UA, j.Endpoint, issue, cp)
+}
+
+func IssueAddComment(ua HttpClient, endpoint string, issue string, cp CommentProvider) (*jiradata.Comment, error) {
+	req := cp.ProvideComment()
+	encoded, err := json.Marshal(req)
+	if err != nil {
+		return nil, err
+	}
+	uri := URLJoin(endpoint, "rest/api/2/issue", issue, "comment")
+	resp, err := ua.Post(uri, "application/json", bytes.NewBuffer(encoded))
+	if err != nil {
+		return nil, err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode == 201 {
+		results := jiradata.Comment{}
+		return &results, json.NewDecoder(resp.Body).Decode(&results)
+	}
+	return nil, responseError(resp)
+}
+
+type UserProvider interface {
+	ProvideUser() *jiradata.User
+}
+
+// https://docs.atlassian.com/jira/REST/cloud/#api/2/issue-assign
+func (j *Jira) IssueAssign(issue, name string) error {
+	return IssueAssign(j.UA, j.Endpoint, issue, name)
+}
+
+func IssueAssign(ua HttpClient, endpoint string, issue, name string) error {
+	// this is special, not using the jiradata.User structure
+	// because we need to be able to send `null` as the name param
+	// when we want to un-assign the issue
+	req := struct {
+		Name *string `json:"name"`
+	}{&name}
+	if name == "" {
+		req.Name = nil
+	}
+
+	encoded, err := json.Marshal(req)
+	if err != nil {
+		return err
+	}
+	uri := URLJoin(endpoint, "rest/api/2/issue", issue, "assignee")
+	resp, err := ua.Put(uri, "application/json", bytes.NewBuffer(encoded))
+	if err != nil {
+		return err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode == 204 {
+		return nil
+	}
+	return responseError(resp)
+}
+
+func IssueAssignAccountID(ua HttpClient, endpoint string, issue, acctId string) error {
+	// this is special, not using the jiradata.User structure
+	// because we need to be able to send `null` as the name param
+	// when we want to un-assign the issue
+	req := struct {
+		AccountID *string `json:"accountId"`
+	}{&acctId}
+	if acctId == "" {
+		req.AccountID = nil
+	}
+
+	encoded, err := json.Marshal(req)
+	if err != nil {
+		return err
+	}
+	uri := URLJoin(endpoint, "rest/api/2/issue", issue, "assignee")
+	resp, err := ua.Put(uri, "application/json", bytes.NewBuffer(encoded))
+	if err != nil {
+		return err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode == 204 {
+		return nil
+	}
+	return responseError(resp)
+}
+
+// https://docs.atlassian.com/jira/REST/cloud/#api/2/issue/{issueIdOrKey}/attachments-addAttachment
+func (j *Jira) IssueAttachFile(issue, filename string, contents io.Reader) (*jiradata.ListOfAttachment, error) {
+	return IssueAttachFile(j.UA, j.Endpoint, issue, filename, contents)
+}
+
+func IssueAttachFile(ua HttpClient, endpoint string, issue, filename string, contents io.Reader) (*jiradata.ListOfAttachment, error) {
+	var buf bytes.Buffer
+	w := multipart.NewWriter(&buf)
+	formFile, err := w.CreateFormFile("file", filename)
+	if err != nil {
+		return nil, err
+	}
+	_, err = io.Copy(formFile, contents)
+	if err != nil {
+		return nil, err
+	}
+
+	uri, err := url.Parse(URLJoin(endpoint, "rest/api/2/issue", issue, "attachments"))
+	if err != nil {
+		return nil, err
+	}
+	req := oreo.RequestBuilder(uri).WithMethod("POST").WithHeader(
+		"X-Atlassian-Token", "no-check",
+	).WithHeader(
+		"Accept", "application/json",
+	).WithContentType(w.FormDataContentType()).WithBody(&buf).Build()
+	w.Close()
+
+	resp, err := ua.Do(req)
+	if err != nil {
+		return nil, err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode == 200 {
+		results := jiradata.ListOfAttachment{}
+		return &results, json.NewDecoder(resp.Body).Decode(&results)
+	}
+	return nil, responseError(resp)
+}

jira.go

@@ -0,0 +1,20 @@
+package jira
+
+import (
+	"github.com/coryb/oreo"
+)
+
+// replace by ldflags
+var VERSION = "development"
+
+type Jira struct {
+	Endpoint string     `json:"endpoint,omitempty" yaml:"endpoint,omitempty"`
+	UA       HttpClient `json:"-" yaml:"-"`
+}
+
+func NewJira(endpoint string) *Jira {
+	return &Jira{
+		Endpoint: endpoint,
+		UA:       oreo.New(),
+	}
+}

jiracli/cli.go

@@ -0,0 +1,590 @@
+package jiracli
+
+import (
+	"bytes"
+	"crypto/tls"
+	"encoding/base64"
+	"fmt"
+	"io"
+	"io/ioutil"
+	"net/http"
+	"os"
+	"os/exec"
+	"reflect"
+	"runtime/debug"
+	"strconv"
+	"strings"
+
+	"github.com/coryb/figtree"
+	"github.com/coryb/oreo"
+	"github.com/jinzhu/copier"
+	shellquote "github.com/kballard/go-shellquote"
+	"github.com/tidwall/gjson"
+	"gopkg.in/AlecAivazis/survey.v1"
+	kingpin "gopkg.in/alecthomas/kingpin.v2"
+	yaml "gopkg.in/coryb/yaml.v2"
+	logging "gopkg.in/op/go-logging.v1"
+)
+
+type Exit struct {
+	Code int
+}
+
+// HandleExit will unwind any panics and check to see if they are jiracli.Exit
+// and exit accordingly.
+//
+// Example:
+// func main() {
+//     defer jiracli.HandleExit()
+//     ...
+// }
+func HandleExit() {
+	if e := recover(); e != nil {
+		if exit, ok := e.(Exit); ok {
+			os.Exit(exit.Code)
+		} else {
+			fmt.Fprintf(os.Stderr, "%s\n%s", e, debug.Stack())
+			os.Exit(1)
+		}
+	}
+}
+
+const (
+	ServerDeploymentType = "server"
+	CloudDeploymentType  = "cloud"
+)
+
+type GlobalOptions struct {
+	// AuthenticationMethod is the method we use to authenticate with the jira serivce.
+	// Possible values are "api-token", "bearer-token" or "session".
+	// The default is "api-token" when the service endpoint ends with "atlassian.net", otherwise it "session".  Session authentication
+	// will promt for user password and use the /auth/1/session-login endpoint.
+	AuthenticationMethod figtree.StringOption `yaml:"authentication-method,omitempty" json:"authentication-method,omitempty"`
+
+	// Endpoint is the URL for the Jira service.  Something like: https://go-jira.atlassian.net
+	Endpoint figtree.StringOption `yaml:"endpoint,omitempty" json:"endpoint,omitempty"`
+
+	// Insecure will allow you to connect to an https endpoint with a self-signed SSL certificate
+	Insecure figtree.BoolOption `yaml:"insecure,omitempty" json:"insecure,omitempty"`
+
+	// Login is the id used for authenticating with the Jira service.  For "api-token" AuthenticationMethod this is usually a
+	// full email address, something like "user@example.com".  For "session" AuthenticationMethod this will be something
+	// like "user", which by default will use the same value in the `User` field.
+	Login figtree.StringOption `yaml:"login,omitempty" json:"login,omitempty"`
+
+	// PasswordSource specificies the method that we fetch the password.  Possible values are "keyring" or "pass".
+	// If this is unset we will just prompt the user.  For "keyring" this will look in the OS keychain, if missing
+	// then prompt the user and store the password in the OS keychain.  For "pass" this will look in the PasswordDirectory
+	// location using the `pass` tool, if missing prompt the user and store in the PasswordDirectory
+	PasswordSource figtree.StringOption `yaml:"password-source,omitempty" json:"password-source,omitempty"`
+
+	// PasswordSourcePath can be used to specify the path to the PasswordSource binary to use.
+	PasswordSourcePath figtree.StringOption `yaml:"password-source-path,omitempty" json:"password-source-path,omitempty"`
+
+	// Cached password to avoid invoking password source on each API request
+	cachedPassword string
+
+	// PasswordDirectory is only used for the "pass" PasswordSource.  It is the location for the encrypted password
+	// files used by `pass`.  Effectively this overrides the "PASSWORD_STORE_DIR" environment variable
+	PasswordDirectory figtree.StringOption `yaml:"password-directory,omitempty" json:"password-directory,omitempty"`
+
+	// PasswordName is the the name of the password key entry stored used with PasswordSource `pass`.
+	PasswordName figtree.StringOption `yaml:"password-name,omitempty" json:"password-name,omitempty"`
+
+	// Quiet will lower the defalt log level to suppress the standard output for commands
+	Quiet figtree.BoolOption `yaml:"quiet,omitempty" json:"quiet,omitempty"`
+
+	// SocksProxy is used to configure the http client to access the Endpoint via a socks proxy.  The value
+	// should be a ip address and port string, something like "127.0.0.1:1080"
+	SocksProxy figtree.StringOption `yaml:"socksproxy,omitempty" json:"socksproxy,omitempty"`
+
+	// UnixProxy is use to configure the http client to access the Endpoint via a local unix domain socket used
+	// to proxy requests
+	UnixProxy figtree.StringOption `yaml:"unixproxy,omitempty" json:"unixproxy,omitempty"`
+
+	// User is use to represent the user on the Jira service.  This can be different from the username used to
+	// authenticate with the service.  For example when using AuthenticationMethod `api-token` the Login is
+	// typically an email address like `username@example.com` and the User property would be someting like
+	// `username`  The User property is used on Jira service API calls that require a user to associate with
+	// an Issue (like assigning a Issue to yourself)
+	User figtree.StringOption `yaml:"user,omitempty" json:"user,omitempty"`
+
+	// JiraDeploymentType can be `cloud` or `server`, if not set it will be inferred from
+	// the /rest/api/2/serverInfo REST API.
+	JiraDeploymentType figtree.StringOption `yaml:"jira-deployment-type,omitempty" json:"jira-deployment-type,omitempty"`
+}
+
+type CommonOptions struct {
+	Browse      figtree.BoolOption   `yaml:"browse,omitempty" json:"browse,omitempty"`
+	Editor      figtree.StringOption `yaml:"editor,omitempty" json:"editor,omitempty"`
+	File        figtree.StringOption `yaml:"file,omitempty" json:"file,omitempty"`
+	GJsonQuery  figtree.StringOption `yaml:"gjq,omitempty" json:"gjq,omitempty"`
+	SkipEditing figtree.BoolOption   `yaml:"noedit,omitempty" json:"noedit,omitempty"`
+	Template    figtree.StringOption `yaml:"template,omitempty" json:"template,omitempty"`
+}
+
+type CommandRegistryEntry struct {
+	Help        string
+	UsageFunc   func(*figtree.FigTree, *kingpin.CmdClause) error
+	ExecuteFunc func(*oreo.Client, *GlobalOptions) error
+}
+
+type CommandRegistry struct {
+	Command string
+	Aliases []string
+	Entry   *CommandRegistryEntry
+	Default bool
+}
+
+// either kingpin.Application or kingpin.CmdClause fit this interface
+type kingpinAppOrCommand interface {
+	Command(string, string) *kingpin.CmdClause
+	GetCommand(string) *kingpin.CmdClause
+}
+
+var globalCommandRegistry = []CommandRegistry{}
+
+func RegisterCommand(regEntry CommandRegistry) {
+	globalCommandRegistry = append(globalCommandRegistry, regEntry)
+}
+
+func (o *GlobalOptions) AuthMethod() string {
+	if strings.Contains(o.Endpoint.Value, ".atlassian.net") && o.AuthenticationMethod.Source == "default" {
+		return "api-token"
+	}
+	return o.AuthenticationMethod.Value
+}
+
+func (o *GlobalOptions) AuthMethodIsToken() bool{
+	return o.AuthMethod() == "api-token" || o.AuthMethod() == "bearer-token";
+}
+
+func register(app *kingpin.Application, o *oreo.Client, fig *figtree.FigTree) {
+	globals := GlobalOptions{
+		User:                 figtree.NewStringOption(os.Getenv("USER")),
+		AuthenticationMethod: figtree.NewStringOption("session"),
+	}
+	app.Flag("endpoint", "Base URI to use for Jira").Short('e').SetValue(&globals.Endpoint)
+	app.Flag("insecure", "Disable TLS certificate verification").Short('k').SetValue(&globals.Insecure)
+	app.Flag("quiet", "Suppress output to console").Short('Q').SetValue(&globals.Quiet)
+	app.Flag("unixproxy", "Path for a unix-socket proxy").SetValue(&globals.UnixProxy)
+	app.Flag("socksproxy", "Address for a socks proxy").SetValue(&globals.SocksProxy)
+	app.Flag("user", "user name used within the Jira service").Short('u').SetValue(&globals.User)
+	app.Flag("login", "login name that corresponds to the user used for authentication").SetValue(&globals.Login)
+
+	o = o.WithPreCallback(func(req *http.Request) (*http.Request, error) {
+		if globals.AuthMethod() == "api-token" {
+			// need to set basic auth header with user@domain:api-token
+			token := globals.GetPass()
+			authHeader := fmt.Sprintf("Basic %s", base64.StdEncoding.EncodeToString([]byte(fmt.Sprintf("%s:%s", globals.Login.Value, token))))
+			req.Header.Add("Authorization", authHeader)
+		} else if globals.AuthMethod() == "bearer-token" {
+			token := globals.GetPass()
+			authHeader := fmt.Sprintf("Bearer %s", token)
+			req.Header.Add("Authorization", authHeader)
+		}
+		return req, nil
+	})
+
+	o = o.WithPostCallback(func(req *http.Request, resp *http.Response) (*http.Response, error) {
+		if globals.AuthMethod() == "session" {
+			authUser := resp.Header.Get("X-Ausername")
+			if authUser == "" || authUser == "anonymous" {
+				// preserve the --quiet value, we need to temporarily disable it so
+				// the normal login output is surpressed
+				defer func(quiet bool) {
+					globals.Quiet.Value = quiet
+				}(globals.Quiet.Value)
+				globals.Quiet.Value = true
+
+				// we are not logged in, so force login now by running the "login" command
+				app.Parse([]string{"login"})
+
+				// rerun the original request
+				return o.Do(req)
+			}
+		} else if globals.AuthMethodIsToken() && resp.StatusCode == 401 {
+			globals.SetPass("")
+			return o.Do(req)
+		}
+		return resp, nil
+	})
+
+	for _, command := range globalCommandRegistry {
+		copy := command
+		commandFields := strings.Fields(copy.Command)
+		var appOrCmd kingpinAppOrCommand = app
+		if len(commandFields) > 1 {
+			for _, name := range commandFields[0 : len(commandFields)-1] {
+				tmp := appOrCmd.GetCommand(name)
+				if tmp == nil {
+					tmp = appOrCmd.Command(name, "")
+				}
+				appOrCmd = tmp
+			}
+		}
+
+		cmd := appOrCmd.Command(commandFields[len(commandFields)-1], copy.Entry.Help)
+		LoadConfigs(cmd, fig, &globals)
+		cmd.PreAction(func(_ *kingpin.ParseContext) error {
+			if globals.Insecure.Value {
+				transport := &http.Transport{
+					Proxy: http.ProxyFromEnvironment,
+					TLSClientConfig: &tls.Config{
+						InsecureSkipVerify: true,
+					},
+				}
+				o = o.WithTransport(transport)
+			}
+			if globals.UnixProxy.Value != "" {
+				o = o.WithTransport(unixProxy(globals.UnixProxy.Value))
+			} else if globals.SocksProxy.Value != "" {
+				o = o.WithTransport(socksProxy(globals.SocksProxy.Value))
+			}
+			if globals.AuthMethodIsToken() {
+				o = o.WithCookieFile("")
+			}
+			if globals.Login.Value == "" {
+				globals.Login = globals.User
+			}
+			return nil
+		})
+
+		for _, alias := range copy.Aliases {
+			cmd = cmd.Alias(alias)
+		}
+		if copy.Default {
+			cmd = cmd.Default()
+		}
+		if copy.Entry.UsageFunc != nil {
+			copy.Entry.UsageFunc(fig, cmd)
+		}
+
+		cmd.Action(func(_ *kingpin.ParseContext) error {
+			if logging.GetLevel("") > logging.DEBUG {
+				o = o.WithTrace(true)
+			}
+			return copy.Entry.ExecuteFunc(o, &globals)
+		})
+	}
+}
+
+func LoadConfigs(cmd *kingpin.CmdClause, fig *figtree.FigTree, opts interface{}) {
+	cmd.PreAction(func(_ *kingpin.ParseContext) error {
+		os.Setenv("JIRA_OPERATION", cmd.FullCommand())
+		// load command specific configs first
+		if err := fig.LoadAllConfigs(strings.Join(strings.Fields(cmd.FullCommand()), "_")+".yml", opts); err != nil {
+			return err
+		}
+		// then load generic configs if not already populated above
+		return fig.LoadAllConfigs("config.yml", opts)
+	})
+}
+
+func BrowseUsage(cmd *kingpin.CmdClause, opts *CommonOptions) {
+	cmd.Flag("browse", "Open issue(s) in browser after operation").Short('b').SetValue(&opts.Browse)
+}
+
+func EditorUsage(cmd *kingpin.CmdClause, opts *CommonOptions) {
+	cmd.Flag("editor", "Editor to use").SetValue(&opts.Editor)
+}
+
+func FileUsage(cmd *kingpin.CmdClause, opts *CommonOptions) {
+	cmd.Flag("file", "File to use").SetValue(&opts.File)
+}
+
+func TemplateUsage(cmd *kingpin.CmdClause, opts *CommonOptions) {
+	cmd.Flag("template", "Template to use for output").Short('t').SetValue(&opts.Template)
+}
+
+func GJsonQueryUsage(cmd *kingpin.CmdClause, opts *CommonOptions) {
+	cmd.Flag("gjq", "GJSON Query to filter output, see https://goo.gl/iaYwJ5").SetValue(&opts.GJsonQuery)
+}
+
+func (o *CommonOptions) PrintTemplate(data interface{}) error {
+	if o.GJsonQuery.Value != "" {
+		buf := bytes.NewBufferString("")
+		RunTemplate("json", data, buf)
+		results := gjson.GetBytes(buf.Bytes(), o.GJsonQuery.Value)
+		_, err := os.Stdout.Write([]byte(results.String()))
+		os.Stdout.Write([]byte{'\n'})
+		return err
+	}
+	return RunTemplate(o.Template.Value, data, nil)
+}
+
+func (o *CommonOptions) editFile(fileName string) (changes bool, err error) {
+	var editor string
+	for _, ed := range []string{o.Editor.Value, os.Getenv("JIRA_EDITOR"), os.Getenv("EDITOR"), "vim"} {
+		if ed != "" {
+			editor = ed
+			break
+		}
+	}
+
+	if o.SkipEditing.Value {
+		return false, nil
+	}
+
+	tmpFileNameOrig := fmt.Sprintf("%s.orig", fileName)
+	if err := copyFile(fileName, tmpFileNameOrig); err != nil {
+		return false, err
+	}
+
+	defer func() {
+		os.Remove(tmpFileNameOrig)
+	}()
+
+	shell, _ := shellquote.Split(editor)
+	shell = append(shell, fileName)
+	log.Debugf("Running: %#v", shell)
+	cmd := exec.Command(shell[0], shell[1:]...)
+	cmd.Stdout, cmd.Stderr, cmd.Stdin = os.Stdout, os.Stderr, os.Stdin
+	if err := cmd.Run(); err != nil {
+		return false, err
+	}
+
+	// now we just need to diff the files to see if there are any changes
+	f1, err := os.Open(tmpFileNameOrig)
+	if err != nil {
+		return false, err
+	}
+	f2, err := os.Open(fileName)
+	if err != nil {
+		return false, err
+	}
+
+	stat1, err := f1.Stat()
+	if err != nil {
+		return false, err
+	}
+	stat2, err := f2.Stat()
+	if err != nil {
+		return false, err
+	}
+	// different sizes, so must have changes
+	if stat1.Size() != stat2.Size() {
+		return true, nil
+	}
+
+	p1, p2 := make([]byte, 1024), make([]byte, 1024)
+	var n1, n2 int
+	// loop though 1024 bytes at a time comparing the buffers for changes
+	for err != io.EOF {
+		n1, _ = f1.Read(p1)
+		n2, err = f2.Read(p2)
+		if n1 != n2 {
+			return true, nil
+		}
+		if !bytes.Equal(p1[:n1], p2[:n2]) {
+			return true, nil
+		}
+	}
+	return false, nil
+}
+
+var EditLoopAbort = fmt.Errorf("edit Loop aborted by request")
+
+func EditLoop(opts *CommonOptions, input interface{}, output interface{}, submit func() error) error {
+	tmpFile, err := tmpTemplate(opts.Template.Value, input)
+	if err != nil {
+		return err
+	}
+
+	confirm := func(dflt bool, msg string) (answer bool) {
+		survey.AskOne(
+			&survey.Confirm{Message: msg, Default: dflt},
+			&answer,
+			nil,
+		)
+		return
+	}
+
+	// we need to copy the original output so that we can restore
+	// it on retries in case we try to populate bogus fields that
+	// are rejected by the jira service.
+	dup := reflect.New(reflect.ValueOf(output).Elem().Type())
+	err = copier.Copy(dup.Interface(), output)
+	if err != nil {
+		return err
+	}
+
+	for {
+		if !opts.SkipEditing.Value {
+			changes, err := opts.editFile(tmpFile)
+			if err != nil {
+				log.Error(err.Error())
+				if confirm(true, "Editor reported an error, edit again?") {
+					continue
+				}
+				return EditLoopAbort
+			}
+			if !changes {
+				if !confirm(false, "No changes detected, submit anyway?") {
+					return EditLoopAbort
+				}
+			}
+		}
+		// parse template
+		data, err := ioutil.ReadFile(tmpFile)
+		if err != nil {
+			return err
+		}
+
+		defer func(mapType, iface reflect.Type) {
+			yaml.DefaultMapType = mapType
+			yaml.IfaceType = iface
+		}(yaml.DefaultMapType, yaml.IfaceType)
+		yaml.DefaultMapType = reflect.TypeOf(map[string]interface{}{})
+		yaml.IfaceType = yaml.DefaultMapType.Elem()
+
+		// restore output incase of retry loop
+		err = copier.Copy(output, dup.Interface())
+		if err != nil {
+			return err
+		}
+
+		// HACK HACK HACK we want to trim out all the yaml garbage that is not
+		// poplulated, like empty arrays, string values with only a newline,
+		// etc.  We need to do this because jira will reject json documents
+		// with empty arrays, or empty strings typically.  So here we process
+		// the data to a raw interface{} then we fixup the yaml parsed
+		// interface, then we serialize to a new yaml document ... then is
+		// parsed as the original document to populate the output struct.  Phew.
+		var raw interface{}
+		if err := yaml.Unmarshal(data, &raw); err != nil {
+			log.Error(err.Error())
+			if confirm(true, "Invalid YAML syntax, edit again?") {
+				continue
+			}
+			return EditLoopAbort
+		}
+		yamlFixup(&raw)
+		fixedYAML, err := yaml.Marshal(&raw)
+		if err != nil {
+			log.Error(err.Error())
+			if confirm(true, "Invalid YAML syntax, edit again?") {
+				continue
+			}
+			return EditLoopAbort
+		}
+
+		if err := yaml.Unmarshal(fixedYAML, output); err != nil {
+			log.Error(err.Error())
+			if confirm(true, "Invalid YAML syntax, edit again?") {
+				continue
+			}
+			return EditLoopAbort
+		}
+		// submit template
+		if err := submit(); err != nil {
+			log.Error(err.Error())
+			if confirm(true, "Jira reported an error, edit again?") {
+				continue
+			}
+			return EditLoopAbort
+		}
+		break
+	}
+	return nil
+}
+
+var FileAbort = fmt.Errorf("file processing aborted")
+
+func ReadYmlInputFile(opts *CommonOptions, input interface{}, output interface{}, submit func() error) error {
+	tmpFile, err := tmpTemplate(opts.Template.Value, input)
+	if err != nil {
+		return err
+	}
+
+	tmpFile = opts.File.String()
+
+	// we need to copy the original output so that we can restore
+	// it on retries in case we try to populate bogus fields that
+	// are rejected by the jira service.
+	dup := reflect.New(reflect.ValueOf(output).Elem().Type())
+	err = copier.Copy(dup.Interface(), output)
+	if err != nil {
+		return err
+	}
+
+	// parse template
+	data, err := ioutil.ReadFile(tmpFile)
+	if err != nil {
+		return err
+	}
+
+	defer func(mapType, iface reflect.Type) {
+		yaml.DefaultMapType = mapType
+		yaml.IfaceType = iface
+	}(yaml.DefaultMapType, yaml.IfaceType)
+	yaml.DefaultMapType = reflect.TypeOf(map[string]interface{}{})
+	yaml.IfaceType = yaml.DefaultMapType.Elem()
+
+	// restore output incase of retry loop
+	err = copier.Copy(output, dup.Interface())
+	if err != nil {
+		return err
+	}
+
+	// HACK HACK HACK we want to trim out all the yaml garbage that is not
+	// poplulated, like empty arrays, string values with only a newline,
+	// etc.  We need to do this because jira will reject json documents
+	// with empty arrays, or empty strings typically.  So here we process
+	// the data to a raw interface{} then we fixup the yaml parsed
+	// interface, then we serialize to a new yaml document ... then is
+	// parsed as the original document to populate the output struct.  Phew.
+	var raw interface{}
+	if err := yaml.Unmarshal(data, &raw); err != nil {
+		log.Error(err.Error())
+		fmt.Printf("Invalid YAML syntax\n")
+		return FileAbort
+	}
+	yamlFixup(&raw)
+	fixedYAML, err := yaml.Marshal(&raw)
+	if err != nil {
+		log.Error(err.Error())
+		fmt.Printf("Invalid YAML syntax\n")
+		return FileAbort
+	}
+
+	if err := yaml.Unmarshal(fixedYAML, output); err != nil {
+		log.Error(err.Error())
+		fmt.Printf("Invalid YAML syntax\n")
+		return FileAbort
+	}
+	// submit template
+	if err := submit(); err != nil {
+		log.Error(err.Error())
+		fmt.Printf("Jira reported an error\n")
+		return FileAbort
+	}
+	return nil
+}
+
+func FormatIssue(issueKey string, project string) string {
+	if issueKey == "" {
+		return ""
+	}
+
+	// expect PROJ-1234 issue format, this will split and
+	// reassemble, converting proj-1234 to PROJ-1234
+	parts := strings.SplitN(issueKey, "-", 2)
+	if len(parts) > 1 {
+		return fmt.Sprintf("%s-%s", strings.ToUpper(parts[0]), parts[1])
+	}
+
+	// if issue is not PROJ-1234 then it might just be 1234, so verify
+	// it is a number here otherwise warn and return input
+	if _, err := strconv.Atoi(issueKey); err != nil {
+		log.Warningf("Unexpected issue format %q, expected PROJ-1234", issueKey)
+		return issueKey
+	}
+
+	if project == "" {
+		log.Warningf("Using abbreviated issue %q but `project` property is not defined", issueKey)
+		return issueKey
+	}
+
+	return fmt.Sprintf("%s-%s", strings.ToUpper(project), issueKey)
+}

jiracli/error.go

@@ -0,0 +1,13 @@
+package jiracli
+
+import "github.com/pkg/errors"
+
+type Error struct {
+	error
+}
+
+func CliError(cause error) error {
+	return &Error{
+		errors.WithStack(cause),
+	}
+}

jiracli/keyring.go

@@ -0,0 +1,17 @@
+// +build !windows
+
+package jiracli
+
+import "github.com/tmc/keyring"
+
+func keyringGet(user string) (string, error) {
+	password, err := keyring.Get("go-jira", user)
+	if err != nil && err != keyring.ErrNotFound {
+		return password, err
+	}
+	return password, nil
+}
+
+func keyringSet(user, passwd string) error {
+	return keyring.Set("go-jira", user, passwd)
+}

jiracli/keyring_windows.go

@@ -0,0 +1,11 @@
+package jiracli
+
+import "fmt"
+
+func keyringGet(user string) (string, error) {
+	return "", fmt.Errorf("Keyring is not supported for Windows, see: https://github.com/tmc/keyring")
+}
+
+func keyringSet(user, passwd string) error {
+	return fmt.Errorf("Keyring is not supported for Windows, see: https://github.com/tmc/keyring")
+}

jiracli/log.go

@@ -0,0 +1,38 @@
+package jiracli
+
+import (
+	"os"
+	"strconv"
+
+	logging "gopkg.in/op/go-logging.v1"
+)
+
+var (
+	log = logging.MustGetLogger("jira")
+)
+
+func IncreaseLogLevel(verbosity int) {
+	logging.SetLevel(logging.GetLevel("")+logging.Level(verbosity), "")
+}
+
+func InitLogging() {
+	logBackend := logging.NewLogBackend(os.Stderr, "", 0)
+	format := os.Getenv("JIRA_LOG_FORMAT")
+	if format == "" {
+		format = "%{color}%{level:-5s}%{color:reset} %{message}"
+	}
+	logging.SetBackend(
+		logging.NewBackendFormatter(
+			logBackend,
+			logging.MustStringFormatter(format),
+		),
+	)
+	if os.Getenv("JIRA_DEBUG") == "" {
+		logging.SetLevel(logging.NOTICE, "")
+	} else {
+		logging.SetLevel(logging.DEBUG, "")
+		if verbosity, err := strconv.Atoi(os.Getenv("JIRA_DEBUG")); err == nil {
+			IncreaseLogLevel(verbosity)
+		}
+	}
+}

jiracli/password.go

@@ -0,0 +1,225 @@
+package jiracli
+
+import (
+	"bytes"
+	"fmt"
+	"io/ioutil"
+	"os"
+	"os/exec"
+	"strings"
+
+	"github.com/go-jira/jira/jiradata"
+	"gopkg.in/AlecAivazis/survey.v1"
+)
+
+func (o *GlobalOptions) ProvideAuthParams() *jiradata.AuthParams {
+	return &jiradata.AuthParams{
+		Username: o.Login.Value,
+		Password: o.GetPass(),
+	}
+}
+
+func (o *GlobalOptions) keyName() string {
+	user := o.Login.Value
+	if o.AuthMethodIsToken() {
+		user = "api-token:" + user
+	}
+
+	if o.PasswordSource.Value == "pass" {
+		if o.PasswordName.Value != "" {
+			return o.PasswordName.Value
+		}
+		return fmt.Sprintf("GoJira/%s", user)
+	}
+
+	if o.PasswordSource.Value == "gopass" {
+		if o.PasswordName.Value != "" {
+			return o.PasswordName.Value
+		}
+		return fmt.Sprintf("GoJira/%s", user)
+	}
+	return user
+}
+
+func (o *GlobalOptions) GetPasswordPath() string {
+	// if no password source path then just default
+	// to the password source name
+	if o.PasswordSourcePath.Value == "" {
+		return o.PasswordSource.Value
+	}
+	return o.PasswordSourcePath.Value
+}
+
+func (o *GlobalOptions) GetPass() string {
+	if o.cachedPassword != "" {
+		return o.cachedPassword
+	}
+	log.Debugf("Getting Password")
+	if o.PasswordSource.Value != "" {
+		log.Debugf("password-source: %s", o.PasswordSource)
+		if o.PasswordSource.Value == "keyring" {
+			log.Info("Querying keyring password source.")
+			var err error
+			o.cachedPassword, err = keyringGet(o.keyName())
+			if err != nil {
+				panic(err)
+			}
+		} else if o.PasswordSource.Value == "gopass" {
+			log.Debugf("Querying gopass password source.")
+			binary := o.GetPasswordPath()
+			if o.PasswordDirectory.Value != "" {
+				orig := os.Getenv("PASSWORD_STORE_DIR")
+				log.Debugf("using password-directory: %s", o.PasswordDirectory)
+				os.Setenv("PASSWORD_STORE_DIR", o.PasswordDirectory.Value)
+				defer os.Setenv("PASSWORD_STORE_DIR", orig)
+			}
+			if passDir := os.Getenv("PASSWORD_STORE_DIR"); passDir != "" {
+				log.Debugf("using PASSWORD_STORE_DIR=%s", passDir)
+			}
+			if bin, err := exec.LookPath(binary); err == nil {
+				log.Debugf("found gopass at: %s", bin)
+				buf := bytes.NewBufferString("")
+				cmd := exec.Command(bin, "show", "-o", o.keyName())
+				cmd.Stdout = buf
+				cmd.Stderr = os.Stderr
+				if err := cmd.Run(); err == nil {
+					o.cachedPassword = strings.TrimSpace(buf.String())
+				} else {
+					log.Warningf("gopass command failed with:\n%s", buf.String())
+				}
+			} else {
+				log.Warning("Gopass binary was not found! Fallback to default password behaviour!")
+			}
+		} else if o.PasswordSource.Value == "pass" {
+			log.Debugf("Querying pass password source.")
+			binary := o.GetPasswordPath()
+			if o.PasswordDirectory.Value != "" {
+				orig := os.Getenv("PASSWORD_STORE_DIR")
+				log.Debugf("using password-directory: %s", o.PasswordDirectory)
+				os.Setenv("PASSWORD_STORE_DIR", o.PasswordDirectory.Value)
+				defer os.Setenv("PASSWORD_STORE_DIR", orig)
+			}
+			if passDir := os.Getenv("PASSWORD_STORE_DIR"); passDir != "" {
+				log.Debugf("using PASSWORD_STORE_DIR=%s", passDir)
+			}
+			if bin, err := exec.LookPath(binary); err == nil {
+				log.Debugf("found pass at: %s", bin)
+				buf := bytes.NewBufferString("")
+				cmd := exec.Command(bin, o.keyName())
+				cmd.Stdout = buf
+				cmd.Stderr = os.Stderr
+				if err := cmd.Run(); err == nil {
+					o.cachedPassword = strings.TrimSpace(buf.String())
+				} else {
+					log.Warningf("pass command failed with:\n%s", buf.String())
+				}
+			} else {
+				log.Warning("pass binary was not found! Fallback to default password behaviour!")
+			}
+		} else if o.PasswordSource.Value == "stdin" {
+			log.Info("Reading password from stdin.")
+			allBytes, err := ioutil.ReadAll(os.Stdin)
+			if err != nil {
+				panic(fmt.Sprintf("unable to read bytes from stdin: %s", err))
+			}
+			o.cachedPassword = string(allBytes)
+		} else {
+			log.Warningf("Unknown password-source: %s", o.PasswordSource)
+		}
+	}
+
+	if o.cachedPassword != "" {
+		log.Info("Password cached.")
+		return o.cachedPassword
+	}
+
+	if o.cachedPassword = os.Getenv("JIRA_API_TOKEN"); o.cachedPassword != "" && o.AuthMethodIsToken() {
+		return o.cachedPassword
+	}
+
+	prompt := fmt.Sprintf("Jira Password [%s]: ", o.Login)
+	help := ""
+
+	if o.AuthMethodIsToken() {
+		prompt = fmt.Sprintf("Jira API-Token [%s]: ", o.Login)
+		help = "API Tokens may be required by your Jira service endpoint: https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-basic-auth-and-cookie-based-auth/"
+	}
+
+	err := survey.AskOne(
+		&survey.Password{
+			Message: prompt,
+			Help:    help,
+		},
+		&o.cachedPassword,
+		nil,
+	)
+	if err != nil {
+		log.Errorf("%s", err)
+		panic(Exit{Code: 1})
+	}
+	o.SetPass(o.cachedPassword)
+	return o.cachedPassword
+}
+
+func (o *GlobalOptions) SetPass(passwd string) error {
+	// dont reset password to empty string
+	if passwd == "" {
+		return nil
+	}
+
+	if o.PasswordSource.Value == "keyring" {
+		// save password in keychain so that it can be used for subsequent http requests
+		err := keyringSet(o.keyName(), passwd)
+		if err != nil {
+			log.Errorf("Failed to set password in keyring: %s", err)
+			return err
+		}
+	} else if o.PasswordSource.Value == "gopass" {
+		if o.PasswordDirectory.Value != "" {
+			orig := os.Getenv("PASSWORD_STORE_DIR")
+			os.Setenv("PASSWORD_STORE_DIR", o.PasswordDirectory.Value)
+			defer os.Setenv("PASSWORD_STORE_DIR", orig)
+		}
+		if bin, err := exec.LookPath("gopass"); err == nil {
+			log.Debugf("using %s", bin)
+			passName := o.keyName()
+			if passwd != "" {
+				in := bytes.NewBufferString(fmt.Sprintf("%s\n", passwd))
+				out := bytes.NewBufferString("")
+				cmd := exec.Command(bin, "insert", "--force", passName)
+				cmd.Stdin = in
+				cmd.Stdout = out
+				cmd.Stderr = out
+				if err := cmd.Run(); err != nil {
+					return fmt.Errorf("Failed to insert password: %s", out.String())
+				}
+			}
+		} else {
+			return fmt.Errorf("Gopass binary not found!")
+		}
+	} else if o.PasswordSource.Value == "pass" {
+		if o.PasswordDirectory.Value != "" {
+			orig := os.Getenv("PASSWORD_STORE_DIR")
+			os.Setenv("PASSWORD_STORE_DIR", o.PasswordDirectory.Value)
+			defer os.Setenv("PASSWORD_STORE_DIR", orig)
+		}
+		if bin, err := exec.LookPath("pass"); err == nil {
+			log.Debugf("using %s", bin)
+			passName := o.keyName()
+			in := bytes.NewBufferString(fmt.Sprintf("%s\n%s\n", passwd, passwd))
+			out := bytes.NewBufferString("")
+			cmd := exec.Command(bin, "insert", "--force", passName)
+			cmd.Stdin = in
+			cmd.Stdout = out
+			cmd.Stderr = out
+			if err := cmd.Run(); err != nil {
+				return fmt.Errorf("Failed to insert password: %s", out.String())
+			}
+		} else {
+			return fmt.Errorf("Pass binary not found!")
+		}
+	} else if o.PasswordSource.Value != "" {
+		return fmt.Errorf("Unknown password-source: %s", o.PasswordSource)
+	}
+	return nil
+}

jiracli/socksproxy.go

@@ -0,0 +1,31 @@
+package jiracli
+
+import (
+	"net"
+	"net/http"
+	"time"
+
+	"golang.org/x/net/proxy"
+)
+
+func socksProxy(address string) *http.Transport {
+	return newSocksProxyTransport(address)
+}
+
+func newSocksProxyTransport(address string) *http.Transport {
+	dialer, err := proxy.SOCKS5("tcp", address, nil, proxy.Direct)
+	if err != nil {
+		// TODO: whoops, return error?
+		panic(err)
+	}
+	dial := func(network, addr string) (net.Conn, error) {
+		return dialer.Dial(network, addr)
+	}
+
+	return &http.Transport{
+		Dial:                  dial,
+		DisableKeepAlives:     true,
+		ResponseHeaderTimeout: 30 * time.Second,
+		ExpectContinueTimeout: 10 * time.Second,
+	}
+}

jiracli/templates.go

@@ -0,0 +1,644 @@
+package jiracli
+
+import (
+	"bytes"
+	"encoding/json"
+	"fmt"
+	"io"
+	"io/ioutil"
+	"os"
+	"path/filepath"
+	"reflect"
+	"regexp"
+	"strconv"
+	"strings"
+	"text/template"
+
+	yaml "gopkg.in/coryb/yaml.v2"
+
+	"github.com/Masterminds/sprig"
+	"github.com/coryb/figtree"
+	shellquote "github.com/kballard/go-shellquote"
+	"github.com/mgutz/ansi"
+	wordwrap "github.com/mitchellh/go-wordwrap"
+	"github.com/olekukonko/tablewriter"
+	"golang.org/x/crypto/ssh/terminal"
+)
+
+func findTemplate(name string) ([]byte, error) {
+	if file, err := findClosestParentPath(filepath.Join(".jira.d", "templates", name)); err == nil {
+		b, err := ioutil.ReadFile(file)
+		if err != nil {
+			return nil, err
+		}
+		return b, nil
+	}
+	return nil, nil
+}
+
+func getTemplate(name string) (string, error) {
+	if _, err := os.Stat(".jira.d/" + name); err == nil {
+		b, err := ioutil.ReadFile(".jira.d/" + name)
+		if err != nil {
+			return "", err
+		}
+		return string(b), nil
+	}
+	b, err := findTemplate(name)
+	if err != nil {
+		return "", err
+	}
+	if b != nil {
+		return string(b), nil
+	}
+	if s, ok := AllTemplates[name]; ok {
+		return s, nil
+	}
+	return "", fmt.Errorf("No Template found for %q", name)
+}
+
+func tmpTemplate(templateName string, data interface{}) (string, error) {
+	tmpFile, err := tmpYml(templateName)
+	if err != nil {
+		return "", err
+	}
+	defer tmpFile.Close()
+	return tmpFile.Name(), RunTemplate(templateName, data, tmpFile)
+}
+
+func TemplateProcessor() *template.Template {
+	funcs := map[string]interface{}{
+		"jira": func() string {
+			return os.Args[0]
+		},
+		"env": func() map[string]string {
+			out := map[string]string{}
+			for _, env := range os.Environ() {
+				kv := strings.SplitN(env, "=", 2)
+				out[kv[0]] = kv[1]
+			}
+			return out
+		},
+		"fit": func(size int, content string) string {
+			return fmt.Sprintf(fmt.Sprintf("%%-%d.%ds", size, size), content)
+		},
+		"shellquote": func(content string) string {
+			return shellquote.Join(content)
+		},
+		"toMinJson": func(content interface{}) (string, error) {
+			bytes, err := json.Marshal(content)
+			if err != nil {
+				return "", err
+			}
+			return string(bytes), nil
+		},
+		"toJson": func(content interface{}) (string, error) {
+			bytes, err := json.MarshalIndent(content, "", "    ")
+			if err != nil {
+				return "", err
+			}
+			return string(bytes), nil
+		},
+		"termWidth": func() int {
+			w, _, err := terminal.GetSize(int(os.Stdout.Fd()))
+			if err == nil {
+				return w
+			}
+			if os.Getenv("COLUMNS") != "" {
+				w, err = strconv.Atoi(os.Getenv("COLUMNS"))
+			}
+			if err == nil {
+				return w
+			}
+			return 120
+		},
+		"pctOf": func(size, percent int) int {
+			return int(float32(size) * (float32(percent) / 100))
+		},
+		"sub": func(a, b int) int {
+			return a - b
+		},
+		"append": func(more string, content interface{}) (string, error) {
+			switch value := content.(type) {
+			case string:
+				return string(append([]byte(content.(string)), []byte(more)...)), nil
+			case []byte:
+				return string(append(content.([]byte), []byte(more)...)), nil
+			default:
+				return "", fmt.Errorf("Unknown type: %s", value)
+			}
+		},
+		"indent": func(spaces int, content string) string {
+			indent := make([]rune, spaces+1)
+			indent[0] = '\n'
+			for i := 1; i < spaces+1; i++ {
+				indent[i] = ' '
+			}
+
+			lineSeps := []rune{'\n', '\u0085', '\u2028', '\u2029'}
+			for _, sep := range lineSeps {
+				indent[0] = sep
+				content = strings.Replace(content, string(sep), string(indent), -1)
+			}
+			return content
+
+		},
+		"comment": func(content string) string {
+			lineSeps := []rune{'\n', '\u0085', '\u2028', '\u2029'}
+			for _, sep := range lineSeps {
+				content = strings.Replace(content, string(sep), string([]rune{sep, '#', ' '}), -1)
+			}
+			return content
+		},
+		"color": func(color string) string {
+			return ansi.ColorCode(color)
+		},
+		"remLineBreak": func(content string) string {
+			return strings.Replace(strings.Replace(content, string('\r'), string(' '), -1), string('\n'), string(' '), -1)
+		},
+		"regReplace": func(search string, replace string, content string) string {
+			re := regexp.MustCompile(search)
+			return re.ReplaceAllString(content, replace)
+		},
+		"split": func(sep string, content string) []string {
+			return strings.Split(content, sep)
+		},
+		"join": func(sep string, content []interface{}) string {
+			vals := make([]string, len(content))
+			for i, v := range content {
+				vals[i] = v.(string)
+			}
+			return strings.Join(vals, sep)
+		},
+		"abbrev": func(max int, content string) string {
+			if len(content) > max && max > 2 {
+				var buffer bytes.Buffer
+				buffer.WriteString(content[:max-3])
+				buffer.WriteString("...")
+				return buffer.String()
+			}
+			return content
+		},
+		"rep": func(count int, content string) string {
+			var buffer bytes.Buffer
+			for i := 0; i < count; i++ {
+				buffer.WriteString(content)
+			}
+			return buffer.String()
+		},
+		"age": func(content string) (string, error) {
+			return fuzzyAge(content)
+		},
+		"dateFormat": func(format string, content string) (string, error) {
+			return dateFormat(format, content)
+		},
+		"wrap": func(width uint, content string) string {
+			return wordwrap.WrapString(content, width)
+		},
+	}
+	return template.New("gojira").Funcs(sprig.GenericFuncMap()).Funcs(funcs)
+}
+
+func ConfigTemplate(fig *figtree.FigTree, template, command string, opts interface{}) (string, error) {
+	var tmp map[string]interface{}
+	err := ConvertType(opts, &tmp)
+	if err != nil {
+		return "", err
+	}
+	fig.LoadAllConfigs(command+".yml", &tmp)
+	fig.LoadAllConfigs("config.yml", &tmp)
+
+	tmpl, err := TemplateProcessor().Parse(template)
+	if err != nil {
+		return "", err
+	}
+	buf := bytes.NewBufferString("")
+	if err := tmpl.Execute(buf, &tmp); err != nil {
+		return "", err
+	}
+	return buf.String(), nil
+}
+
+func ConvertType(input interface{}, output interface{}) error {
+	// HACK HACK HACK: convert data formats to json for backwards compatibilty with templates
+	jsonData, err := json.Marshal(input)
+	if err != nil {
+		return err
+	}
+
+	defer func(mapType, iface reflect.Type) {
+		yaml.DefaultMapType = mapType
+		yaml.IfaceType = iface
+	}(yaml.DefaultMapType, yaml.IfaceType)
+
+	yaml.DefaultMapType = reflect.TypeOf(map[string]interface{}{})
+	yaml.IfaceType = yaml.DefaultMapType.Elem()
+
+	if err := yaml.Unmarshal(jsonData, output); err != nil {
+		return err
+	}
+	return nil
+
+}
+
+func RunTemplate(templateName string, data interface{}, out io.Writer) error {
+
+	templateContent, err := getTemplate(templateName)
+	if err != nil {
+		return err
+	}
+
+	if out == nil {
+		out = os.Stdout
+	}
+
+	var rawData interface{}
+	err = ConvertType(data, &rawData)
+	if err != nil {
+		return err
+	}
+
+	table := tablewriter.NewWriter(out)
+	table.SetAutoFormatHeaders(false)
+	headers := []string{}
+	cells := [][]string{}
+	tmpl, err := TemplateProcessor().Funcs(map[string]interface{}{
+		"defaultColWidth": func(cw int) string {
+			table.SetColWidth(cw)
+			return ""
+		},
+		"headers": func(titles ...string) string {
+			headers = append(headers, titles...)
+			return ""
+		},
+		"row": func() string {
+			cells = append(cells, []string{})
+			return ""
+		},
+		"cell": func(value interface{}) (string, error) {
+			if len(cells) == 0 {
+				return "", fmt.Errorf(`"cell" template function called before "row" template function`)
+			}
+			cells[len(cells)-1] = append(cells[len(cells)-1], fmt.Sprintf("%v", value))
+			return "", nil
+		},
+	}).Parse(templateContent)
+	if err != nil {
+		return err
+	}
+
+	if err := tmpl.Execute(out, rawData); err != nil {
+		return err
+	}
+	if len(headers) > 0 || len(cells) > 0 {
+		table.SetHeader(headers)
+		table.AppendBulk(cells)
+		table.Render()
+	}
+
+	return nil
+}
+
+var AllTemplates = map[string]string{
+	"attach-list":    defaultAttachListTemplate,
+	"comment":        defaultCommentTemplate,
+	"component-add":  defaultComponentAddTemplate,
+	"components":     defaultComponentsTemplate,
+	"create":         defaultCreateTemplate,
+	"createmeta":     defaultDebugTemplate,
+	"debug":          defaultDebugTemplate,
+	"edit":           defaultEditTemplate,
+	"editmeta":       defaultDebugTemplate,
+	"epic-create":    defaultEpicCreateTemplate,
+	"epic-list":      defaultTableTemplate,
+	"fields":         defaultDebugTemplate,
+	"issuelinktypes": defaultDebugTemplate,
+	"issuetypes":     defaultIssuetypesTemplate,
+	"json":           defaultDebugTemplate,
+	"list":           defaultListTemplate,
+	"request":        defaultDebugTemplate,
+	"subtask":        defaultSubtaskTemplate,
+	"table":          defaultTableTemplate,
+	"transition":     defaultTransitionTemplate,
+	"transitions":    defaultTransitionsTemplate,
+	"transmeta":      defaultDebugTemplate,
+	"view":           defaultViewTemplate,
+	"worklog":        defaultWorklogTemplate,
+	"worklogs":       defaultWorklogsTemplate,
+}
+
+const defaultDebugTemplate = "{{ . | toJson}}\n"
+
+const defaultListTemplate = "{{ range .issues }}{{ .key | append \":\" | printf \"%-12s\"}} {{ .fields.summary }}\n{{ end }}"
+
+const defaultTableTemplate = `{{/* table template */ -}}
+{{- headers "Issue" "Summary" "Type" "Priority" "Status" "Age" "Reporter" "Assignee" -}}
+{{- range .issues -}} 
+  {{- row -}}
+  {{- cell .key -}}
+  {{- cell .fields.summary -}}
+  {{- cell .fields.issuetype.name -}}
+  {{- if .fields.priority -}}
+    {{- cell .fields.priority.name -}}
+  {{- else -}}
+    {{- cell "<none>" -}}
+  {{- end -}}
+  {{- cell .fields.status.name -}}
+  {{- cell (.fields.created | age) -}}
+  {{- if .fields.reporter -}}
+    {{- cell .fields.reporter.displayName -}}
+  {{- else -}}
+    {{- cell "<unknown>" -}}
+  {{- end -}}
+  {{- if .fields.assignee -}}
+    {{- cell .fields.assignee.displayName -}}
+  {{- else -}}
+    {{- cell "<unassigned>" -}}
+  {{- end -}}
+{{- end -}}
+`
+
+const defaultAttachListTemplate = `{{/* attach list template */ -}}
+{{- headers "id" "filename" "bytes" "user" "created" -}}
+{{- range . -}}
+  {{- row -}}
+  {{- cell .id -}}
+  {{- cell .filename -}}
+  {{- cell .size -}}
+  {{- cell .author.displayName -}}
+  {{- cell (.created | age) -}}
+{{- end -}}
+`
+
+const defaultViewTemplate = `{{/* view template */ -}}
+issue: {{ .key }}
+{{if .fields.created -}}
+created: {{ .fields.created | age }} ago
+{{end -}}
+{{if .fields.status -}}
+status: {{ .fields.status.name }}
+{{end -}}
+summary: {{ .fields.summary }}
+project: {{ .fields.project.key }}
+{{if .fields.components -}}
+components: {{ range .fields.components }}{{ .name }} {{end}}
+{{end -}}
+{{if .fields.issuetype -}}
+issuetype: {{ .fields.issuetype.name }}
+{{end -}}
+{{if .fields.assignee -}}
+assignee: {{ .fields.assignee.displayName }}
+{{end -}}
+reporter: {{ if .fields.reporter }}{{ .fields.reporter.displayName }}{{end}}
+{{if .fields.customfield_10110 -}}
+watchers: {{ range .fields.customfield_10110 }}{{ .displayName }} {{end}}
+{{end -}}
+{{if .fields.issuelinks -}}
+blockers: {{ range .fields.issuelinks }}{{if .outwardIssue}}{{ .outwardIssue.key }}[{{.outwardIssue.fields.status.name}}]{{end}}{{end}}
+depends: {{ range .fields.issuelinks }}{{if .inwardIssue}}{{ .inwardIssue.key }}[{{.inwardIssue.fields.status.name}}]{{end}}{{end}}
+{{end -}}
+{{if .fields.priority -}}
+priority: {{ .fields.priority.name }}
+{{end -}}
+{{if .fields.votes -}}
+votes: {{ .fields.votes.votes}}
+{{end -}}
+{{if .fields.labels -}}
+labels: {{ join ", " .fields.labels }}
+{{end -}}
+description: |
+  {{ or .fields.description "" | indent 2 }}
+{{if .fields.comment.comments}}
+comments:
+{{ range .fields.comment.comments }}  - | # {{.author.displayName}}, {{.created | age}} ago
+    {{ or .body "" | indent 4}}
+{{end}}
+{{end -}}
+`
+const defaultEditTemplate = `{{/* edit template */ -}}
+# issue: {{ .key }} - created: {{ .fields.created | age}} ago
+update:
+  comment:
+    - add:
+        body: |~
+          {{ or .overrides.comment "" | indent 10 }}
+fields:
+  summary: >-
+    {{ or .overrides.summary .fields.summary }}
+{{- if and .meta.fields.components .meta.fields.components.allowedValues }}
+  components: # Values: {{ range .meta.fields.components.allowedValues }}{{.name}}, {{end}}{{if .overrides.components }}{{ range (split "," .overrides.components)}}
+    - name: {{.}}{{end}}{{else}}{{ range .fields.components }}
+    - name: {{ .name }}{{end}}{{end}}{{end}}
+{{- if .meta.fields.assignee }}
+  {{- if .overrides.assignee }}
+  assignee:
+    emailAddress: {{ .overrides.assignee }}
+  {{- else if .fields.assignee }}
+  assignee: {{if .fields.assignee.name}}
+    emailAddress: {{ or .fields.assignee.name}}
+  {{- else }}
+    emailAddress: {{.fields.assignee.emailAddress}}{{end}}{{end}}{{end}}
+{{- if .meta.fields.reporter}}
+  reporter:
+    emailAddress: {{ if .overrides.reporter }}{{ .overrides.reporter }}{{else if .fields.reporter}}{{ .fields.reporter.emailAddress }}{{end}}{{end}}
+{{- if .meta.fields.customfield_10110}}
+  # watchers
+  customfield_10110: {{ range .fields.customfield_10110 }}
+    - name: {{ .name }}{{end}}{{if .overrides.watcher}}
+    - name: {{ .overrides.watcher}}{{end}}{{end}}
+{{- if .meta.fields.priority }}
+  priority: # Values: {{ range .meta.fields.priority.allowedValues }}{{.name}}, {{end}}
+    name: {{ or .overrides.priority .fields.priority.name "" }}{{end}}
+  description: |~
+    {{ or .overrides.description .fields.description "" | indent 4 }}
+# votes: {{ .fields.votes.votes }}
+# comments:
+# {{ range .fields.comment.comments }}  - | # {{.author.displayName}}, {{.created | age}} ago
+#     {{ or .body "" | indent 4 | comment}}
+# {{end}}
+`
+const defaultTransitionsTemplate = `{{ range .transitions }}{{.id }}: {{.name}}
+{{end}}`
+
+const defaultComponentsTemplate = `{{ range . }}{{.id }}: {{.name}}
+{{end}}`
+
+const defaultComponentAddTemplate = `{{/* compoinent add template */ -}}
+project: {{or .project ""}}
+name: {{or .name ""}}
+description: {{or .description ""}}
+leadUserName: {{or .leadUserName ""}}
+`
+
+const defaultIssuetypesTemplate = `{{/* issuetypes template */ -}}
+{{ range .issuetypes }}{{color "+bh"}}{{.name | append ":" | printf "%-13s" }}{{color "reset"}} {{.description}}
+{{end}}`
+
+const defaultCreateTemplate = `{{/* create template */ -}}
+fields:
+  project:
+    key: {{ or .overrides.project "" }}
+  issuetype:
+    name: {{ or .overrides.issuetype "" }}
+  summary: >-
+    {{ or .overrides.summary "" }}{{if .meta.fields.priority.allowedValues}}
+  priority: # Values: {{ range .meta.fields.priority.allowedValues }}{{.name}}, {{end}}
+    name: {{ or .overrides.priority ""}}{{end}}{{if .meta.fields.components.allowedValues}}
+  components: # Values: {{ range .meta.fields.components.allowedValues }}{{.name}}, {{end}}{{ range split "," (or .overrides.components "")}}
+    - name: {{ . }}{{end}}{{end}}
+  description: |~
+    {{ or .overrides.description "" | indent 4 }}{{if .meta.fields.assignee}}
+  assignee:
+    emailAddress: {{ or .overrides.assignee "" }}{{end}}{{if .meta.fields.reporter}}
+  reporter:
+    emailAddress: {{ or .overrides.reporter .overrides.login }}{{end}}{{if .meta.fields.customfield_10110}}
+  # watchers
+  customfield_10110: {{ range split "," (or .overrides.watchers "")}}
+    - name: {{.}}{{end}}
+    - name:{{end}}`
+
+const defaultEpicCreateTemplate = `{{/* epic create template */ -}}
+fields:
+  project:
+    key: {{ or .overrides.project "" }}
+  # Epic Name
+  customfield_10120: {{ or (index .overrides "epic-name") "" }}
+  summary: >-
+    {{ or .overrides.summary "" }}{{if .meta.fields.priority.allowedValues}}
+  priority: # Values: {{ range .meta.fields.priority.allowedValues }}{{.name}}, {{end}}
+    name: {{ or .overrides.priority ""}}{{end}}{{if .meta.fields.components.allowedValues}}
+  components: # Values: {{ range .meta.fields.components.allowedValues }}{{.name}}, {{end}}{{ range split "," (or .overrides.components "")}}
+    - name: {{ . }}{{end}}{{end}}
+  description: |~
+    {{ or .overrides.description "" | indent 4 }}{{if .meta.fields.assignee}}
+  assignee:
+    emailAddress: {{ or .overrides.assignee "" }}{{end}}{{if .meta.fields.reporter}}
+  reporter:
+    emailAddress: {{ or .overrides.reporter .overrides.login }}{{end}}{{if .meta.fields.customfield_10110}}
+  # watchers
+  customfield_10110: {{ range split "," (or .overrides.watchers "")}}
+    - name: {{.}}{{end}}
+    - name:{{end}}
+  issuetype:
+    name: Epic`
+
+const defaultSubtaskTemplate = `{{/* create subtask template */ -}}
+fields:
+  project:
+    key: {{ .parent.fields.project.key }}
+  summary: >-
+    {{ or .overrides.summary "" }}{{if .meta.fields.priority.allowedValues}}
+  priority: # Values: {{ range .meta.fields.priority.allowedValues }}{{.name}}, {{end}}
+    name: {{ or .overrides.priority ""}}{{end}}{{if .meta.fields.components.allowedValues}}
+  components: # Values: {{ range .meta.fields.components.allowedValues }}{{.name}}, {{end}}{{ range split "," (or .overrides.components "")}}
+    - name: {{ . }}{{end}}{{end}}
+  description: |~
+    {{ or .overrides.description "" | indent 4 }}{{if .meta.fields.assignee}}
+  assignee:
+    emailAddress: {{ or .overrides.assignee "" }}{{end}}{{if .meta.fields.reporter}}
+  reporter:
+    emailAddress: {{ or .overrides.reporter .overrides.login }}{{end}}{{if .meta.fields.customfield_10110}}
+  # watchers
+  customfield_10110: {{ range split "," (or .overrides.watchers "")}}
+    - name: {{.}}{{end}}
+    - name:{{end}}
+  issuetype:
+    name: Sub-task
+  parent:
+    key: {{ .parent.key }}`
+
+const defaultCommentTemplate = `body: |~
+  {{ or .overrides.comment "" | indent 2 }}
+`
+
+const defaultTransitionTemplate = `{{/* transition template */ -}}
+{{- if .meta.fields.comment }}
+update:
+  comment:
+    - add:
+        body: |~
+          {{ or .overrides.comment "" | indent 10 }}
+{{- end -}}
+fields:
+{{- if .meta.fields.assignee }}
+  {{- if .overrides.assignee }}
+  assignee:
+    emailAddress: {{ .overrides.assignee }}
+  {{- else if .fields.assignee }}
+  assignee: {{if .fields.assignee.name}}
+    emailAddress: {{ or .fields.assignee.name}}
+  {{- else }}
+    emailAddress: {{.fields.assignee.emailAddress}}{{end}}{{end}}
+{{- end -}}
+{{if .meta.fields.components}}
+  components: # Values: {{ range .meta.fields.components.allowedValues }}{{.name}}, {{end}}{{if .overrides.components }}{{ range (split "," .overrides.components)}}
+    - name: {{.}}{{end}}{{else}}{{ range .fields.components }}
+    - name: {{ .name }}{{end}}{{end}}
+{{- end -}}
+{{if .meta.fields.description}}
+  description: |~
+    {{ or .fields.description "" | indent 4 }}
+{{- end -}}
+{{if .meta.fields.fixVersions -}}
+  {{if .meta.fields.fixVersions.allowedValues}}
+  fixVersions: # Values: {{ range .meta.fields.fixVersions.allowedValues }}{{.name}}, {{end}}{{if .overrides.fixVersions}}{{ range (split "," .overrides.fixVersions)}}
+    - name: {{.}}{{end}}{{else}}{{range .fields.fixVersions}}
+    - name: {{.name}}{{end}}{{end}}
+  {{- end -}}
+{{- end -}}
+{{if .meta.fields.issuetype}}
+  issuetype: # Values: {{ range .meta.fields.issuetype.allowedValues }}{{.name}}, {{end}}
+    name: {{if .overrides.issuetype}}{{.overrides.issuetype}}{{else}}{{if .fields.issuetype}}{{.fields.issuetype.name}}{{end}}{{end}}
+{{- end -}}
+{{if .meta.fields.labels}}
+  labels: {{range .fields.labels}}
+    - {{.}}{{end}}{{if .overrides.labels}}{{range (split "," .overrides.labels)}}
+    - {{.}}{{end}}{{end}}
+{{- end -}}
+{{if .meta.fields.priority}}
+  priority: # Values: {{ range .meta.fields.priority.allowedValues }}{{.name}}, {{end}}
+    name: {{ or .overrides.priority "unassigned" }}
+{{- end -}}
+{{- if .meta.fields.reporter }}
+  {{- if .overrides.reporter }}
+  reporter:
+    name: {{ .overrides.reporter }}
+  {{- else if .fields.reporter }}
+  reporter: {{if .fields.reporter.name}}
+    name: {{ or .fields.reporter.name}}
+  {{- else }}
+    displayName: {{.fields.reporter.displayName}}{{end}}{{end}}
+{{- end -}}
+{{if .meta.fields.resolution}}
+  resolution: # Values: {{ range .meta.fields.resolution.allowedValues }}{{.name}}, {{end}}
+    name: {{if .overrides.resolution}}{{.overrides.resolution}}{{else if .fields.resolution}}{{.fields.resolution.name}}{{else}}{{or .overrides.defaultResolution "Fixed"}}{{end}}
+{{- end -}}
+{{if .meta.fields.summary}}
+  summary: >-
+    {{or .overrides.summary .fields.summary}}
+{{- end -}}
+{{if .meta.fields.versions.allowedValues}}
+  versions: # Values: {{ range .meta.fields.versions.allowedValues }}{{.name}}, {{end}}{{if .overrides.versions}}{{ range (split "," .overrides.versions)}}
+    - name: {{.}}{{end}}{{else}}{{range .fields.versions}}
+    - name: {{.}}{{end}}{{end}}
+{{- end}}
+transition:
+  id: {{ .transition.id }}
+  name: {{ .transition.name }}
+`
+
+const defaultWorklogTemplate = `{{/* worklog template */ -}}
+# issue: {{ .issue }}
+comment: |~
+  {{ or .comment "" | indent 2 }}
+timeSpent: {{ or .timeSpent "" }}
+started: {{ or .started "" }}
+`
+
+const defaultWorklogsTemplate = `{{/* worklogs template */ -}}
+{{ range .worklogs }}- # {{.author.displayName}}, {{.created | age}} ago
+  comment: {{ or .comment "" }}
+  started: {{ .started }}
+  timeSpent: {{ .timeSpent }}
+
+{{end}}`

jiracli/unixproxy.go

@@ -1,4 +1,4 @@
-package jira
+package jiracli
 
 import (
 	"fmt"
@@ -8,16 +8,16 @@ import (
 	"time"
 )
 
-type Transport struct {
-	shadow http.Transport
+type transport struct {
+	shadow *http.Transport
 }
 
-func NewUnixProxyTransport(path string) *Transport {
+func newUnixProxyTransport(path string) *transport {
 	dial := func(network, addr string) (net.Conn, error) {
 		return net.Dial("unix", path)
 	}
 
-	shadow := http.Transport{
+	shadow := &http.Transport{
 		Dial:                  dial,
 		DialTLS:               dial,
 		DisableKeepAlives:     true,
@@ -25,14 +25,14 @@ func NewUnixProxyTransport(path string) *Transport {
 		ExpectContinueTimeout: 10 * time.Second,
 	}
 
-	return &Transport{shadow}
+	return &transport{shadow}
 }
 
-func UnixProxy(path string) *Transport {
-	return NewUnixProxyTransport(os.ExpandEnv(path))
+func unixProxy(path string) *transport {
+	return newUnixProxyTransport(os.ExpandEnv(path))
 }
 
-func (t *Transport) RoundTrip(req *http.Request) (*http.Response, error) {
+func (t *transport) RoundTrip(req *http.Request) (*http.Response, error) {
 	req2 := *req
 	url2 := *req.URL
 	req2.URL = &url2

jiracli/usage.go

@@ -0,0 +1,199 @@
+package jiracli
+
+import (
+	"fmt"
+	"os"
+	"os/exec"
+	"regexp"
+	"runtime"
+	"syscall"
+
+	"github.com/coryb/figtree"
+	"github.com/coryb/kingpeon"
+	"github.com/coryb/oreo"
+	jira "github.com/go-jira/jira"
+	kingpin "gopkg.in/alecthomas/kingpin.v2"
+)
+
+var usage = `{{define "FormatCommand"}}\
+{{if .FlagSummary}} {{.FlagSummary}}{{end}}\
+{{range .Args}} {{if not .Required}}[{{end}}<{{.Name}}>{{if .Value|IsCumulative}}...{{end}}{{if not .Required}}]{{end}}{{end}}\
+{{end}}\
+
+{{define "FormatBriefCommands"}}\
+{{range .FlattenedCommands}}\
+{{if not .Hidden}}\
+  {{ print .FullCommand ":" | printf "%-20s"}} {{.Help}}
+{{end}}\
+{{end}}\
+{{end}}\
+
+{{define "FormatCommands"}}\
+{{range .FlattenedCommands}}\
+{{if not .Hidden}}\
+  {{.FullCommand}}{{if .Default}}*{{end}}{{template "FormatCommand" .}}
+{{.Help|Wrap 4}}
+{{with .Flags|FlagsToTwoColumns}}{{FormatTwoColumnsWithIndent . 4 2}}{{end}}
+{{end}}\
+{{end}}\
+{{end}}\
+
+{{define "FormatUsage"}}\
+{{template "FormatCommand" .}}{{if .Commands}} <command> [<args> ...]{{end}}
+{{if .Help}}
+{{.Help|Wrap 0}}\
+{{end}}\
+
+{{end}}\
+
+{{if .Context.SelectedCommand}}\
+usage: {{.App.Name}} {{.Context.SelectedCommand}}{{template "FormatCommand" .Context.SelectedCommand}}
+{{if .Context.SelectedCommand.Aliases }}\
+{{range $top := .App.Commands}}\
+{{if eq $top.FullCommand $.Context.SelectedCommand.FullCommand}}\
+{{range $alias := $.Context.SelectedCommand.Aliases}}\
+alias: {{$.App.Name}} {{$alias}}{{template "FormatCommand" $.Context.SelectedCommand}}
+{{end}}\
+{{else}}\
+{{range $sub := $top.Commands}}\
+{{if eq $sub.FullCommand $.Context.SelectedCommand.FullCommand}}\
+{{range $alias := $.Context.SelectedCommand.Aliases}}\
+alias: {{$.App.Name}} {{$top.Name}} {{$alias}}{{template "FormatCommand" $.Context.SelectedCommand}}
+{{end}}\
+{{end}}\
+{{end}}\
+{{end}}\
+{{end}}\
+{{end}}
+{{if .Context.SelectedCommand.Help}}\
+{{.Context.SelectedCommand.Help|Wrap 0}}
+{{end}}\
+{{else}}\
+usage: {{.App.Name}}{{template "FormatUsage" .App}}
+{{end}}\
+
+{{if .App.Flags}}\
+Global flags:
+{{.App.Flags|FlagsToTwoColumns|FormatTwoColumns}}
+{{end}}\
+{{if .Context.SelectedCommand}}\
+{{if and .Context.SelectedCommand.Flags|RequiredFlags}}\
+Required flags:
+{{.Context.SelectedCommand.Flags|RequiredFlags|FlagsToTwoColumns|FormatTwoColumns}}
+{{end}}\
+{{if .Context.SelectedCommand.Flags|OptionalFlags}}\
+Optional flags:
+{{.Context.SelectedCommand.Flags|OptionalFlags|FlagsToTwoColumns|FormatTwoColumns}}
+{{end}}\
+{{end}}\
+{{if .Context.Args}}\
+Args:
+{{.Context.Args|ArgsToTwoColumns|FormatTwoColumns}}
+{{end}}\
+{{if .Context.SelectedCommand}}\
+{{if .Context.SelectedCommand.Commands}}\
+Subcommands:
+{{template "FormatCommands" .Context.SelectedCommand}}
+{{end}}\
+{{else if .App.Commands}}\
+Commands:
+{{template "FormatBriefCommands" .App}}
+{{end}}\
+`
+
+func CommandLine(fig *figtree.FigTree, o *oreo.Client) *kingpin.Application {
+	app := kingpin.New("jira", "Jira Command Line Interface")
+	app.HelpFlag.Short('h')
+	app.UsageWriter(os.Stdout)
+	app.ErrorWriter(os.Stderr)
+	app.Command("version", "Prints version").PreAction(func(*kingpin.ParseContext) error {
+		fmt.Println(jira.VERSION)
+		panic(Exit{Code: 0})
+	})
+	app.UsageTemplate(usage)
+
+	var verbosity int
+	app.Flag("verbose", "Increase verbosity for debugging").Short('v').PreAction(func(_ *kingpin.ParseContext) error {
+		os.Setenv("JIRA_DEBUG", fmt.Sprintf("%d", verbosity))
+		IncreaseLogLevel(1)
+		return nil
+	}).CounterVar(&verbosity)
+
+	app.Terminate(func(status int) {
+		for _, arg := range os.Args {
+			if arg == "-h" || arg == "--help" || len(os.Args) == 1 {
+				panic(Exit{Code: 0})
+			}
+		}
+		panic(Exit{Code: 1})
+	})
+
+	register(app, o, fig)
+
+	// register custom commands
+	data := struct {
+		CustomCommands kingpeon.DynamicCommands `yaml:"custom-commands" json:"custom-commands"`
+	}{}
+
+	if err := fig.LoadAllConfigs("config.yml", &data); err != nil {
+		log.Errorf("%s", err)
+		panic(Exit{Code: 1})
+	}
+
+	if len(data.CustomCommands) > 0 {
+		runner := syscall.Exec
+		if runtime.GOOS == "windows" {
+			runner = func(binary string, cmd []string, env []string) error {
+				command := exec.Command(binary, cmd[1:]...)
+				command.Stdin = os.Stdin
+				command.Stdout = os.Stdout
+				command.Stderr = os.Stderr
+				command.Env = env
+				return command.Run()
+			}
+		}
+
+		tmp := map[string]interface{}{}
+		fig.LoadAllConfigs("config.yml", &tmp)
+		kingpeon.RegisterDynamicCommandsWithRunner(runner, app, data.CustomCommands, TemplateProcessor())
+	}
+
+	return app
+}
+
+func ParseCommandLine(app *kingpin.Application, args []string) {
+	// checking for default usage of `jira ISSUE-123` but need to allow
+	// for global options first like: `jira --user mothra ISSUE-123`
+	ctx, err := app.ParseContext(args)
+	if err != nil && ctx == nil {
+		// This is an internal kingpin usage error, duplicate options/commands
+		log.Fatalf("error: %s, ctx: %v", err, ctx)
+	}
+
+	if ctx != nil {
+		if ctx.SelectedCommand == nil {
+			next := ctx.Next()
+			if next != nil {
+				if ok, err := regexp.MatchString("^([A-Z]+-)?[0-9]+$", next.Value); err != nil {
+					log.Errorf("Invalid Regex: %s", err)
+				} else if ok {
+					// insert "view" at i=1 (2nd position)
+					os.Args = append(os.Args[:1], append([]string{"view"}, os.Args[1:]...)...)
+				}
+			}
+		}
+	}
+
+	if _, err := app.Parse(os.Args[1:]); err != nil {
+		if _, ok := err.(*Error); ok {
+			log.Errorf("%s", err)
+			panic(Exit{Code: 1})
+		}
+		ctx, _ := app.ParseContext(os.Args[1:])
+		if ctx != nil {
+			app.UsageForContext(ctx)
+		}
+		log.Errorf("Invalid Usage: %s", err)
+		panic(Exit{Code: 1})
+	}
+}

jiracli/util.go

@@ -0,0 +1,180 @@
+package jiracli
+
+import (
+	"fmt"
+	"io"
+	"io/ioutil"
+	"os"
+	"path/filepath"
+	"runtime"
+	"time"
+
+	kingpin "gopkg.in/alecthomas/kingpin.v2"
+
+	"github.com/coryb/figtree"
+)
+
+func Homedir() string {
+	if runtime.GOOS == "windows" {
+		return os.Getenv("USERPROFILE")
+	}
+	return os.Getenv("HOME")
+}
+
+func findClosestParentPath(fileName string) (string, error) {
+	cwd, err := os.Getwd()
+	if err != nil {
+		return "", err
+	}
+	paths := figtree.FindParentPaths(Homedir(), cwd, fileName)
+	if len(paths) > 0 {
+		return paths[len(paths)-1], nil
+	}
+	return "", fmt.Errorf("%s not found in parent directory hierarchy", fileName)
+}
+
+func tmpYml(tmpFilePrefix string) (*os.File, error) {
+	fh, err := ioutil.TempFile("", filepath.Base(tmpFilePrefix))
+	if err != nil {
+		return nil, err
+	}
+	// now we need to rename the file since we dont control the file extensions
+	// ... it has to be `.yml` so that vim/emacs etc know what edit mode to apply
+	// for easier editing
+	oldFileName := fh.Name()
+	newFileName := oldFileName + ".yml"
+
+	// close tmpfile so we can rename on windows
+	fh.Close()
+
+	if err := os.Rename(oldFileName, newFileName); err != nil {
+		return nil, err
+	}
+
+	return os.OpenFile(newFileName, os.O_RDWR|os.O_EXCL, 0600)
+}
+
+func FlagValue(ctx *kingpin.ParseContext, name string) string {
+	for _, elem := range ctx.Elements {
+		if flag, ok := elem.Clause.(*kingpin.FlagClause); ok {
+			if flag.Model().Name == name {
+				return *elem.Value
+			}
+		}
+	}
+	return ""
+}
+
+func copyFile(src, dst string) (err error) {
+	var s, d *os.File
+	if s, err = os.Open(src); err == nil {
+		defer s.Close()
+		if d, err = os.Create(dst); err == nil {
+			if _, err = io.Copy(d, s); err != nil {
+				d.Close()
+				return
+			}
+			return d.Close()
+		}
+	}
+	return
+}
+
+func fuzzyAge(start string) (string, error) {
+	t, err := time.Parse("2006-01-02T15:04:05.000-0700", start)
+	if err != nil {
+		return "", err
+	}
+	delta := time.Since(t)
+	if delta.Minutes() < 2 {
+		return "a minute", nil
+	} else if dm := delta.Minutes(); dm < 45 {
+		return fmt.Sprintf("%d minutes", int(dm)), nil
+	} else if dm := delta.Minutes(); dm < 90 {
+		return "an hour", nil
+	} else if dh := delta.Hours(); dh < 24 {
+		return fmt.Sprintf("%d hours", int(dh)), nil
+	} else if dh := delta.Hours(); dh < 48 {
+		return "a day", nil
+	}
+	return fmt.Sprintf("%d days", int(delta.Hours()/24)), nil
+}
+
+func dateFormat(format string, content string) (string, error) {
+	t, err := time.Parse("2006-01-02T15:04:05.000-0700", content)
+	if err != nil {
+		return "", err
+	}
+	return t.Format(format), nil
+}
+
+// this is a HACK to make yaml parsed documents to be serializable
+// to json, so prevent this:
+// json: unsupported type: map[interface {}]interface {}
+// Also we want to clean up common input errors for the edit
+// templates, like dangling "\n"
+func yamlFixup(data interface{}) (interface{}, error) {
+	switch d := data.(type) {
+	case map[interface{}]interface{}:
+		// need to copy this map into a string map so json can encode it
+		copy := make(map[string]interface{})
+		for key, val := range d {
+			switch k := key.(type) {
+			case string:
+				if fixed, err := yamlFixup(val); err != nil {
+					return nil, err
+				} else if fixed != nil {
+					copy[k] = fixed
+				}
+			default:
+				err := fmt.Errorf("YAML: key %s is type '%T', require 'string'", key, k)
+				log.Errorf("%s", err)
+				return nil, err
+			}
+		}
+		if len(copy) == 0 {
+			return nil, nil
+		}
+		return copy, nil
+	case map[string]interface{}:
+		copy := make(map[string]interface{})
+		for k, v := range d {
+			if fixed, err := yamlFixup(v); err != nil {
+				return nil, err
+			} else if fixed != nil {
+				copy[k] = fixed
+			}
+		}
+		if len(copy) == 0 {
+			return nil, nil
+		}
+		return copy, nil
+	case []interface{}:
+		copy := make([]interface{}, 0, len(d))
+		for _, val := range d {
+			if fixed, err := yamlFixup(val); err != nil {
+				return nil, err
+			} else if fixed != nil {
+				copy = append(copy, fixed)
+			}
+		}
+		if len(copy) == 0 {
+			return nil, nil
+		}
+		return copy, nil
+	case *interface{}:
+		if fixed, err := yamlFixup(*d); err != nil {
+			return nil, err
+		} else if fixed != nil {
+			*d = fixed
+		}
+		return d, nil
+	case string:
+		if d == "" || d == "\n" {
+			return nil, nil
+		}
+		return d, nil
+	default:
+		return d, nil
+	}
+}

jiracmd/assign.go

@@ -0,0 +1,92 @@
+package jiracmd
+
+import (
+	"fmt"
+	"strings"
+
+	"github.com/coryb/figtree"
+	"github.com/coryb/oreo"
+	"github.com/go-jira/jira"
+	"github.com/go-jira/jira/jiracli"
+	kingpin "gopkg.in/alecthomas/kingpin.v2"
+)
+
+type AssignOptions struct {
+	jiracli.CommonOptions `yaml:",inline" json:",inline" figtree:",inline"`
+	Project               string `yaml:"project,omitempty" json:"project,omitempty"`
+	Issue                 string `yaml:"issue,omitempty" json:"issue,omitempty"`
+	Assignee              string `yaml:"assignee,omitempty" json:"assignee,omitempty"`
+}
+
+func CmdAssignRegistry() *jiracli.CommandRegistryEntry {
+	opts := AssignOptions{}
+
+	return &jiracli.CommandRegistryEntry{
+		"Assign user to issue",
+		func(fig *figtree.FigTree, cmd *kingpin.CmdClause) error {
+			jiracli.LoadConfigs(cmd, fig, &opts)
+			return CmdAssignUsage(cmd, &opts)
+		},
+		func(o *oreo.Client, globals *jiracli.GlobalOptions) error {
+			opts.Issue = jiracli.FormatIssue(opts.Issue, opts.Project)
+			return CmdAssign(o, globals, &opts)
+		},
+	}
+}
+
+func CmdAssignUsage(cmd *kingpin.CmdClause, opts *AssignOptions) error {
+	jiracli.BrowseUsage(cmd, &opts.CommonOptions)
+	cmd.Flag("default", "use default user for assignee").PreAction(func(ctx *kingpin.ParseContext) error {
+		if jiracli.FlagValue(ctx, "default") == "true" {
+			opts.Assignee = "-1"
+		}
+		return nil
+	}).Bool()
+	cmd.Arg("ISSUE", "issue to assign").Required().StringVar(&opts.Issue)
+	cmd.Arg("ASSIGNEE", "email or display name of user to assign to issue").StringVar(&opts.Assignee)
+	return nil
+}
+
+// CmdAssign will assign an issue to a user
+func CmdAssign(o *oreo.Client, globals *jiracli.GlobalOptions, opts *AssignOptions) error {
+	if globals.JiraDeploymentType.Value == "" {
+		serverInfo, err := jira.ServerInfo(o, globals.Endpoint.Value)
+		if err != nil {
+			return err
+		}
+		globals.JiraDeploymentType.Value = strings.ToLower(serverInfo.DeploymentType)
+	}
+
+	assignFunc := jira.IssueAssign
+	if globals.JiraDeploymentType.Value == jiracli.CloudDeploymentType {
+		if opts.Assignee != "" && opts.Assignee != "-1" {
+			users, err := jira.UserSearch(o, globals.Endpoint.Value, &jira.UserSearchOptions{
+				Query: opts.Assignee,
+			})
+			if err != nil {
+				return err
+			}
+			if len(users) > 1 {
+				return fmt.Errorf("Found %d accounts for users with username %q", len(users), opts.Assignee)
+			} else if len(users) == 1 {
+				opts.Assignee = users[0].AccountID
+			}
+		}
+		assignFunc = jira.IssueAssignAccountID
+	}
+
+	err := assignFunc(o, globals.Endpoint.Value, opts.Issue, opts.Assignee)
+	if err != nil {
+		return err
+	}
+
+	if !globals.Quiet.Value {
+		fmt.Printf("OK %s %s\n", opts.Issue, jira.URLJoin(globals.Endpoint.Value, "browse", opts.Issue))
+	}
+
+	if opts.Browse.Value {
+		return CmdBrowse(globals, opts.Issue)
+	}
+
+	return nil
+}

jiracmd/attachCreate.go

@@ -0,0 +1,101 @@
+package jiracmd
+
+import (
+	"fmt"
+	"os"
+	"sort"
+
+	"golang.org/x/crypto/ssh/terminal"
+
+	"github.com/coryb/figtree"
+	"github.com/coryb/oreo"
+	jira "github.com/go-jira/jira"
+	"github.com/go-jira/jira/jiracli"
+	kingpin "gopkg.in/alecthomas/kingpin.v2"
+	yaml "gopkg.in/coryb/yaml.v2"
+)
+
+type AttachCreateOptions struct {
+	jiracli.CommonOptions `yaml:",inline" json:",inline" figtree:",inline"`
+	Project               string `yaml:"project,omitempty" json:"project,omitempty"`
+	Issue                 string `yaml:"issue,omitempty" json:"issue,omitempty"`
+	Attachment            string `yaml:"attachment,omitempty" json:"attachment,omitempty"`
+	Filename              string `yaml:"filename,omitempty" json:"filename,omitempty"`
+	SaveFile              string `yaml:"savefile,omitempty" json:"savefile,omitempty"`
+}
+
+func CmdAttachCreateRegistry() *jiracli.CommandRegistryEntry {
+	opts := AttachCreateOptions{}
+
+	return &jiracli.CommandRegistryEntry{
+		"Attach file to issue",
+		func(fig *figtree.FigTree, cmd *kingpin.CmdClause) error {
+			jiracli.LoadConfigs(cmd, fig, &opts)
+			return CmdAttachCreateUsage(cmd, &opts)
+		},
+		func(o *oreo.Client, globals *jiracli.GlobalOptions) error {
+			opts.Issue = jiracli.FormatIssue(opts.Issue, opts.Project)
+			return CmdAttachCreate(o, globals, &opts)
+		},
+	}
+}
+
+func CmdAttachCreateUsage(cmd *kingpin.CmdClause, opts *AttachCreateOptions) error {
+	jiracli.BrowseUsage(cmd, &opts.CommonOptions)
+	cmd.Flag("saveFile", "Write attachment information as yaml to file").StringVar(&opts.SaveFile)
+	cmd.Flag("filename", "Filename to use for attachment").Short('f').StringVar(&opts.Filename)
+	cmd.Arg("ISSUE", "issue to assign").Required().StringVar(&opts.Issue)
+	cmd.Arg("ATTACHMENT", "File to attach to issue, if not provided read from stdin").StringVar(&opts.Attachment)
+	return nil
+}
+
+func CmdAttachCreate(o *oreo.Client, globals *jiracli.GlobalOptions, opts *AttachCreateOptions) error {
+	var contents *os.File
+	var err error
+	if opts.Attachment == "" {
+		if terminal.IsTerminal(int(os.Stdin.Fd())) {
+			return fmt.Errorf("ATTACHMENT argument required or redirect from STDIN")
+		}
+		contents = os.Stdin
+		if opts.Filename == "" {
+			return fmt.Errorf("--filename required when reading from stdin")
+		}
+	} else {
+		contents, err = os.Open(opts.Attachment)
+		if err != nil {
+			return err
+		}
+		if opts.Filename == "" {
+			opts.Filename = opts.Attachment
+		}
+	}
+	attachments, err := jira.IssueAttachFile(o, globals.Endpoint.Value, opts.Issue, opts.Filename, contents)
+	if err != nil {
+		return err
+	}
+
+	sort.Sort(sort.Reverse(attachments))
+
+	if opts.SaveFile != "" {
+		fh, err := os.Create(opts.SaveFile)
+		if err != nil {
+			return err
+		}
+		defer fh.Close()
+		out, err := yaml.Marshal((*attachments)[0])
+		if err != nil {
+			return err
+		}
+		fh.Write(out)
+	}
+
+	if !globals.Quiet.Value {
+		fmt.Printf("OK %d %s\n", (*attachments)[0].ID, (*attachments)[0].Content)
+	}
+
+	if opts.Browse.Value {
+		return CmdBrowse(globals, opts.Issue)
+	}
+
+	return nil
+}

jiracmd/attachGet.go

@@ -0,0 +1,79 @@
+package jiracmd
+
+import (
+	"fmt"
+	"io"
+	"os"
+
+	"github.com/coryb/figtree"
+	"github.com/coryb/oreo"
+	jira "github.com/go-jira/jira"
+	"github.com/go-jira/jira/jiracli"
+	kingpin "gopkg.in/alecthomas/kingpin.v2"
+)
+
+type AttachGetOptions struct {
+	AttachmentID string `yaml:"attachment-id,omitempty" json:"attachment-id,omitempty"`
+	OutputFile   string `yaml:"output-file,omitempty" json:"output-file,omitempty"`
+}
+
+func CmdAttachGetRegistry() *jiracli.CommandRegistryEntry {
+	opts := AttachGetOptions{}
+
+	return &jiracli.CommandRegistryEntry{
+		"Fetch attachment",
+		func(fig *figtree.FigTree, cmd *kingpin.CmdClause) error {
+			jiracli.LoadConfigs(cmd, fig, &opts)
+			return CmdAttachGetUsage(cmd, &opts)
+		},
+		func(o *oreo.Client, globals *jiracli.GlobalOptions) error {
+			return CmdAttachGet(o, globals, &opts)
+		},
+	}
+}
+
+func CmdAttachGetUsage(cmd *kingpin.CmdClause, opts *AttachGetOptions) error {
+	cmd.Flag("output", "Write attachment to specified file name, '-' for stdout").Short('o').StringVar(&opts.OutputFile)
+	cmd.Arg("ATTACHMENT-ID", "Attachment id to fetch").StringVar(&opts.AttachmentID)
+	return nil
+}
+
+func CmdAttachGet(o *oreo.Client, globals *jiracli.GlobalOptions, opts *AttachGetOptions) error {
+	attachment, err := jira.GetAttachment(o, globals.Endpoint.Value, opts.AttachmentID)
+	if err != nil {
+		return err
+	}
+
+	resp, err := o.Get(attachment.Content)
+	if err != nil {
+		return err
+	}
+	defer resp.Body.Close()
+
+	var output *os.File
+	if opts.OutputFile == "-" {
+		output = os.Stdout
+	} else if opts.OutputFile != "" {
+		output, err = os.Create(opts.OutputFile)
+		if err != nil {
+			return err
+		}
+		defer output.Close()
+	} else {
+		output, err = os.Create(attachment.Filename)
+		if err != nil {
+			return err
+		}
+		defer output.Close()
+	}
+
+	_, err = io.Copy(output, resp.Body)
+	if err != nil {
+		return err
+	}
+	output.Close()
+	if opts.OutputFile != "-" && !globals.Quiet.Value {
+		fmt.Printf("OK Wrote %s\n", output.Name())
+	}
+	return nil
+}

jiracmd/attachList.go

@@ -0,0 +1,69 @@
+package jiracmd
+
+import (
+	"sort"
+
+	"github.com/coryb/figtree"
+	"github.com/coryb/oreo"
+	"github.com/go-jira/jira"
+	"github.com/go-jira/jira/jiracli"
+	"github.com/go-jira/jira/jiradata"
+	kingpin "gopkg.in/alecthomas/kingpin.v2"
+)
+
+type AttachListOptions struct {
+	jiracli.CommonOptions `yaml:",inline" json:",inline" figtree:",inline"`
+	Project               string `yaml:"project,omitempty" json:"project,omitempty"`
+	Issue                 string `yaml:"issue,omitempty" json:"issue,omitempty"`
+}
+
+func CmdAttachListRegistry() *jiracli.CommandRegistryEntry {
+	opts := AttachListOptions{
+		CommonOptions: jiracli.CommonOptions{
+			Template: figtree.NewStringOption("attach-list"),
+		},
+	}
+
+	return &jiracli.CommandRegistryEntry{
+		"Prints attachment details for issue",
+		func(fig *figtree.FigTree, cmd *kingpin.CmdClause) error {
+			jiracli.LoadConfigs(cmd, fig, &opts)
+			return CmdAttachListUsage(cmd, &opts)
+		},
+		func(o *oreo.Client, globals *jiracli.GlobalOptions) error {
+			opts.Issue = jiracli.FormatIssue(opts.Issue, opts.Project)
+			return CmdAttachList(o, globals, &opts)
+		},
+	}
+}
+
+func CmdAttachListUsage(cmd *kingpin.CmdClause, opts *AttachListOptions) error {
+	jiracli.BrowseUsage(cmd, &opts.CommonOptions)
+	jiracli.TemplateUsage(cmd, &opts.CommonOptions)
+	cmd.Arg("ISSUE", "Issue id to lookup attachments").Required().StringVar(&opts.Issue)
+	return nil
+}
+
+func CmdAttachList(o *oreo.Client, globals *jiracli.GlobalOptions, opts *AttachListOptions) error {
+	data, err := jira.GetIssue(o, globals.Endpoint.Value, opts.Issue, nil)
+	if err != nil {
+		return err
+	}
+
+	// need to conver the interface{} "attachment" field to an actual
+	// ListOfAttachment object so we can sort it
+	var attachments jiradata.ListOfAttachment
+	err = jiracli.ConvertType(data.Fields["attachment"], &attachments)
+	if err != nil {
+		return err
+	}
+	sort.Sort(&attachments)
+
+	if err := opts.PrintTemplate(attachments); err != nil {
+		return err
+	}
+	if opts.Browse.Value {
+		return CmdBrowse(globals, opts.Issue)
+	}
+	return nil
+}

jiracmd/attachRemove.go

@@ -0,0 +1,46 @@
+package jiracmd
+
+import (
+	"fmt"
+
+	"github.com/coryb/figtree"
+	"github.com/coryb/oreo"
+	jira "github.com/go-jira/jira"
+	"github.com/go-jira/jira/jiracli"
+	kingpin "gopkg.in/alecthomas/kingpin.v2"
+)
+
+type AttachRemoveOptions struct {
+	AttachmentID string `yaml:"attachment-id,omitempty" json:"attachment-id,omitempty"`
+}
+
+func CmdAttachRemoveRegistry() *jiracli.CommandRegistryEntry {
+	opts := AttachRemoveOptions{}
+
+	return &jiracli.CommandRegistryEntry{
+		"Delete attachment",
+		func(fig *figtree.FigTree, cmd *kingpin.CmdClause) error {
+			jiracli.LoadConfigs(cmd, fig, &opts)
+			return CmdAttachRemoveUsage(cmd, &opts)
+		},
+		func(o *oreo.Client, globals *jiracli.GlobalOptions) error {
+			return CmdAttachRemove(o, globals, &opts)
+		},
+	}
+}
+
+func CmdAttachRemoveUsage(cmd *kingpin.CmdClause, opts *AttachRemoveOptions) error {
+	cmd.Arg("ATTACHMENT-ID", "Attachment id to fetch").StringVar(&opts.AttachmentID)
+	return nil
+}
+
+func CmdAttachRemove(o *oreo.Client, globals *jiracli.GlobalOptions, opts *AttachRemoveOptions) error {
+	if err := jira.RemoveAttachment(o, globals.Endpoint.Value, opts.AttachmentID); err != nil {
+		return err
+	}
+
+	if !globals.Quiet.Value {
+		fmt.Printf("OK Deleted Attachment %s\n", opts.AttachmentID)
+	}
+	return nil
+}

jiracmd/block.go

@@ -0,0 +1,83 @@
+package jiracmd
+
+import (
+	"fmt"
+
+	"github.com/coryb/figtree"
+	"github.com/coryb/oreo"
+
+	"github.com/go-jira/jira"
+	"github.com/go-jira/jira/jiracli"
+	"github.com/go-jira/jira/jiradata"
+	kingpin "gopkg.in/alecthomas/kingpin.v2"
+)
+
+type BlockOptions struct {
+	jiracli.CommonOptions     `yaml:",inline" json:",inline" figtree:",inline"`
+	jiradata.LinkIssueRequest `yaml:",inline" json:",inline" figtree:",inline"`
+	Project                   string `yaml:"project,omitempty" json:"project,omitempty"`
+}
+
+func CmdBlockRegistry() *jiracli.CommandRegistryEntry {
+	opts := BlockOptions{
+		CommonOptions: jiracli.CommonOptions{
+			Template: figtree.NewStringOption("edit"),
+		},
+		LinkIssueRequest: jiradata.LinkIssueRequest{
+			Type: &jiradata.IssueLinkType{
+				Name: "Blocks",
+			},
+			InwardIssue:  &jiradata.IssueRef{},
+			OutwardIssue: &jiradata.IssueRef{},
+		},
+	}
+
+	return &jiracli.CommandRegistryEntry{
+		"Mark issues as blocker",
+		func(fig *figtree.FigTree, cmd *kingpin.CmdClause) error {
+			jiracli.LoadConfigs(cmd, fig, &opts)
+			return CmdBlockUsage(cmd, &opts)
+		},
+		func(o *oreo.Client, globals *jiracli.GlobalOptions) error {
+			opts.OutwardIssue.Key = jiracli.FormatIssue(opts.OutwardIssue.Key, opts.Project)
+			opts.InwardIssue.Key = jiracli.FormatIssue(opts.InwardIssue.Key, opts.Project)
+			return CmdBlock(o, globals, &opts)
+		},
+	}
+}
+
+func CmdBlockUsage(cmd *kingpin.CmdClause, opts *BlockOptions) error {
+	jiracli.BrowseUsage(cmd, &opts.CommonOptions)
+	jiracli.EditorUsage(cmd, &opts.CommonOptions)
+	jiracli.TemplateUsage(cmd, &opts.CommonOptions)
+	cmd.Flag("comment", "Comment message when marking issue as blocker").Short('m').PreAction(func(ctx *kingpin.ParseContext) error {
+		opts.Comment = &jiradata.Comment{
+			Body: jiracli.FlagValue(ctx, "comment"),
+		}
+		return nil
+	}).String()
+	cmd.Arg("ISSUE", "issue that is blocked").Required().StringVar(&opts.OutwardIssue.Key)
+	cmd.Arg("BLOCKER", "blocker issue").Required().StringVar(&opts.InwardIssue.Key)
+	return nil
+}
+
+// CmdBlock will update the given issue as being a duplicate by the given dup issue
+// and will attempt to resolve the dup issue
+func CmdBlock(o *oreo.Client, globals *jiracli.GlobalOptions, opts *BlockOptions) error {
+	if err := jira.LinkIssues(o, globals.Endpoint.Value, &opts.LinkIssueRequest); err != nil {
+		return err
+	}
+
+	if !globals.Quiet.Value {
+		fmt.Printf("OK %s %s\n", opts.InwardIssue.Key, jira.URLJoin(globals.Endpoint.Value, "browse", opts.InwardIssue.Key))
+		fmt.Printf("OK %s %s\n", opts.OutwardIssue.Key, jira.URLJoin(globals.Endpoint.Value, "browse", opts.OutwardIssue.Key))
+	}
+
+	if opts.Browse.Value {
+		if err := CmdBrowse(globals, opts.InwardIssue.Key); err != nil {
+			return CmdBrowse(globals, opts.OutwardIssue.Key)
+		}
+	}
+
+	return nil
+}

jiracmd/browse.go

@@ -0,0 +1,37 @@
+package jiracmd
+
+import (
+	"github.com/coryb/figtree"
+	"github.com/coryb/oreo"
+	jira "github.com/go-jira/jira"
+	"github.com/go-jira/jira/jiracli"
+	"github.com/pkg/browser"
+	kingpin "gopkg.in/alecthomas/kingpin.v2"
+)
+
+type BrowseOptions struct {
+	Project string `yaml:"project,omitempty" json:"project,omitempty"`
+	Issue   string `yaml:"issue,omitempty" json:"issue,omitempty"`
+}
+
+func CmdBrowseRegistry() *jiracli.CommandRegistryEntry {
+	opts := BrowseOptions{}
+
+	return &jiracli.CommandRegistryEntry{
+		"Open issue in browser",
+		func(fig *figtree.FigTree, cmd *kingpin.CmdClause) error {
+			cmd.Arg("ISSUE", "Issue to browse to").Required().StringVar(&opts.Issue)
+			jiracli.LoadConfigs(cmd, fig, &opts)
+			return nil
+		},
+		func(o *oreo.Client, globals *jiracli.GlobalOptions) error {
+			opts.Issue = jiracli.FormatIssue(opts.Issue, opts.Project)
+			return CmdBrowse(globals, opts.Issue)
+		},
+	}
+}
+
+// CmdBrowse open the default system browser to the provided issue
+func CmdBrowse(globals *jiracli.GlobalOptions, issue string) error {
+	return browser.OpenURL(jira.URLJoin(globals.Endpoint.Value, "browse", issue))
+}

jiracmd/comment.go

@@ -0,0 +1,81 @@
+package jiracmd
+
+import (
+	"fmt"
+
+	"github.com/coryb/figtree"
+	"github.com/coryb/oreo"
+
+	"github.com/go-jira/jira"
+	"github.com/go-jira/jira/jiracli"
+	"github.com/go-jira/jira/jiradata"
+	kingpin "gopkg.in/alecthomas/kingpin.v2"
+)
+
+type CommentOptions struct {
+	jiracli.CommonOptions `yaml:",inline" json:",inline" figtree:",inline"`
+	Project               string            `yaml:"project,omitempty" json:"project,omitempty"`
+	Overrides             map[string]string `yaml:"overrides,omitempty" json:"overrides,omitempty"`
+	Issue                 string            `yaml:"issue,omitempty" json:"issue,omitempty"`
+}
+
+func CmdCommentRegistry() *jiracli.CommandRegistryEntry {
+	opts := CommentOptions{
+		CommonOptions: jiracli.CommonOptions{
+			Template: figtree.NewStringOption("comment"),
+		},
+		Overrides: map[string]string{},
+	}
+
+	return &jiracli.CommandRegistryEntry{
+		"Add comment to issue",
+		func(fig *figtree.FigTree, cmd *kingpin.CmdClause) error {
+			jiracli.LoadConfigs(cmd, fig, &opts)
+			return CmdCommentUsage(cmd, &opts)
+		},
+		func(o *oreo.Client, globals *jiracli.GlobalOptions) error {
+			opts.Issue = jiracli.FormatIssue(opts.Issue, opts.Project)
+			return CmdComment(o, globals, &opts)
+		},
+	}
+}
+
+func CmdCommentUsage(cmd *kingpin.CmdClause, opts *CommentOptions) error {
+	jiracli.BrowseUsage(cmd, &opts.CommonOptions)
+	jiracli.EditorUsage(cmd, &opts.CommonOptions)
+	jiracli.TemplateUsage(cmd, &opts.CommonOptions)
+	cmd.Flag("noedit", "Disable opening the editor").SetValue(&opts.SkipEditing)
+	cmd.Flag("comment", "Comment message for issue").Short('m').PreAction(func(ctx *kingpin.ParseContext) error {
+		opts.Overrides["comment"] = jiracli.FlagValue(ctx, "comment")
+		return nil
+	}).String()
+	cmd.Arg("ISSUE", "issue id to update").StringVar(&opts.Issue)
+	return nil
+}
+
+// CmdComment will update issue with comment
+func CmdComment(o *oreo.Client, globals *jiracli.GlobalOptions, opts *CommentOptions) error {
+	comment := jiradata.Comment{}
+	input := struct {
+		Overrides map[string]string `yaml:"overrides,omitempty" json:"overrides,omitempty"`
+	}{
+		opts.Overrides,
+	}
+	err := jiracli.EditLoop(&opts.CommonOptions, &input, &comment, func() error {
+		_, err := jira.IssueAddComment(o, globals.Endpoint.Value, opts.Issue, &comment)
+		return err
+	})
+	if err != nil {
+		return err
+	}
+
+	if !globals.Quiet.Value {
+		fmt.Printf("OK %s %s\n", opts.Issue, jira.URLJoin(globals.Endpoint.Value, "browse", opts.Issue))
+	}
+
+	if opts.Browse.Value {
+		return CmdBrowse(globals, opts.Issue)
+	}
+
+	return nil
+}

jiracmd/componentAdd.go

@@ -0,0 +1,67 @@
+package jiracmd
+
+import (
+	"fmt"
+
+	"github.com/coryb/figtree"
+	"github.com/coryb/oreo"
+
+	"github.com/go-jira/jira"
+	"github.com/go-jira/jira/jiracli"
+	"github.com/go-jira/jira/jiradata"
+	kingpin "gopkg.in/alecthomas/kingpin.v2"
+)
+
+type ComponentAddOptions struct {
+	jiracli.CommonOptions `yaml:",inline" json:",inline" figtree:",inline"`
+	jiradata.Component    `yaml:",inline" json:",inline" figtree:",inline"`
+}
+
+func CmdComponentAddRegistry() *jiracli.CommandRegistryEntry {
+	opts := ComponentAddOptions{
+		CommonOptions: jiracli.CommonOptions{
+			Template: figtree.NewStringOption("component-add"),
+		},
+	}
+
+	return &jiracli.CommandRegistryEntry{
+		"Add component",
+		func(fig *figtree.FigTree, cmd *kingpin.CmdClause) error {
+			jiracli.LoadConfigs(cmd, fig, &opts)
+			return CmdComponentAddUsage(cmd, &opts)
+		},
+		func(o *oreo.Client, globals *jiracli.GlobalOptions) error {
+			return CmdComponentAdd(o, globals, &opts)
+		},
+	}
+}
+
+func CmdComponentAddUsage(cmd *kingpin.CmdClause, opts *ComponentAddOptions) error {
+	jiracli.EditorUsage(cmd, &opts.CommonOptions)
+	jiracli.TemplateUsage(cmd, &opts.CommonOptions)
+	cmd.Flag("noedit", "Disable opening the editor").SetValue(&opts.SkipEditing)
+	cmd.Flag("project", "project to create component in").Short('p').StringVar(&opts.Project)
+	cmd.Flag("name", "name of component").Short('n').StringVar(&opts.Name)
+	cmd.Flag("description", "description of component").Short('d').StringVar(&opts.Description)
+	cmd.Flag("lead", "person that acts as lead for component").Short('l').StringVar(&opts.LeadUserName)
+	return nil
+}
+
+// CmdComponentAdd sends the provided overrides to the "component-add" template for editing, then
+// will parse the edited document as YAML and submit the document to jira.
+func CmdComponentAdd(o *oreo.Client, globals *jiracli.GlobalOptions, opts *ComponentAddOptions) error {
+	var err error
+	component := &jiradata.Component{}
+	err = jiracli.EditLoop(&opts.CommonOptions, &opts.Component, component, func() error {
+		_, err = jira.CreateComponent(o, globals.Endpoint.Value, component)
+		return err
+	})
+	if err != nil {
+		return err
+	}
+
+	if !globals.Quiet.Value {
+		fmt.Printf("OK %s %s\n", component.Project, component.Name)
+	}
+	return nil
+}

jiracmd/components.go

@@ -0,0 +1,56 @@
+package jiracmd
+
+import (
+	"fmt"
+
+	"github.com/coryb/figtree"
+	"github.com/coryb/oreo"
+
+	"github.com/go-jira/jira"
+	"github.com/go-jira/jira/jiracli"
+	kingpin "gopkg.in/alecthomas/kingpin.v2"
+)
+
+type ComponentsOptions struct {
+	jiracli.CommonOptions `yaml:",inline" json:",inline" figtree:",inline"`
+	Project               string `yaml:"project,omitempty" json:"project,omitempty"`
+}
+
+func CmdComponentsRegistry() *jiracli.CommandRegistryEntry {
+	opts := ComponentsOptions{
+		CommonOptions: jiracli.CommonOptions{
+			Template: figtree.NewStringOption("components"),
+		},
+	}
+
+	return &jiracli.CommandRegistryEntry{
+		"Show components for a project",
+		func(fig *figtree.FigTree, cmd *kingpin.CmdClause) error {
+			jiracli.LoadConfigs(cmd, fig, &opts)
+			return CmdComponentsUsage(cmd, &opts)
+		},
+		func(o *oreo.Client, globals *jiracli.GlobalOptions) error {
+			return CmdComponents(o, globals, &opts)
+		},
+	}
+}
+
+func CmdComponentsUsage(cmd *kingpin.CmdClause, opts *ComponentsOptions) error {
+	jiracli.TemplateUsage(cmd, &opts.CommonOptions)
+	jiracli.GJsonQueryUsage(cmd, &opts.CommonOptions)
+	cmd.Flag("project", "project to list components").Short('p').StringVar(&opts.Project)
+
+	return nil
+}
+
+// CmdComponents will get available components for project and send to the  "components" template
+func CmdComponents(o *oreo.Client, globals *jiracli.GlobalOptions, opts *ComponentsOptions) error {
+	if opts.Project == "" {
+		return fmt.Errorf("Project Required.")
+	}
+	data, err := jira.GetProjectComponents(o, globals.Endpoint.Value, opts.Project)
+	if err != nil {
+		return err
+	}
+	return opts.PrintTemplate(data)
+}

jiracmd/create.go

@@ -0,0 +1,183 @@
+package jiracmd
+
+import (
+	"fmt"
+	"os"
+	"strings"
+
+	"github.com/coryb/figtree"
+	"github.com/coryb/oreo"
+
+	"github.com/go-jira/jira"
+	"github.com/go-jira/jira/jiracli"
+	"github.com/go-jira/jira/jiradata"
+	kingpin "gopkg.in/alecthomas/kingpin.v2"
+	yaml "gopkg.in/coryb/yaml.v2"
+)
+
+type CreateOptions struct {
+	jiracli.CommonOptions `yaml:",inline" json:",inline" figtree:",inline"`
+	jiradata.IssueUpdate  `yaml:",inline" json:",inline" figtree:",inline"`
+	Project               string            `yaml:"project,omitempty" json:"project,omitempty"`
+	Summary               string            `yaml:"summary,omitempty" json:"summary`
+	IssueType             string            `yaml:"issuetype,omitempty" json:"issuetype,omitempty"`
+	Overrides             map[string]string `yaml:"overrides,omitempty" json:"overrides,omitempty"`
+	SaveFile              string            `yaml:"savefile,omitempty" json:"savefile,omitempty"`
+}
+
+func CmdCreateRegistry() *jiracli.CommandRegistryEntry {
+	opts := CreateOptions{
+		CommonOptions: jiracli.CommonOptions{
+			Template: figtree.NewStringOption("create"),
+		},
+		Overrides: map[string]string{},
+	}
+
+	return &jiracli.CommandRegistryEntry{
+		"Create issue",
+		func(fig *figtree.FigTree, cmd *kingpin.CmdClause) error {
+			jiracli.LoadConfigs(cmd, fig, &opts)
+			return CmdCreateUsage(cmd, &opts)
+		},
+		func(o *oreo.Client, globals *jiracli.GlobalOptions) error {
+			return CmdCreate(o, globals, &opts)
+		},
+	}
+}
+
+func CmdCreateUsage(cmd *kingpin.CmdClause, opts *CreateOptions) error {
+	jiracli.BrowseUsage(cmd, &opts.CommonOptions)
+	jiracli.EditorUsage(cmd, &opts.CommonOptions)
+	jiracli.FileUsage(cmd, &opts.CommonOptions)
+	jiracli.TemplateUsage(cmd, &opts.CommonOptions)
+	cmd.Flag("noedit", "Disable opening the editor").SetValue(&opts.SkipEditing)
+	cmd.Flag("project", "project to create issue in").Short('p').StringVar(&opts.Project)
+	cmd.Flag("summary", "Summary of the issue").Short('s').StringVar(&opts.Summary)
+	cmd.Flag("issuetype", "issuetype in to create").Short('i').StringVar(&opts.IssueType)
+	cmd.Flag("comment", "Comment message for issue").Short('m').PreAction(func(ctx *kingpin.ParseContext) error {
+		opts.Overrides["comment"] = jiracli.FlagValue(ctx, "comment")
+		return nil
+	}).String()
+	cmd.Flag("override", "Set issue property").Short('o').StringMapVar(&opts.Overrides)
+	cmd.Flag("saveFile", "Write issue as yaml to file").StringVar(&opts.SaveFile)
+	return nil
+}
+
+// CmdCreate sends the create-metadata to the "create" template for editing, then
+// will parse the edited document as YAML and submit the document to jira.
+func CmdCreate(o *oreo.Client, globals *jiracli.GlobalOptions, opts *CreateOptions) error {
+	if globals.JiraDeploymentType.Value == "" {
+		serverInfo, err := jira.ServerInfo(o, globals.Endpoint.Value)
+		if err != nil {
+			return err
+		}
+		globals.JiraDeploymentType.Value = strings.ToLower(serverInfo.DeploymentType)
+	}
+
+	type templateInput struct {
+		Meta      *jiradata.IssueType `yaml:"meta" json:"meta"`
+		Overrides map[string]string   `yaml:"overrides" json:"overrides"`
+	}
+
+	if err := defaultIssueType(o, globals.Endpoint.Value, &opts.Project, &opts.IssueType); err != nil {
+		return err
+	}
+	createMeta, err := jira.GetIssueCreateMetaIssueType(o, globals.Endpoint.Value, opts.Project, opts.IssueType)
+	if err != nil {
+		return err
+	}
+
+	issueUpdate := jiradata.IssueUpdate{}
+	input := templateInput{
+		Meta:      createMeta,
+		Overrides: opts.Overrides,
+	}
+	input.Overrides["project"] = opts.Project
+	if opts.Summary != "" {
+		input.Overrides["summary"] = opts.Summary
+	}
+	input.Overrides["issuetype"] = opts.IssueType
+	input.Overrides["login"] = globals.Login.Value
+
+	var issueResp *jiradata.IssueCreateResponse
+	var fnameOptsFile string
+	fnameOptsFile = opts.File.String()
+	if fnameOptsFile != "" {
+		err = jiracli.ReadYmlInputFile(&opts.CommonOptions, &input, &issueUpdate, func() error {
+			issueResp, err = jira.CreateIssue(o, globals.Endpoint.Value, &issueUpdate)
+			return err
+		})
+	} else {
+		err = jiracli.EditLoop(&opts.CommonOptions, &input, &issueUpdate, func() error {
+			if globals.JiraDeploymentType.Value == jiracli.CloudDeploymentType {
+				err := fixGDPRUserFields(o, globals.Endpoint.Value, createMeta.Fields, issueUpdate.Fields)
+				if err != nil {
+					return err
+				}
+			}
+			issueResp, err = jira.CreateIssue(o, globals.Endpoint.Value, &issueUpdate)
+			return err
+		})
+	}
+	if err != nil {
+		return err
+	}
+
+	browseLink := jira.URLJoin(globals.Endpoint.Value, "browse", issueResp.Key)
+	if !globals.Quiet.Value {
+		fmt.Printf("OK %s %s\n", issueResp.Key, browseLink)
+	}
+
+	if opts.SaveFile != "" {
+		fh, err := os.Create(opts.SaveFile)
+		if err != nil {
+			return err
+		}
+		defer fh.Close()
+		out, err := yaml.Marshal(map[string]string{
+			"issue": issueResp.Key,
+			"link":  browseLink,
+		})
+		if err != nil {
+			return err
+		}
+		fh.Write(out)
+	}
+
+	if opts.Browse.Value {
+		return CmdBrowse(globals, issueResp.Key)
+	}
+	return nil
+}
+
+func defaultIssueType(o *oreo.Client, endpoint string, project, issuetype *string) error {
+	if project == nil || *project == "" {
+		return fmt.Errorf("Project undefined, please use --project argument or set the `project` config property")
+	}
+	if issuetype != nil && *issuetype != "" {
+		return nil
+	}
+	projectMeta, err := jira.GetIssueCreateMetaProject(o, endpoint, *project)
+	if err != nil {
+		return err
+	}
+
+	issueTypes := map[string]bool{}
+
+	for _, issuetype := range projectMeta.IssueTypes {
+		issueTypes[issuetype.Name] = true
+	}
+
+	//  prefer "Bug" type
+	if _, ok := issueTypes["Bug"]; ok {
+		*issuetype = "Bug"
+		return nil
+	}
+	// next best default it "Task"
+	if _, ok := issueTypes["Task"]; ok {
+		*issuetype = "Task"
+		return nil
+	}
+
+	return fmt.Errorf("Unable to find default issueType of Bug or Task, please set --issuetype argument or set the `issuetype` config property")
+}

jiracmd/createmeta.go

@@ -0,0 +1,54 @@
+package jiracmd
+
+import (
+	"github.com/coryb/figtree"
+	"github.com/coryb/oreo"
+	"github.com/go-jira/jira"
+	"github.com/go-jira/jira/jiracli"
+	kingpin "gopkg.in/alecthomas/kingpin.v2"
+)
+
+type CreateMetaOptions struct {
+	jiracli.CommonOptions `yaml:",inline" json:",inline" figtree:",inline"`
+	Project               string `yaml:"project,omitempty" json:"project,omitempty"`
+	IssueType             string `yaml:"issuetype,omitempty" json:"issuetype,omitempty"`
+}
+
+func CmdCreateMetaRegistry() *jiracli.CommandRegistryEntry {
+	opts := CreateMetaOptions{
+		CommonOptions: jiracli.CommonOptions{
+			Template: figtree.NewStringOption("createmeta"),
+		},
+	}
+
+	return &jiracli.CommandRegistryEntry{
+		"View 'create' metadata",
+		func(fig *figtree.FigTree, cmd *kingpin.CmdClause) error {
+			jiracli.LoadConfigs(cmd, fig, &opts)
+			return CmdCreateMetaUsage(cmd, &opts)
+		},
+		func(o *oreo.Client, globals *jiracli.GlobalOptions) error {
+			return CmdCreateMeta(o, globals, &opts)
+		},
+	}
+}
+
+func CmdCreateMetaUsage(cmd *kingpin.CmdClause, opts *CreateMetaOptions) error {
+	jiracli.TemplateUsage(cmd, &opts.CommonOptions)
+	jiracli.GJsonQueryUsage(cmd, &opts.CommonOptions)
+	cmd.Flag("project", "project to fetch create metadata").Short('p').StringVar(&opts.Project)
+	cmd.Flag("issuetype", "issuetype in project to fetch create metadata").Short('i').StringVar(&opts.IssueType)
+	return nil
+}
+
+// Create will get issue create metadata and send to "createmeta" template
+func CmdCreateMeta(o *oreo.Client, globals *jiracli.GlobalOptions, opts *CreateMetaOptions) error {
+	if err := defaultIssueType(o, globals.Endpoint.Value, &opts.Project, &opts.IssueType); err != nil {
+		return err
+	}
+	createMeta, err := jira.GetIssueCreateMetaIssueType(o, globals.Endpoint.Value, opts.Project, opts.IssueType)
+	if err != nil {
+		return err
+	}
+	return opts.PrintTemplate(createMeta)
+}

jiracmd/dup.go

@@ -0,0 +1,118 @@
+package jiracmd
+
+import (
+	"fmt"
+
+	"github.com/coryb/figtree"
+	"github.com/coryb/oreo"
+
+	"github.com/go-jira/jira"
+	"github.com/go-jira/jira/jiracli"
+	"github.com/go-jira/jira/jiradata"
+	kingpin "gopkg.in/alecthomas/kingpin.v2"
+)
+
+type DupOptions struct {
+	jiracli.CommonOptions     `yaml:",inline" json:",inline" figtree:",inline"`
+	jiradata.LinkIssueRequest `yaml:",inline" json:",inline" figtree:",inline"`
+	Project                   string `yaml:"project,omitempty" json:"project,omitempty"`
+}
+
+func CmdDupRegistry() *jiracli.CommandRegistryEntry {
+	opts := DupOptions{
+		CommonOptions: jiracli.CommonOptions{
+			Template: figtree.NewStringOption("edit"),
+		},
+		LinkIssueRequest: jiradata.LinkIssueRequest{
+			Type: &jiradata.IssueLinkType{
+				Name: "Duplicate",
+			},
+			InwardIssue:  &jiradata.IssueRef{},
+			OutwardIssue: &jiradata.IssueRef{},
+		},
+	}
+
+	return &jiracli.CommandRegistryEntry{
+		"Mark issues as duplicate",
+		func(fig *figtree.FigTree, cmd *kingpin.CmdClause) error {
+			jiracli.LoadConfigs(cmd, fig, &opts)
+			return CmdDupUsage(cmd, &opts)
+		},
+		func(o *oreo.Client, globals *jiracli.GlobalOptions) error {
+			opts.OutwardIssue.Key = jiracli.FormatIssue(opts.OutwardIssue.Key, opts.Project)
+			opts.InwardIssue.Key = jiracli.FormatIssue(opts.InwardIssue.Key, opts.Project)
+			return CmdDup(o, globals, &opts)
+		},
+	}
+}
+
+func CmdDupUsage(cmd *kingpin.CmdClause, opts *DupOptions) error {
+	jiracli.BrowseUsage(cmd, &opts.CommonOptions)
+	jiracli.EditorUsage(cmd, &opts.CommonOptions)
+	jiracli.TemplateUsage(cmd, &opts.CommonOptions)
+	cmd.Flag("comment", "Comment message when marking issue as duplicate").Short('m').PreAction(func(ctx *kingpin.ParseContext) error {
+		opts.Comment = &jiradata.Comment{
+			Body: jiracli.FlagValue(ctx, "comment"),
+		}
+		return nil
+	}).String()
+	cmd.Arg("DUPLICATE", "duplicate issue to mark closed").Required().StringVar(&opts.InwardIssue.Key)
+	cmd.Arg("ISSUE", "duplicate issue to leave open").Required().StringVar(&opts.OutwardIssue.Key)
+	return nil
+}
+
+// CmdDup will update the given issue as being a duplicate by the given dup issue
+// and will attempt to resolve the dup issue
+func CmdDup(o *oreo.Client, globals *jiracli.GlobalOptions, opts *DupOptions) error {
+	if err := jira.LinkIssues(o, globals.Endpoint.Value, &opts.LinkIssueRequest); err != nil {
+		return err
+	}
+	if !globals.Quiet.Value {
+		fmt.Printf("OK %s %s\n", opts.OutwardIssue.Key, jira.URLJoin(globals.Endpoint.Value, "browse", opts.OutwardIssue.Key))
+	}
+
+	meta, err := jira.GetIssueTransitions(o, globals.Endpoint.Value, opts.InwardIssue.Key)
+	if err != nil {
+		return err
+	}
+	for _, trans := range []string{"close", "done", "cancel", "start", "stop"} {
+		transMeta := meta.Transitions.Find(trans)
+		if transMeta == nil {
+			continue
+		}
+		issueUpdate := jiradata.IssueUpdate{
+			Transition: transMeta,
+		}
+		resolution := defaultResolution(transMeta)
+		if resolution != "" {
+			issueUpdate.Fields = map[string]interface{}{
+				"resolution": map[string]interface{}{
+					"name": resolution,
+				},
+			}
+		}
+		if err = jira.TransitionIssue(o, globals.Endpoint.Value, opts.InwardIssue.Key, &issueUpdate); err != nil {
+			return err
+		}
+		if trans != "start" {
+			break
+		}
+		// if we are here then we must be stopping, so need to reset the meta
+		meta, err = jira.GetIssueTransitions(o, globals.Endpoint.Value, opts.InwardIssue.Key)
+		if err != nil {
+			return err
+		}
+	}
+
+	if !globals.Quiet.Value {
+		fmt.Printf("OK %s %s\n", opts.InwardIssue.Key, jira.URLJoin(globals.Endpoint.Value, "browse", opts.InwardIssue.Key))
+	}
+
+	if opts.Browse.Value {
+		if err := CmdBrowse(globals, opts.OutwardIssue.Key); err != nil {
+			return CmdBrowse(globals, opts.InwardIssue.Key)
+		}
+	}
+
+	return nil
+}

jiracmd/edit.go

@@ -0,0 +1,248 @@
+package jiracmd
+
+import (
+	"fmt"
+	"strings"
+
+	"github.com/coryb/figtree"
+	"github.com/coryb/oreo"
+	"github.com/go-jira/jira"
+	"github.com/go-jira/jira/jiracli"
+	"github.com/go-jira/jira/jiradata"
+	"gopkg.in/AlecAivazis/survey.v1"
+	kingpin "gopkg.in/alecthomas/kingpin.v2"
+)
+
+type EditOptions struct {
+	jiracli.CommonOptions `yaml:",inline" json:",inline" figtree:",inline"`
+	jiradata.IssueUpdate  `yaml:",inline" json:",inline" figtree:",inline"`
+	jira.SearchOptions    `yaml:",inline" json:",inline" figtree:",inline"`
+	Overrides             map[string]string `yaml:"overrides,omitempty" json:"overrides,omitempty"`
+	Issue                 string            `yaml:"issue,omitempty" json:"issue,omitempty"`
+	Queries               map[string]string `yaml:"queries,omitempty" json:"queries,omitempty"`
+}
+
+func CmdEditRegistry() *jiracli.CommandRegistryEntry {
+	opts := EditOptions{
+		CommonOptions: jiracli.CommonOptions{
+			Template: figtree.NewStringOption("edit"),
+		},
+		Overrides: map[string]string{},
+	}
+
+	return &jiracli.CommandRegistryEntry{
+		"Edit issue details",
+		func(fig *figtree.FigTree, cmd *kingpin.CmdClause) error {
+			jiracli.LoadConfigs(cmd, fig, &opts)
+			return CmdEditUsage(cmd, &opts, fig)
+		},
+		func(o *oreo.Client, globals *jiracli.GlobalOptions) error {
+			opts.Issue = jiracli.FormatIssue(opts.Issue, opts.Project)
+			if opts.QueryFields == "" {
+				opts.QueryFields = "assignee,created,priority,reporter,status,summary,updated,issuetype,comment,description,votes,created,customfield_10110,components"
+			}
+			return CmdEdit(o, globals, &opts)
+		},
+	}
+}
+
+func CmdEditUsage(cmd *kingpin.CmdClause, opts *EditOptions, fig *figtree.FigTree) error {
+	jiracli.BrowseUsage(cmd, &opts.CommonOptions)
+	jiracli.EditorUsage(cmd, &opts.CommonOptions)
+	jiracli.TemplateUsage(cmd, &opts.CommonOptions)
+	cmd.Flag("noedit", "Disable opening the editor").SetValue(&opts.SkipEditing)
+	cmd.Flag("named-query", "The name of a query in the `queries` configuration").Short('n').PreAction(func(ctx *kingpin.ParseContext) error {
+		name := jiracli.FlagValue(ctx, "named-query")
+		if query, ok := opts.Queries[name]; ok && query != "" {
+			var err error
+			opts.Query, err = jiracli.ConfigTemplate(fig, query, cmd.FullCommand(), opts)
+			return err
+		}
+		return fmt.Errorf("A valid named-query %q not found in `queries` configuration", name)
+	}).String()
+	cmd.Flag("query", "Jira Query Language (JQL) expression for the search to edit multiple issues").Short('q').StringVar(&opts.Query)
+	cmd.Flag("comment", "Comment message for issue").Short('m').PreAction(func(ctx *kingpin.ParseContext) error {
+		opts.Overrides["comment"] = jiracli.FlagValue(ctx, "comment")
+		return nil
+	}).String()
+	cmd.Flag("override", "Set issue property").Short('o').StringMapVar(&opts.Overrides)
+	cmd.Arg("ISSUE", "issue id to edit").StringVar(&opts.Issue)
+	return nil
+}
+
+// Edit will get issue data and send to "edit" template
+func CmdEdit(o *oreo.Client, globals *jiracli.GlobalOptions, opts *EditOptions) error {
+	if globals.JiraDeploymentType.Value == "" {
+		serverInfo, err := jira.ServerInfo(o, globals.Endpoint.Value)
+		if err != nil {
+			return err
+		}
+		globals.JiraDeploymentType.Value = strings.ToLower(serverInfo.DeploymentType)
+	}
+
+	type templateInput struct {
+		*jiradata.Issue `yaml:",inline"`
+		Meta            *jiradata.EditMeta `yaml:"meta" json:"meta"`
+		Overrides       map[string]string  `yaml:"overrides" json:"overrides"`
+	}
+	if opts.Issue != "" {
+		issueData, err := jira.GetIssue(o, globals.Endpoint.Value, opts.Issue, nil)
+		if err != nil {
+			return err
+		}
+		editMeta, err := jira.GetIssueEditMeta(o, globals.Endpoint.Value, opts.Issue)
+		if err != nil {
+			return err
+		}
+
+		issueUpdate := jiradata.IssueUpdate{}
+		input := templateInput{
+			Issue:     issueData,
+			Meta:      editMeta,
+			Overrides: opts.Overrides,
+		}
+		err = jiracli.EditLoop(&opts.CommonOptions, &input, &issueUpdate, func() error {
+			if globals.JiraDeploymentType.Value == jiracli.CloudDeploymentType {
+				err := fixGDPRUserFields(o, globals.Endpoint.Value, editMeta.Fields, issueUpdate.Fields)
+				if err != nil {
+					return err
+				}
+			}
+			return jira.EditIssue(o, globals.Endpoint.Value, opts.Issue, &issueUpdate)
+		})
+		if err != nil {
+			return err
+		}
+		if !globals.Quiet.Value {
+			fmt.Printf("OK %s %s\n", opts.Issue, jira.URLJoin(globals.Endpoint.Value, "browse", opts.Issue))
+		}
+		if opts.Browse.Value {
+			return CmdBrowse(globals, opts.Issue)
+		}
+		return nil
+	}
+	results, err := jira.Search(o, globals.Endpoint.Value, opts)
+	if err != nil {
+		return err
+	}
+	for i, issueData := range results.Issues {
+		editMeta, err := jira.GetIssueEditMeta(o, globals.Endpoint.Value, issueData.Key)
+		if err != nil {
+			return err
+		}
+
+		issueUpdate := jiradata.IssueUpdate{}
+		input := templateInput{
+			Issue:     issueData,
+			Meta:      editMeta,
+			Overrides: opts.Overrides,
+		}
+		err = jiracli.EditLoop(&opts.CommonOptions, &input, &issueUpdate, func() error {
+			if globals.JiraDeploymentType.Value == jiracli.CloudDeploymentType {
+				err := fixGDPRUserFields(o, globals.Endpoint.Value, editMeta.Fields, issueUpdate.Fields)
+				if err != nil {
+					return err
+				}
+			}
+			return jira.EditIssue(o, globals.Endpoint.Value, issueData.Key, &issueUpdate)
+		})
+		if err == jiracli.EditLoopAbort && len(results.Issues) > i+1 {
+			var answer bool
+			survey.AskOne(
+				&survey.Confirm{
+					Message: fmt.Sprintf("Continue to edit next issue %s?", results.Issues[i+1].Key),
+					Default: true,
+				},
+				&answer,
+				nil,
+			)
+			if answer {
+				continue
+			}
+			panic(jiracli.Exit{1})
+		}
+		if err != nil {
+			return err
+		}
+		if !globals.Quiet.Value {
+			fmt.Printf("OK %s %s\n", issueData.Key, jira.URLJoin(globals.Endpoint.Value, "browse", issueData.Key))
+		}
+		if opts.Browse.Value {
+			return CmdBrowse(globals, issueData.Key)
+		}
+	}
+	return nil
+}
+
+func fixUserField(ua jira.HttpClient, endpoint string, userField map[string]interface{}) error {
+	if _, ok := userField["accountId"].(string); ok {
+		// this field is already GDPR ready
+		return nil
+	}
+
+	queryName, ok := userField["displayName"].(string)
+	if !ok {
+		queryName, ok = userField["emailAddress"].(string)
+		if !ok {
+			// no fields to search on, skip user lookup
+			return nil
+		}
+	}
+	users, err := jira.UserSearch(ua, endpoint, &jira.UserSearchOptions{
+		// Query field will search users displayName and emailAddress
+		Query: queryName,
+	})
+	if err != nil {
+		return err
+	}
+	if len(users) != 1 {
+		return fmt.Errorf("Found %d accounts for users with query %q", len(users), queryName)
+	}
+	userField["accountId"] = users[0].AccountID
+	return nil
+}
+
+func fixGDPRUserFields(ua jira.HttpClient, endpoint string, meta jiradata.FieldMetaMap, fields map[string]interface{}) error {
+	for fieldName, fieldMeta := range meta {
+		// check to see if meta-field is in fields data, otherwise skip
+		if _, ok := fields[fieldName]; !ok {
+			continue
+		}
+		if fieldMeta.Schema.Type == "user" {
+			userField, ok := fields[fieldName].(map[string]interface{})
+			if !ok {
+				// for some reason the field seems to be the wrong type in the data
+				// even though the schema is a "user"
+				continue
+			}
+			err := fixUserField(ua, endpoint, userField)
+			if err != nil {
+				return err
+			}
+			fields[fieldName] = userField
+		}
+		if fieldMeta.Schema.Type == "array" && fieldMeta.Schema.Items == "user" {
+			listUserField, ok := fields[fieldName].([]interface{})
+			if !ok {
+				// for some reason the field seems to be the wrong type in the data
+				// even though the schema is a list of "user"
+				continue
+			}
+			for i, userFieldItem := range listUserField {
+				userField, ok := userFieldItem.(map[string]interface{})
+				if !ok {
+					// for some reason the field seems to be the wrong type in the data
+					// even though the schema is a "user"
+					continue
+				}
+				err := fixUserField(ua, endpoint, userField)
+				if err != nil {
+					return err
+				}
+				listUserField[i] = userField
+			}
+			fields[fieldName] = listUserField
+		}
+	}
+	return nil
+}

jiracmd/editmeta.go

@@ -0,0 +1,59 @@
+package jiracmd
+
+import (
+	"github.com/coryb/figtree"
+	"github.com/coryb/oreo"
+	"github.com/go-jira/jira"
+	"github.com/go-jira/jira/jiracli"
+	kingpin "gopkg.in/alecthomas/kingpin.v2"
+)
+
+type EditMetaOptions struct {
+	jiracli.CommonOptions `yaml:",inline" json:",inline" figtree:",inline"`
+	Project               string `yaml:"project,omitempty" json:"project,omitempty"`
+	Issue                 string `yaml:"issue,omitempty" json:"issue,omitempty"`
+}
+
+func CmdEditMetaRegistry() *jiracli.CommandRegistryEntry {
+
+	opts := EditMetaOptions{
+		CommonOptions: jiracli.CommonOptions{
+			Template: figtree.NewStringOption("editmeta"),
+		},
+	}
+
+	return &jiracli.CommandRegistryEntry{
+		"View 'edit' metadata",
+		func(fig *figtree.FigTree, cmd *kingpin.CmdClause) error {
+			jiracli.LoadConfigs(cmd, fig, &opts)
+			return CmdEditMetaUsage(cmd, &opts)
+		},
+		func(o *oreo.Client, globals *jiracli.GlobalOptions) error {
+			opts.Issue = jiracli.FormatIssue(opts.Issue, opts.Project)
+			return CmdEditMeta(o, globals, &opts)
+		},
+	}
+}
+
+func CmdEditMetaUsage(cmd *kingpin.CmdClause, opts *EditMetaOptions) error {
+	jiracli.BrowseUsage(cmd, &opts.CommonOptions)
+	jiracli.TemplateUsage(cmd, &opts.CommonOptions)
+	jiracli.GJsonQueryUsage(cmd, &opts.CommonOptions)
+	cmd.Arg("ISSUE", "edit metadata for issue id").Required().StringVar(&opts.Issue)
+	return nil
+}
+
+// CmdEditMeta will get issue edit metadata and send to "editmeta" template
+func CmdEditMeta(o *oreo.Client, globals *jiracli.GlobalOptions, opts *EditMetaOptions) error {
+	editMeta, err := jira.GetIssueEditMeta(o, globals.Endpoint.Value, opts.Issue)
+	if err != nil {
+		return err
+	}
+	if err := opts.PrintTemplate(editMeta); err != nil {
+		return err
+	}
+	if opts.Browse.Value {
+		return CmdBrowse(globals, opts.Issue)
+	}
+	return nil
+}

jiracmd/epicAdd.go

@@ -0,0 +1,59 @@
+package jiracmd
+
+import (
+	"fmt"
+
+	"github.com/coryb/figtree"
+	"github.com/coryb/oreo"
+
+	"github.com/go-jira/jira"
+	"github.com/go-jira/jira/jiracli"
+	"github.com/go-jira/jira/jiradata"
+	kingpin "gopkg.in/alecthomas/kingpin.v2"
+)
+
+type EpicAddOptions struct {
+	jiradata.EpicIssues `yaml:",inline" json:",inline" figtree:",inline"`
+	Project             string `yaml:"project,omitempty" json:"project,omitempty"`
+	Epic                string `yaml:"epic,omitempty" json:"epic,omitempty"`
+}
+
+func CmdEpicAddRegistry() *jiracli.CommandRegistryEntry {
+	opts := EpicAddOptions{}
+
+	return &jiracli.CommandRegistryEntry{
+		"Add issues to Epic",
+		func(fig *figtree.FigTree, cmd *kingpin.CmdClause) error {
+			jiracli.LoadConfigs(cmd, fig, &opts)
+			return CmdEpicAddUsage(cmd, &opts)
+		},
+		func(o *oreo.Client, globals *jiracli.GlobalOptions) error {
+			opts.Epic = jiracli.FormatIssue(opts.Epic, opts.Project)
+			for i := range opts.Issues {
+				opts.Issues[i] = jiracli.FormatIssue(opts.Issues[i], opts.Project)
+			}
+			return CmdEpicAdd(o, globals, &opts)
+		},
+	}
+}
+
+func CmdEpicAddUsage(cmd *kingpin.CmdClause, opts *EpicAddOptions) error {
+	cmd.Arg("EPIC", "Epic Key or ID to add issues to").Required().StringVar(&opts.Epic)
+	cmd.Arg("ISSUE", "Issues to add to epic").Required().StringsVar(&opts.Issues)
+	return nil
+}
+
+func CmdEpicAdd(o *oreo.Client, globals *jiracli.GlobalOptions, opts *EpicAddOptions) error {
+	if err := jira.EpicAddIssues(o, globals.Endpoint.Value, opts.Epic, &opts.EpicIssues); err != nil {
+		return err
+	}
+
+	if !globals.Quiet.Value {
+		fmt.Printf("OK %s %s\n", opts.Epic, jira.URLJoin(globals.Endpoint.Value, "browse", opts.Epic))
+		for _, issue := range opts.Issues {
+			fmt.Printf("OK %s %s\n", issue, jira.URLJoin(globals.Endpoint.Value, "browse", issue))
+		}
+	}
+
+	return nil
+}

jiracmd/epicCreate.go

@@ -0,0 +1,48 @@
+package jiracmd
+
+import (
+	"github.com/coryb/figtree"
+	"github.com/coryb/oreo"
+
+	"github.com/go-jira/jira/jiracli"
+	kingpin "gopkg.in/alecthomas/kingpin.v2"
+)
+
+func CmdEpicCreateRegistry() *jiracli.CommandRegistryEntry {
+	opts := CreateOptions{
+		CommonOptions: jiracli.CommonOptions{
+			Template: figtree.NewStringOption("epic-create"),
+		},
+		Overrides: map[string]string{},
+	}
+
+	return &jiracli.CommandRegistryEntry{
+		"Create Epic",
+		func(fig *figtree.FigTree, cmd *kingpin.CmdClause) error {
+			jiracli.LoadConfigs(cmd, fig, &opts)
+			return CmdEpicCreateUsage(cmd, &opts)
+		},
+		func(o *oreo.Client, globals *jiracli.GlobalOptions) error {
+			return CmdCreate(o, globals, &opts)
+		},
+	}
+}
+
+func CmdEpicCreateUsage(cmd *kingpin.CmdClause, opts *CreateOptions) error {
+	jiracli.BrowseUsage(cmd, &opts.CommonOptions)
+	jiracli.EditorUsage(cmd, &opts.CommonOptions)
+	jiracli.TemplateUsage(cmd, &opts.CommonOptions)
+	cmd.Flag("noedit", "Disable opening the editor").SetValue(&opts.SkipEditing)
+	cmd.Flag("project", "project to create epic in").Short('p').StringVar(&opts.Project)
+	cmd.Flag("epic-name", "Epic Name").Short('n').PreAction(func(ctx *kingpin.ParseContext) error {
+		opts.Overrides["epic-name"] = jiracli.FlagValue(ctx, "epic-name")
+		return nil
+	}).String()
+	cmd.Flag("comment", "Comment message for epic").Short('m').PreAction(func(ctx *kingpin.ParseContext) error {
+		opts.Overrides["comment"] = jiracli.FlagValue(ctx, "comment")
+		return nil
+	}).String()
+	cmd.Flag("override", "Set epic property").Short('o').StringMapVar(&opts.Overrides)
+	cmd.Flag("saveFile", "Write epic as yaml to file").StringVar(&opts.SaveFile)
+	return nil
+}

jiracmd/epicList.go

@@ -0,0 +1,59 @@
+package jiracmd
+
+import (
+	"github.com/coryb/figtree"
+	"github.com/coryb/oreo"
+	"github.com/go-jira/jira"
+	"github.com/go-jira/jira/jiracli"
+	kingpin "gopkg.in/alecthomas/kingpin.v2"
+)
+
+type EpicListOptions struct {
+	ListOptions `yaml:",inline" json:",inline" figtree:",inline"`
+	Epic        string `yaml:"epic,omitempty" json:"epic,omitempty"`
+}
+
+func CmdEpicListRegistry() *jiracli.CommandRegistryEntry {
+	opts := EpicListOptions{
+		ListOptions: ListOptions{
+			CommonOptions: jiracli.CommonOptions{
+				Template: figtree.NewStringOption("epic-list"),
+			},
+		},
+	}
+
+	return &jiracli.CommandRegistryEntry{
+		"Prints list of issues for an epic with optional search criteria",
+		func(fig *figtree.FigTree, cmd *kingpin.CmdClause) error {
+			jiracli.LoadConfigs(cmd, fig, &opts)
+			return CmdEpicListUsage(cmd, &opts, fig)
+		},
+		func(o *oreo.Client, globals *jiracli.GlobalOptions) error {
+			opts.Epic = jiracli.FormatIssue(opts.Epic, opts.Project)
+			if opts.MaxResults == 0 {
+				opts.MaxResults = 500
+			}
+			if opts.QueryFields == "" {
+				opts.QueryFields = "assignee,created,priority,reporter,status,summary,updated,issuetype"
+			}
+			if opts.Sort == "" {
+				opts.Sort = "priority asc, key"
+			}
+			return CmdEpicList(o, globals, &opts)
+		},
+	}
+}
+
+func CmdEpicListUsage(cmd *kingpin.CmdClause, opts *EpicListOptions, fig *figtree.FigTree) error {
+	CmdListUsage(cmd, &opts.ListOptions, fig)
+	cmd.Arg("EPIC", "Epic Key or ID to list").Required().StringVar(&opts.Epic)
+	return nil
+}
+
+func CmdEpicList(o *oreo.Client, globals *jiracli.GlobalOptions, opts *EpicListOptions) error {
+	data, err := jira.EpicSearch(o, globals.Endpoint.Value, opts.Epic, opts)
+	if err != nil {
+		return err
+	}
+	return opts.PrintTemplate(data)
+}

jiracmd/epicRemove.go

@@ -0,0 +1,55 @@
+package jiracmd
+
+import (
+	"fmt"
+
+	"github.com/coryb/figtree"
+	"github.com/coryb/oreo"
+
+	"github.com/go-jira/jira"
+	"github.com/go-jira/jira/jiracli"
+	"github.com/go-jira/jira/jiradata"
+	kingpin "gopkg.in/alecthomas/kingpin.v2"
+)
+
+type EpicRemoveOptions struct {
+	jiradata.EpicIssues `yaml:",inline" json:",inline" figtree:",inline"`
+	Project             string `yaml:"project,omitempty" json:"project,omitempty"`
+}
+
+func CmdEpicRemoveRegistry() *jiracli.CommandRegistryEntry {
+	opts := EpicRemoveOptions{}
+
+	return &jiracli.CommandRegistryEntry{
+		"Remove issues from Epic",
+		func(fig *figtree.FigTree, cmd *kingpin.CmdClause) error {
+			jiracli.LoadConfigs(cmd, fig, &opts)
+			return CmdEpicRemoveUsage(cmd, &opts)
+		},
+		func(o *oreo.Client, globals *jiracli.GlobalOptions) error {
+			for i := range opts.Issues {
+				opts.Issues[i] = jiracli.FormatIssue(opts.Issues[i], opts.Project)
+			}
+			return CmdEpicRemove(o, globals, &opts)
+		},
+	}
+}
+
+func CmdEpicRemoveUsage(cmd *kingpin.CmdClause, opts *EpicRemoveOptions) error {
+	cmd.Arg("ISSUE", "Issues to remove from any epic").Required().StringsVar(&opts.Issues)
+	return nil
+}
+
+func CmdEpicRemove(o *oreo.Client, globals *jiracli.GlobalOptions, opts *EpicRemoveOptions) error {
+	if err := jira.EpicRemoveIssues(o, globals.Endpoint.Value, &opts.EpicIssues); err != nil {
+		return err
+	}
+
+	if !globals.Quiet.Value {
+		for _, issue := range opts.Issues {
+			fmt.Printf("OK %s %s\n", issue, jira.URLJoin(globals.Endpoint.Value, "browse", issue))
+		}
+	}
+
+	return nil
+}

jiracmd/exportTemplates.go

@@ -0,0 +1,71 @@
+package jiracmd
+
+import (
+	"fmt"
+	"os"
+	"path"
+
+	"github.com/coryb/figtree"
+	"github.com/coryb/oreo"
+	"github.com/go-jira/jira/jiracli"
+	kingpin "gopkg.in/alecthomas/kingpin.v2"
+)
+
+type ExportTemplatesOptions struct {
+	Template string `yaml:"template,omitempty" json:"template,omitempty"`
+	Dir      string `yaml:"dir,omitempty" json:"dir,omitempty"`
+}
+
+func CmdExportTemplatesRegistry() *jiracli.CommandRegistryEntry {
+	opts := ExportTemplatesOptions{}
+
+	return &jiracli.CommandRegistryEntry{
+		"Export templates for customizations",
+		func(fig *figtree.FigTree, cmd *kingpin.CmdClause) error {
+			jiracli.LoadConfigs(cmd, fig, &opts)
+			return CmdExportTemplatesUsage(cmd, &opts)
+		},
+		func(o *oreo.Client, globals *jiracli.GlobalOptions) error {
+			if opts.Dir == "" {
+				opts.Dir = fmt.Sprintf("%s/.jira.d/templates", jiracli.Homedir())
+			}
+			return CmdExportTemplates(globals, &opts)
+		},
+	}
+}
+
+func CmdExportTemplatesUsage(cmd *kingpin.CmdClause, opts *ExportTemplatesOptions) error {
+	cmd.Flag("template", "Template to export").Short('t').StringVar(&opts.Template)
+	cmd.Flag("dir", "directory to write tempates to").Short('d').StringVar(&opts.Dir)
+
+	return nil
+}
+
+// CmdExportTemplates will export templates to directory
+func CmdExportTemplates(globals *jiracli.GlobalOptions, opts *ExportTemplatesOptions) error {
+	if err := os.MkdirAll(opts.Dir, 0755); err != nil {
+		return err
+	}
+
+	for name, template := range jiracli.AllTemplates {
+		if opts.Template != "" && opts.Template != name {
+			continue
+		}
+		templateFile := path.Join(opts.Dir, name)
+		if _, err := os.Stat(templateFile); err == nil {
+			log.Warning("Skipping %s, already exists", templateFile)
+			continue
+		}
+		fh, err := os.OpenFile(templateFile, os.O_WRONLY|os.O_CREATE, 0644)
+		if err != nil {
+			log.Errorf("Failed to open %s for writing: %s", templateFile, err)
+			return err
+		}
+		defer fh.Close()
+		if !globals.Quiet.Value {
+			log.Noticef("Creating %s", templateFile)
+		}
+		fh.Write([]byte(template))
+	}
+	return nil
+}

jiracmd/fields.go

@@ -0,0 +1,36 @@
+package jiracmd
+
+import (
+	"github.com/coryb/figtree"
+	"github.com/coryb/oreo"
+	"github.com/go-jira/jira"
+	"github.com/go-jira/jira/jiracli"
+	kingpin "gopkg.in/alecthomas/kingpin.v2"
+)
+
+func CmdFieldsRegistry() *jiracli.CommandRegistryEntry {
+	opts := jiracli.CommonOptions{
+		Template: figtree.NewStringOption("fields"),
+	}
+	return &jiracli.CommandRegistryEntry{
+		"Prints all fields, both System and Custom",
+		func(fig *figtree.FigTree, cmd *kingpin.CmdClause) error {
+			jiracli.LoadConfigs(cmd, fig, &opts)
+			jiracli.TemplateUsage(cmd, &opts)
+			jiracli.GJsonQueryUsage(cmd, &opts)
+			return nil
+		},
+		func(o *oreo.Client, globals *jiracli.GlobalOptions) error {
+			return CmdFields(o, globals, &opts)
+		},
+	}
+}
+
+// Fields will send data from /rest/api/2/field API to "fields" template
+func CmdFields(o *oreo.Client, globals *jiracli.GlobalOptions, opts *jiracli.CommonOptions) error {
+	data, err := jira.GetFields(o, globals.Endpoint.Value)
+	if err != nil {
+		return err
+	}
+	return opts.PrintTemplate(data)
+}

jiracmd/issuelink.go

@@ -0,0 +1,79 @@
+package jiracmd
+
+import (
+	"fmt"
+
+	"github.com/coryb/figtree"
+	"github.com/coryb/oreo"
+
+	"github.com/go-jira/jira"
+	"github.com/go-jira/jira/jiracli"
+	"github.com/go-jira/jira/jiradata"
+	kingpin "gopkg.in/alecthomas/kingpin.v2"
+)
+
+type IssueLinkOptions struct {
+	jiracli.CommonOptions     `yaml:",inline" json:",inline" figtree:",inline"`
+	jiradata.LinkIssueRequest `yaml:",inline" json:",inline" figtree:",inline"`
+	LinkType                  string `yaml:"linktype,omitempty" json:"linktype,omitempty"`
+	Project                   string `yaml:"project,omitempty" json:"project,omitempty"`
+}
+
+func CmdIssueLinkRegistry() *jiracli.CommandRegistryEntry {
+	opts := IssueLinkOptions{
+		LinkIssueRequest: jiradata.LinkIssueRequest{
+			Type:         &jiradata.IssueLinkType{},
+			InwardIssue:  &jiradata.IssueRef{},
+			OutwardIssue: &jiradata.IssueRef{},
+		},
+	}
+	return &jiracli.CommandRegistryEntry{
+		"Link two issues",
+		func(fig *figtree.FigTree, cmd *kingpin.CmdClause) error {
+			jiracli.LoadConfigs(cmd, fig, &opts)
+			return CmdIssueLinkUsage(cmd, &opts)
+		},
+		func(o *oreo.Client, globals *jiracli.GlobalOptions) error {
+			opts.OutwardIssue.Key = jiracli.FormatIssue(opts.OutwardIssue.Key, opts.Project)
+			opts.InwardIssue.Key = jiracli.FormatIssue(opts.InwardIssue.Key, opts.Project)
+			return CmdIssueLink(o, globals, &opts)
+		},
+	}
+}
+
+func CmdIssueLinkUsage(cmd *kingpin.CmdClause, opts *IssueLinkOptions) error {
+	jiracli.BrowseUsage(cmd, &opts.CommonOptions)
+	jiracli.EditorUsage(cmd, &opts.CommonOptions)
+	jiracli.TemplateUsage(cmd, &opts.CommonOptions)
+	cmd.Flag("comment", "Comment message when linking issue").Short('m').PreAction(func(ctx *kingpin.ParseContext) error {
+		opts.Comment = &jiradata.Comment{
+			Body: jiracli.FlagValue(ctx, "comment"),
+		}
+		return nil
+	}).String()
+	cmd.Arg("OUTWARDISSUE", "outward issue").Required().StringVar(&opts.OutwardIssue.Key)
+	cmd.Arg("ISSUELINKTYPE", "issue link type").Required().StringVar(&opts.Type.Name)
+	cmd.Arg("INWARDISSUE", "inward issue").Required().StringVar(&opts.InwardIssue.Key)
+	return nil
+}
+
+// CmdIssueLink will update the given issue as being a duplicate by the given dup issue
+// and will attempt to resolve the dup issue
+func CmdIssueLink(o *oreo.Client, globals *jiracli.GlobalOptions, opts *IssueLinkOptions) error {
+	if err := jira.LinkIssues(o, globals.Endpoint.Value, &opts.LinkIssueRequest); err != nil {
+		return err
+	}
+
+	if !globals.Quiet.Value {
+		fmt.Printf("OK %s %s\n", opts.InwardIssue.Key, jira.URLJoin(globals.Endpoint.Value, "browse", opts.InwardIssue.Key))
+		fmt.Printf("OK %s %s\n", opts.OutwardIssue.Key, jira.URLJoin(globals.Endpoint.Value, "browse", opts.OutwardIssue.Key))
+	}
+
+	if opts.Browse.Value {
+		if err := CmdBrowse(globals, opts.OutwardIssue.Key); err != nil {
+			return CmdBrowse(globals, opts.InwardIssue.Key)
+		}
+	}
+
+	return nil
+}

jiracmd/issuelinktypes.go

@@ -0,0 +1,41 @@
+package jiracmd
+
+import (
+	"github.com/coryb/figtree"
+	"github.com/coryb/oreo"
+	"github.com/go-jira/jira"
+	"github.com/go-jira/jira/jiracli"
+	kingpin "gopkg.in/alecthomas/kingpin.v2"
+)
+
+func CmdIssueLinkTypesRegistry() *jiracli.CommandRegistryEntry {
+	opts := jiracli.CommonOptions{
+		Template: figtree.NewStringOption("issuelinktypes"),
+	}
+
+	return &jiracli.CommandRegistryEntry{
+		"Show the issue link types",
+		func(fig *figtree.FigTree, cmd *kingpin.CmdClause) error {
+			jiracli.LoadConfigs(cmd, fig, &opts)
+			return CmdIssueLinkTypesUsage(cmd, &opts)
+		},
+		func(o *oreo.Client, globals *jiracli.GlobalOptions) error {
+			return CmdIssueLinkTypes(o, globals, &opts)
+		},
+	}
+}
+
+func CmdIssueLinkTypesUsage(cmd *kingpin.CmdClause, opts *jiracli.CommonOptions) error {
+	jiracli.TemplateUsage(cmd, opts)
+	jiracli.GJsonQueryUsage(cmd, opts)
+	return nil
+}
+
+// CmdIssueLinkTypes will get issue link type data and send to "issuelinktypes" template
+func CmdIssueLinkTypes(o *oreo.Client, globals *jiracli.GlobalOptions, opts *jiracli.CommonOptions) error {
+	data, err := jira.GetIssueLinkTypes(o, globals.Endpoint.Value)
+	if err != nil {
+		return err
+	}
+	return opts.PrintTemplate(data)
+}