2015-08-18 16:46:52 +08:00
|
|
|
# CLI support for JIRA interaction
|
2012-12-03 13:59:05 +08:00
|
|
|
#
|
2015-09-12 06:37:39 +08:00
|
|
|
# See README.md for details
|
2015-08-18 16:46:52 +08:00
|
|
|
|
2024-03-26 16:48:14 +08:00
|
|
|
function _jira_usage() {
|
|
|
|
cat <<EOF
|
|
|
|
jira Performs the default action
|
|
|
|
jira new Opens a new Jira issue dialogue
|
|
|
|
jira ABC-123 Opens an existing issue
|
|
|
|
jira ABC-123 m Opens an existing issue for adding a comment
|
|
|
|
jira dashboard [rapid_view] Opens your JIRA dashboard
|
|
|
|
jira mine Queries for your own issues
|
|
|
|
jira tempo Opens your JIRA Tempo
|
|
|
|
jira reported [username] Queries for issues reported by a user
|
|
|
|
jira assigned [username] Queries for issues assigned to a user
|
|
|
|
jira branch Opens an existing issue matching the current branch name
|
|
|
|
EOF
|
|
|
|
}
|
|
|
|
|
2015-08-18 16:46:52 +08:00
|
|
|
function jira() {
|
2015-09-12 06:37:39 +08:00
|
|
|
emulate -L zsh
|
2017-11-01 21:09:10 +08:00
|
|
|
local action jira_url jira_prefix
|
2017-11-05 01:31:42 +08:00
|
|
|
if [[ -n "$1" ]]; then
|
|
|
|
action=$1
|
|
|
|
elif [[ -f .jira-default-action ]]; then
|
2017-11-01 21:09:10 +08:00
|
|
|
action=$(cat .jira-default-action)
|
|
|
|
elif [[ -f ~/.jira-default-action ]]; then
|
|
|
|
action=$(cat ~/.jira-default-action)
|
|
|
|
elif [[ -n "${JIRA_DEFAULT_ACTION}" ]]; then
|
|
|
|
action=${JIRA_DEFAULT_ACTION}
|
|
|
|
else
|
|
|
|
action="new"
|
|
|
|
fi
|
2015-08-18 16:46:52 +08:00
|
|
|
|
|
|
|
if [[ -f .jira-url ]]; then
|
2012-12-03 13:59:05 +08:00
|
|
|
jira_url=$(cat .jira-url)
|
2015-08-18 16:46:52 +08:00
|
|
|
elif [[ -f ~/.jira-url ]]; then
|
2012-12-03 13:59:05 +08:00
|
|
|
jira_url=$(cat ~/.jira-url)
|
2015-08-18 16:46:52 +08:00
|
|
|
elif [[ -n "${JIRA_URL}" ]]; then
|
2015-07-07 04:00:53 +08:00
|
|
|
jira_url=${JIRA_URL}
|
2012-09-29 13:41:30 +08:00
|
|
|
else
|
2015-08-18 17:05:54 +08:00
|
|
|
_jira_url_help
|
2014-08-19 22:42:39 +08:00
|
|
|
return 1
|
2012-12-03 13:59:05 +08:00
|
|
|
fi
|
|
|
|
|
2015-08-18 16:46:52 +08:00
|
|
|
if [[ -f .jira-prefix ]]; then
|
2014-07-15 21:22:24 +08:00
|
|
|
jira_prefix=$(cat .jira-prefix)
|
2015-08-18 16:46:52 +08:00
|
|
|
elif [[ -f ~/.jira-prefix ]]; then
|
2014-07-15 21:22:24 +08:00
|
|
|
jira_prefix=$(cat ~/.jira-prefix)
|
2015-08-18 16:46:52 +08:00
|
|
|
elif [[ -n "${JIRA_PREFIX}" ]]; then
|
2015-07-07 04:00:53 +08:00
|
|
|
jira_prefix=${JIRA_PREFIX}
|
2014-07-15 21:22:24 +08:00
|
|
|
else
|
|
|
|
jira_prefix=""
|
|
|
|
fi
|
|
|
|
|
2015-08-18 16:46:52 +08:00
|
|
|
|
|
|
|
if [[ $action == "new" ]]; then
|
2012-12-03 13:59:05 +08:00
|
|
|
echo "Opening new issue"
|
2015-08-05 06:32:57 +08:00
|
|
|
open_command "${jira_url}/secure/CreateIssue!default.jspa"
|
2015-08-18 16:46:52 +08:00
|
|
|
elif [[ "$action" == "assigned" || "$action" == "reported" ]]; then
|
2019-05-08 00:11:28 +08:00
|
|
|
_jira_query ${@:-$action}
|
2024-03-26 16:48:14 +08:00
|
|
|
elif [[ "$action" == "help" || "$action" == "usage" ]]; then
|
|
|
|
_jira_usage
|
2023-01-10 03:43:42 +08:00
|
|
|
elif [[ "$action" == "mine" ]]; then
|
2018-03-27 09:04:27 +08:00
|
|
|
echo "Opening my issues"
|
|
|
|
open_command "${jira_url}/issues/?filter=-1"
|
2015-08-18 16:46:52 +08:00
|
|
|
elif [[ "$action" == "dashboard" ]]; then
|
|
|
|
echo "Opening dashboard"
|
2016-04-27 01:08:13 +08:00
|
|
|
if [[ "$JIRA_RAPID_BOARD" == "true" ]]; then
|
2023-01-10 03:53:32 +08:00
|
|
|
_jira_rapid_board ${@}
|
2016-04-27 01:08:13 +08:00
|
|
|
else
|
|
|
|
open_command "${jira_url}/secure/Dashboard.jspa"
|
|
|
|
fi
|
2020-05-22 00:11:18 +08:00
|
|
|
elif [[ "$action" == "tempo" ]]; then
|
|
|
|
echo "Opening tempo"
|
2023-01-10 03:45:20 +08:00
|
|
|
if [[ -n "$JIRA_TEMPO_PATH" ]]; then
|
|
|
|
open_command "${jira_url}${JIRA_TEMPO_PATH}"
|
|
|
|
else
|
|
|
|
open_command "${jira_url}/secure/Tempo.jspa"
|
|
|
|
fi
|
2015-09-12 06:37:39 +08:00
|
|
|
elif [[ "$action" == "dumpconfig" ]]; then
|
|
|
|
echo "JIRA_URL=$jira_url"
|
|
|
|
echo "JIRA_PREFIX=$jira_prefix"
|
|
|
|
echo "JIRA_NAME=$JIRA_NAME"
|
2023-01-10 03:53:32 +08:00
|
|
|
echo "JIRA_RAPID_VIEW=$JIRA_RAPID_VIEW"
|
2015-09-12 06:37:39 +08:00
|
|
|
echo "JIRA_RAPID_BOARD=$JIRA_RAPID_BOARD"
|
|
|
|
echo "JIRA_DEFAULT_ACTION=$JIRA_DEFAULT_ACTION"
|
2023-01-10 03:45:20 +08:00
|
|
|
echo "JIRA_TEMPO_PATH=$JIRA_TEMPO_PATH"
|
2015-07-08 02:03:58 +08:00
|
|
|
else
|
2015-08-18 16:46:52 +08:00
|
|
|
# Anything that doesn't match a special action is considered an issue name
|
2017-11-01 21:04:41 +08:00
|
|
|
# but `branch` is a special case that will parse the current git branch
|
2020-03-03 06:26:52 +08:00
|
|
|
local issue_arg issue
|
2018-03-19 05:10:34 +08:00
|
|
|
if [[ "$action" == "branch" ]]; then
|
2020-03-03 06:26:52 +08:00
|
|
|
# Get name of the branch
|
|
|
|
issue_arg=$(git rev-parse --abbrev-ref HEAD)
|
2019-06-28 03:16:57 +08:00
|
|
|
# Strip prefixes like feature/ or bugfix/
|
|
|
|
issue_arg=${issue_arg##*/}
|
|
|
|
# Strip suffixes starting with _
|
2020-03-03 06:26:52 +08:00
|
|
|
issue_arg=(${(s:_:)issue_arg})
|
2023-06-29 19:29:14 +08:00
|
|
|
# If there is only one part, it means that there is a different delimiter. Try with -
|
|
|
|
if [[ ${#issue_arg[@]} = 1 && ${issue_arg} == *-* ]]; then
|
|
|
|
issue_arg=(${(s:-:)issue_arg})
|
|
|
|
issue_arg="${issue_arg[1]}-${issue_arg[2]}"
|
|
|
|
else
|
|
|
|
issue_arg=${issue_arg[1]}
|
|
|
|
fi
|
2023-01-10 03:30:08 +08:00
|
|
|
if [[ "${issue_arg:l}" = ${jira_prefix:l}* ]]; then
|
2020-03-03 06:26:52 +08:00
|
|
|
issue="${issue_arg}"
|
2018-06-26 21:19:22 +08:00
|
|
|
else
|
2020-03-03 06:26:52 +08:00
|
|
|
issue="${jira_prefix}${issue_arg}"
|
2018-06-26 21:19:22 +08:00
|
|
|
fi
|
2017-11-01 21:04:41 +08:00
|
|
|
else
|
2020-03-03 06:26:52 +08:00
|
|
|
issue_arg=${(U)action}
|
|
|
|
issue="${jira_prefix}${issue_arg}"
|
2017-11-01 21:04:41 +08:00
|
|
|
fi
|
2020-03-03 06:26:52 +08:00
|
|
|
|
|
|
|
local url_fragment
|
2014-06-22 09:10:53 +08:00
|
|
|
if [[ "$2" == "m" ]]; then
|
2015-08-18 16:46:52 +08:00
|
|
|
url_fragment="#add-comment"
|
|
|
|
echo "Add comment to issue #$issue"
|
2014-06-22 09:10:53 +08:00
|
|
|
else
|
2015-08-18 16:46:52 +08:00
|
|
|
echo "Opening issue #$issue"
|
2014-06-22 09:10:53 +08:00
|
|
|
fi
|
2019-06-28 03:16:57 +08:00
|
|
|
open_command "${jira_url}/browse/${issue}${url_fragment}"
|
2012-09-29 13:41:30 +08:00
|
|
|
fi
|
|
|
|
}
|
|
|
|
|
2015-08-18 17:05:54 +08:00
|
|
|
function _jira_url_help() {
|
2015-07-14 04:08:18 +08:00
|
|
|
cat << EOF
|
2015-09-12 06:37:39 +08:00
|
|
|
error: JIRA URL is not specified anywhere.
|
|
|
|
|
2015-07-30 04:58:22 +08:00
|
|
|
Valid options, in order of precedence:
|
2015-07-14 04:08:18 +08:00
|
|
|
.jira-url file
|
2015-07-30 04:58:22 +08:00
|
|
|
\$HOME/.jira-url file
|
2015-09-12 06:37:39 +08:00
|
|
|
\$JIRA_URL environment variable
|
2015-07-14 04:08:18 +08:00
|
|
|
EOF
|
|
|
|
}
|
|
|
|
|
2023-01-10 03:53:32 +08:00
|
|
|
function _jira_rapid_board() {
|
|
|
|
rapid_view=${2:=$JIRA_RAPID_VIEW}
|
|
|
|
|
|
|
|
if [[ -z $rapid_view ]]; then
|
|
|
|
open_command "${jira_url}/secure/RapidBoard.jspa"
|
|
|
|
else
|
|
|
|
open_command "${jira_url}/secure/RapidBoard.jspa?rapidView=$rapid_view"
|
|
|
|
fi
|
|
|
|
}
|
|
|
|
|
2015-08-18 17:05:54 +08:00
|
|
|
function _jira_query() {
|
2015-09-12 06:37:39 +08:00
|
|
|
emulate -L zsh
|
2015-07-08 02:26:00 +08:00
|
|
|
local verb="$1"
|
2015-08-18 16:46:52 +08:00
|
|
|
local jira_name lookup preposition query
|
|
|
|
if [[ "${verb}" == "reported" ]]; then
|
2015-07-08 01:56:22 +08:00
|
|
|
lookup=reporter
|
|
|
|
preposition=by
|
2015-08-18 16:46:52 +08:00
|
|
|
elif [[ "${verb}" == "assigned" ]]; then
|
2015-07-08 01:56:22 +08:00
|
|
|
lookup=assignee
|
|
|
|
preposition=to
|
|
|
|
else
|
2015-09-12 06:37:39 +08:00
|
|
|
echo "error: not a valid lookup: $verb" >&2
|
2015-07-08 01:56:22 +08:00
|
|
|
return 1
|
|
|
|
fi
|
2015-08-18 16:46:52 +08:00
|
|
|
jira_name=${2:=$JIRA_NAME}
|
|
|
|
if [[ -z $jira_name ]]; then
|
2015-09-12 06:37:39 +08:00
|
|
|
echo "error: JIRA_NAME not specified" >&2
|
2015-07-08 01:56:22 +08:00
|
|
|
return 1
|
|
|
|
fi
|
2015-08-18 16:46:52 +08:00
|
|
|
|
2015-07-08 01:56:22 +08:00
|
|
|
echo "Browsing issues ${verb} ${preposition} ${jira_name}"
|
2015-08-18 16:46:52 +08:00
|
|
|
query="${lookup}+%3D+%22${jira_name}%22+AND+resolution+%3D+unresolved+ORDER+BY+priority+DESC%2C+created+ASC"
|
|
|
|
open_command "${jira_url}/secure/IssueNavigator.jspa?reset=true&jqlQuery=${query}"
|
2014-08-19 22:42:39 +08:00
|
|
|
}
|