kube-ps1.plugin.zsh 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399
  1. #!/usr/bin/env bash
  2. # Kubernetes prompt helper for bash/zsh
  3. # Displays current context and namespace
  4. # Copyright 2021 Jon Mosco
  5. #
  6. # Licensed under the Apache License, Version 2.0 (the "License");
  7. # you may not use this file except in compliance with the License.
  8. # You may obtain a copy of the License at
  9. #
  10. # http://www.apache.org/licenses/LICENSE-2.0
  11. #
  12. # Unless required by applicable law or agreed to in writing, software
  13. # distributed under the License is distributed on an "AS IS" BASIS,
  14. # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  15. # See the License for the specific language governing permissions and
  16. # limitations under the License.
  17. # Debug
  18. [[ -n $DEBUG ]] && set -x
  19. # Default values for the prompt
  20. # Override these values in ~/.zshrc or ~/.bashrc
  21. KUBE_PS1_BINARY="${KUBE_PS1_BINARY:-kubectl}"
  22. KUBE_PS1_SYMBOL_ENABLE="${KUBE_PS1_SYMBOL_ENABLE:-true}"
  23. KUBE_PS1_SYMBOL_DEFAULT=${KUBE_PS1_SYMBOL_DEFAULT:-$'\u2388'}
  24. KUBE_PS1_SYMBOL_PADDING="${KUBE_PS1_SYMBOL_PADDING:-false}"
  25. KUBE_PS1_SYMBOL_USE_IMG="${KUBE_PS1_SYMBOL_USE_IMG:-false}"
  26. KUBE_PS1_NS_ENABLE="${KUBE_PS1_NS_ENABLE:-true}"
  27. KUBE_PS1_CONTEXT_ENABLE="${KUBE_PS1_CONTEXT_ENABLE:-true}"
  28. KUBE_PS1_PREFIX="${KUBE_PS1_PREFIX-(}"
  29. KUBE_PS1_SEPARATOR="${KUBE_PS1_SEPARATOR-|}"
  30. KUBE_PS1_DIVIDER="${KUBE_PS1_DIVIDER-:}"
  31. KUBE_PS1_SUFFIX="${KUBE_PS1_SUFFIX-)}"
  32. KUBE_PS1_SYMBOL_COLOR="${KUBE_PS1_SYMBOL_COLOR-blue}"
  33. KUBE_PS1_CTX_COLOR="${KUBE_PS1_CTX_COLOR-red}"
  34. KUBE_PS1_NS_COLOR="${KUBE_PS1_NS_COLOR-cyan}"
  35. KUBE_PS1_BG_COLOR="${KUBE_PS1_BG_COLOR}"
  36. KUBE_PS1_KUBECONFIG_CACHE="${KUBECONFIG}"
  37. KUBE_PS1_KUBECONFIG_SYMLINK="${KUBE_PS1_KUBECONFIG_SYMLINK:-false}"
  38. KUBE_PS1_DISABLE_PATH="${HOME}/.kube/kube-ps1/disabled"
  39. KUBE_PS1_LAST_TIME=0
  40. KUBE_PS1_CLUSTER_FUNCTION="${KUBE_PS1_CLUSTER_FUNCTION}"
  41. KUBE_PS1_NAMESPACE_FUNCTION="${KUBE_PS1_NAMESPACE_FUNCTION}"
  42. # Determine our shell
  43. if [ "${ZSH_VERSION-}" ]; then
  44. KUBE_PS1_SHELL="zsh"
  45. elif [ "${BASH_VERSION-}" ]; then
  46. KUBE_PS1_SHELL="bash"
  47. fi
  48. _kube_ps1_init() {
  49. [[ -f "${KUBE_PS1_DISABLE_PATH}" ]] && KUBE_PS1_ENABLED=off
  50. case "${KUBE_PS1_SHELL}" in
  51. "zsh")
  52. _KUBE_PS1_OPEN_ESC="%{"
  53. _KUBE_PS1_CLOSE_ESC="%}"
  54. _KUBE_PS1_DEFAULT_BG="%k"
  55. _KUBE_PS1_DEFAULT_FG="%f"
  56. setopt PROMPT_SUBST
  57. autoload -U add-zsh-hook
  58. add-zsh-hook precmd _kube_ps1_update_cache
  59. zmodload -F zsh/stat b:zstat
  60. zmodload zsh/datetime
  61. ;;
  62. "bash")
  63. _KUBE_PS1_OPEN_ESC=$'\001'
  64. _KUBE_PS1_CLOSE_ESC=$'\002'
  65. _KUBE_PS1_DEFAULT_BG=$'\033[49m'
  66. _KUBE_PS1_DEFAULT_FG=$'\033[39m'
  67. [[ $PROMPT_COMMAND =~ _kube_ps1_update_cache ]] || PROMPT_COMMAND="_kube_ps1_update_cache;${PROMPT_COMMAND:-:}"
  68. ;;
  69. esac
  70. }
  71. _kube_ps1_color_fg() {
  72. local KUBE_PS1_FG_CODE
  73. case "${1}" in
  74. black) KUBE_PS1_FG_CODE=0;;
  75. red) KUBE_PS1_FG_CODE=1;;
  76. green) KUBE_PS1_FG_CODE=2;;
  77. yellow) KUBE_PS1_FG_CODE=3;;
  78. blue) KUBE_PS1_FG_CODE=4;;
  79. magenta) KUBE_PS1_FG_CODE=5;;
  80. cyan) KUBE_PS1_FG_CODE=6;;
  81. white) KUBE_PS1_FG_CODE=7;;
  82. # 256
  83. [0-9]|[1-9][0-9]|[1][0-9][0-9]|[2][0-4][0-9]|[2][5][0-6]) KUBE_PS1_FG_CODE="${1}";;
  84. *) KUBE_PS1_FG_CODE=default
  85. esac
  86. if [[ "${KUBE_PS1_FG_CODE}" == "default" ]]; then
  87. KUBE_PS1_FG_CODE="${_KUBE_PS1_DEFAULT_FG}"
  88. return
  89. elif [[ "${KUBE_PS1_SHELL}" == "zsh" ]]; then
  90. KUBE_PS1_FG_CODE="%F{$KUBE_PS1_FG_CODE}"
  91. elif [[ "${KUBE_PS1_SHELL}" == "bash" ]]; then
  92. if tput setaf 1 &> /dev/null; then
  93. KUBE_PS1_FG_CODE="$(tput setaf ${KUBE_PS1_FG_CODE})"
  94. elif [[ $KUBE_PS1_FG_CODE -ge 0 ]] && [[ $KUBE_PS1_FG_CODE -le 256 ]]; then
  95. KUBE_PS1_FG_CODE="\033[38;5;${KUBE_PS1_FG_CODE}m"
  96. else
  97. KUBE_PS1_FG_CODE="${_KUBE_PS1_DEFAULT_FG}"
  98. fi
  99. fi
  100. echo ${_KUBE_PS1_OPEN_ESC}${KUBE_PS1_FG_CODE}${_KUBE_PS1_CLOSE_ESC}
  101. }
  102. _kube_ps1_color_bg() {
  103. local KUBE_PS1_BG_CODE
  104. case "${1}" in
  105. black) KUBE_PS1_BG_CODE=0;;
  106. red) KUBE_PS1_BG_CODE=1;;
  107. green) KUBE_PS1_BG_CODE=2;;
  108. yellow) KUBE_PS1_BG_CODE=3;;
  109. blue) KUBE_PS1_BG_CODE=4;;
  110. magenta) KUBE_PS1_BG_CODE=5;;
  111. cyan) KUBE_PS1_BG_CODE=6;;
  112. white) KUBE_PS1_BG_CODE=7;;
  113. # 256
  114. [0-9]|[1-9][0-9]|[1][0-9][0-9]|[2][0-4][0-9]|[2][5][0-6]) KUBE_PS1_BG_CODE="${1}";;
  115. *) KUBE_PS1_BG_CODE=$'\033[0m';;
  116. esac
  117. if [[ "${KUBE_PS1_BG_CODE}" == "default" ]]; then
  118. KUBE_PS1_FG_CODE="${_KUBE_PS1_DEFAULT_BG}"
  119. return
  120. elif [[ "${KUBE_PS1_SHELL}" == "zsh" ]]; then
  121. KUBE_PS1_BG_CODE="%K{$KUBE_PS1_BG_CODE}"
  122. elif [[ "${KUBE_PS1_SHELL}" == "bash" ]]; then
  123. if tput setaf 1 &> /dev/null; then
  124. KUBE_PS1_BG_CODE="$(tput setab ${KUBE_PS1_BG_CODE})"
  125. elif [[ $KUBE_PS1_BG_CODE -ge 0 ]] && [[ $KUBE_PS1_BG_CODE -le 256 ]]; then
  126. KUBE_PS1_BG_CODE="\033[48;5;${KUBE_PS1_BG_CODE}m"
  127. else
  128. KUBE_PS1_BG_CODE="${DEFAULT_BG}"
  129. fi
  130. fi
  131. echo ${OPEN_ESC}${KUBE_PS1_BG_CODE}${CLOSE_ESC}
  132. }
  133. _kube_ps1_binary_check() {
  134. command -v $1 >/dev/null
  135. }
  136. _kube_ps1_symbol() {
  137. [[ "${KUBE_PS1_SYMBOL_ENABLE}" == false ]] && return
  138. case "${KUBE_PS1_SHELL}" in
  139. bash)
  140. if ((BASH_VERSINFO[0] >= 4)) && [[ $'\u2388' != "\\u2388" ]]; then
  141. KUBE_PS1_SYMBOL="${KUBE_PS1_SYMBOL_DEFAULT}"
  142. KUBE_PS1_SYMBOL_IMG=$'\u2638\ufe0f'
  143. else
  144. KUBE_PS1_SYMBOL=$'\xE2\x8E\x88'
  145. KUBE_PS1_SYMBOL_IMG=$'\xE2\x98\xB8'
  146. fi
  147. ;;
  148. zsh)
  149. KUBE_PS1_SYMBOL="${KUBE_PS1_SYMBOL_DEFAULT}"
  150. KUBE_PS1_SYMBOL_IMG="\u2638";;
  151. *)
  152. KUBE_PS1_SYMBOL="k8s"
  153. esac
  154. if [[ "${KUBE_PS1_SYMBOL_USE_IMG}" == true ]]; then
  155. KUBE_PS1_SYMBOL="${KUBE_PS1_SYMBOL_IMG}"
  156. fi
  157. if [[ "${KUBE_PS1_SYMBOL_PADDING}" == true ]]; then
  158. echo "${KUBE_PS1_SYMBOL} "
  159. else
  160. echo "${KUBE_PS1_SYMBOL}"
  161. fi
  162. }
  163. _kube_ps1_split() {
  164. type setopt >/dev/null 2>&1 && setopt SH_WORD_SPLIT
  165. local IFS=$1
  166. echo $2
  167. }
  168. _kube_ps1_file_newer_than() {
  169. local mtime
  170. local file=$1
  171. local check_time=$2
  172. if [[ "${KUBE_PS1_KUBECONFIG_SYMLINK}" == "true" ]]; then
  173. if [[ "${KUBE_PS1_SHELL}" == "zsh" ]]; then
  174. mtime=$(zstat -L +mtime "${file}")
  175. elif stat -c "%s" /dev/null &> /dev/null; then
  176. # GNU stat
  177. mtime=$(stat -c %Y "${file}")
  178. else
  179. # BSD stat
  180. mtime=$(stat -f %m "$file")
  181. fi
  182. else
  183. if [[ "${KUBE_PS1_SHELL}" == "zsh" ]]; then
  184. mtime=$(zstat +mtime "${file}")
  185. elif stat -c "%s" /dev/null &> /dev/null; then
  186. # GNU stat
  187. mtime=$(stat -L -c %Y "${file}")
  188. else
  189. # BSD stat
  190. mtime=$(stat -L -f %m "$file")
  191. fi
  192. fi
  193. [[ "${mtime}" -gt "${check_time}" ]]
  194. }
  195. _kube_ps1_update_cache() {
  196. local return_code=$?
  197. [[ "${KUBE_PS1_ENABLED}" == "off" ]] && return $return_code
  198. if ! _kube_ps1_binary_check "${KUBE_PS1_BINARY}"; then
  199. # No ability to fetch context/namespace; display N/A.
  200. KUBE_PS1_CONTEXT="BINARY-N/A"
  201. KUBE_PS1_NAMESPACE="N/A"
  202. return
  203. fi
  204. if [[ "${KUBECONFIG}" != "${KUBE_PS1_KUBECONFIG_CACHE}" ]]; then
  205. # User changed KUBECONFIG; unconditionally refetch.
  206. KUBE_PS1_KUBECONFIG_CACHE=${KUBECONFIG}
  207. _kube_ps1_get_context_ns
  208. return
  209. fi
  210. # kubectl will read the environment variable $KUBECONFIG
  211. # otherwise set it to ~/.kube/config
  212. local conf
  213. for conf in $(_kube_ps1_split : "${KUBECONFIG:-${HOME}/.kube/config}"); do
  214. [[ -r "${conf}" ]] || continue
  215. if _kube_ps1_file_newer_than "${conf}" "${KUBE_PS1_LAST_TIME}"; then
  216. _kube_ps1_get_context_ns
  217. return
  218. fi
  219. done
  220. return $return_code
  221. }
  222. _kube_ps1_get_context() {
  223. if [[ "${KUBE_PS1_CONTEXT_ENABLE}" == true ]]; then
  224. KUBE_PS1_CONTEXT="$(${KUBE_PS1_BINARY} config current-context 2>/dev/null)"
  225. # Set namespace to 'N/A' if it is not defined
  226. KUBE_PS1_CONTEXT="${KUBE_PS1_CONTEXT:-N/A}"
  227. if [[ ! -z "${KUBE_PS1_CLUSTER_FUNCTION}" ]]; then
  228. KUBE_PS1_CONTEXT=$($KUBE_PS1_CLUSTER_FUNCTION $KUBE_PS1_CONTEXT)
  229. fi
  230. fi
  231. }
  232. _kube_ps1_get_ns() {
  233. if [[ "${KUBE_PS1_NS_ENABLE}" == true ]]; then
  234. KUBE_PS1_NAMESPACE="$(${KUBE_PS1_BINARY} config view --minify --output 'jsonpath={..namespace}' 2>/dev/null)"
  235. # Set namespace to 'default' if it is not defined
  236. KUBE_PS1_NAMESPACE="${KUBE_PS1_NAMESPACE:-default}"
  237. if [[ ! -z "${KUBE_PS1_NAMESPACE_FUNCTION}" ]]; then
  238. KUBE_PS1_NAMESPACE=$($KUBE_PS1_NAMESPACE_FUNCTION $KUBE_PS1_NAMESPACE)
  239. fi
  240. fi
  241. }
  242. _kube_ps1_get_context_ns() {
  243. # Set the command time
  244. if [[ "${KUBE_PS1_SHELL}" == "bash" ]]; then
  245. if ((BASH_VERSINFO[0] >= 4 && BASH_VERSINFO[1] >= 2)); then
  246. KUBE_PS1_LAST_TIME=$(printf '%(%s)T')
  247. else
  248. KUBE_PS1_LAST_TIME=$(date +%s)
  249. fi
  250. elif [[ "${KUBE_PS1_SHELL}" == "zsh" ]]; then
  251. KUBE_PS1_LAST_TIME=$EPOCHSECONDS
  252. fi
  253. _kube_ps1_get_context
  254. _kube_ps1_get_ns
  255. }
  256. # Set kube-ps1 shell defaults
  257. _kube_ps1_init
  258. _kubeon_usage() {
  259. cat <<"EOF"
  260. Toggle kube-ps1 prompt on
  261. Usage: kubeon [-g | --global] [-h | --help]
  262. With no arguments, turn off kube-ps1 status for this shell instance (default).
  263. -g --global turn on kube-ps1 status globally
  264. -h --help print this message
  265. EOF
  266. }
  267. _kubeoff_usage() {
  268. cat <<"EOF"
  269. Toggle kube-ps1 prompt off
  270. Usage: kubeoff [-g | --global] [-h | --help]
  271. With no arguments, turn off kube-ps1 status for this shell instance (default).
  272. -g --global turn off kube-ps1 status globally
  273. -h --help print this message
  274. EOF
  275. }
  276. kubeon() {
  277. if [[ "${1}" == '-h' || "${1}" == '--help' ]]; then
  278. _kubeon_usage
  279. elif [[ "${1}" == '-g' || "${1}" == '--global' ]]; then
  280. rm -f -- "${KUBE_PS1_DISABLE_PATH}"
  281. elif [[ "$#" -ne 0 ]]; then
  282. echo -e "error: unrecognized flag ${1}\\n"
  283. _kubeon_usage
  284. return
  285. fi
  286. KUBE_PS1_ENABLED=on
  287. }
  288. kubeoff() {
  289. if [[ "${1}" == '-h' || "${1}" == '--help' ]]; then
  290. _kubeoff_usage
  291. elif [[ "${1}" == '-g' || "${1}" == '--global' ]]; then
  292. mkdir -p -- "$(dirname "${KUBE_PS1_DISABLE_PATH}")"
  293. touch -- "${KUBE_PS1_DISABLE_PATH}"
  294. elif [[ $# -ne 0 ]]; then
  295. echo "error: unrecognized flag ${1}" >&2
  296. _kubeoff_usage
  297. return
  298. fi
  299. KUBE_PS1_ENABLED=off
  300. }
  301. # Build our prompt
  302. kube_ps1() {
  303. [[ "${KUBE_PS1_ENABLED}" == "off" ]] && return
  304. [[ -z "${KUBE_PS1_CONTEXT}" ]] && [[ "${KUBE_PS1_CONTEXT_ENABLE}" == true ]] && return
  305. local KUBE_PS1
  306. local KUBE_PS1_RESET_COLOR="${_KUBE_PS1_OPEN_ESC}${_KUBE_PS1_DEFAULT_FG}${_KUBE_PS1_CLOSE_ESC}"
  307. # Background Color
  308. [[ -n "${KUBE_PS1_BG_COLOR}" ]] && KUBE_PS1+="$(_kube_ps1_color_bg ${KUBE_PS1_BG_COLOR})"
  309. # Prefix
  310. if [[ -z "${KUBE_PS1_PREFIX_COLOR:-}" ]] && [[ -n "${KUBE_PS1_PREFIX}" ]]; then
  311. KUBE_PS1+="${KUBE_PS1_PREFIX}"
  312. else
  313. KUBE_PS1+="$(_kube_ps1_color_fg $KUBE_PS1_PREFIX_COLOR)${KUBE_PS1_PREFIX}${KUBE_PS1_RESET_COLOR}"
  314. fi
  315. # Symbol
  316. KUBE_PS1+="$(_kube_ps1_color_fg $KUBE_PS1_SYMBOL_COLOR)$(_kube_ps1_symbol)${KUBE_PS1_RESET_COLOR}"
  317. if [[ -n "${KUBE_PS1_SEPARATOR}" ]] && [[ "${KUBE_PS1_SYMBOL_ENABLE}" == true ]]; then
  318. KUBE_PS1+="${KUBE_PS1_SEPARATOR}"
  319. fi
  320. # Context
  321. if [[ "${KUBE_PS1_CONTEXT_ENABLE}" == true ]]; then
  322. KUBE_PS1+="$(_kube_ps1_color_fg $KUBE_PS1_CTX_COLOR)${KUBE_PS1_CONTEXT}${KUBE_PS1_RESET_COLOR}"
  323. fi
  324. # Namespace
  325. if [[ "${KUBE_PS1_NS_ENABLE}" == true ]]; then
  326. if [[ -n "${KUBE_PS1_DIVIDER}" ]] && [[ "${KUBE_PS1_CONTEXT_ENABLE}" == true ]]; then
  327. KUBE_PS1+="${KUBE_PS1_DIVIDER}"
  328. fi
  329. KUBE_PS1+="$(_kube_ps1_color_fg ${KUBE_PS1_NS_COLOR})${KUBE_PS1_NAMESPACE}${KUBE_PS1_RESET_COLOR}"
  330. fi
  331. # Suffix
  332. if [[ -z "${KUBE_PS1_SUFFIX_COLOR:-}" ]] && [[ -n "${KUBE_PS1_SUFFIX}" ]]; then
  333. KUBE_PS1+="${KUBE_PS1_SUFFIX}"
  334. else
  335. KUBE_PS1+="$(_kube_ps1_color_fg $KUBE_PS1_SUFFIX_COLOR)${KUBE_PS1_SUFFIX}${KUBE_PS1_RESET_COLOR}"
  336. fi
  337. # Close Background color if defined
  338. [[ -n "${KUBE_PS1_BG_COLOR}" ]] && KUBE_PS1+="${_KUBE_PS1_OPEN_ESC}${_KUBE_PS1_DEFAULT_BG}${_KUBE_PS1_CLOSE_ESC}"
  339. echo "${KUBE_PS1}"
  340. }