xpl

#!/bin/bash
# @Function
# Open file in file explorer.
#
# @Usage
#   $ ./xpf [file [file ...] ]
#
# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-2.x/docs/shell.md#-xpl-and-xpf
# @author Jerry Lee (oldratlee at gmail dot com)
#
# NOTE about Bash Traps and Pitfalls:
#
# 1. DO NOT combine var declaration and assignment which value supplied by subshell in ONE line!
#    for example: readonly var1=$(echo value1)
#                 local var2=$(echo value1)
#
#    Because the combination make exit code of assignment to be always 0,
#      aka. the exit code of command in subshell is discarded.
#      tested on bash 3.2.57/4.2.46
#
#    solution is separation of var declaration and assignment:
#           var1=$(echo value1)
#           readonly var1
#           local var2
#           var2=$(echo value1)
set -eEuo pipefail

# NOTE: DO NOT declare var PROG as readonly in ONE line!
PROG="$(basename -- "$0")"
readonly PROG
readonly PROG_VERSION='2.6.0-dev'

################################################################################
# util functions
################################################################################

usage() {
  local -r exit_code="${1:-0}"
  (($# > 0)) && shift
  local -r out=$(((exit_code != 0) + 1))

  (($# > 0)) && printf '%s\n\n' "$*" >&"$out"

  cat >&"$out" <<EOF
Usage: ${PROG} [OPTION] [FILE]...
Open file in file explorer.
Example: ${PROG} file.txt

Options:
    -s, --selected  select the file or dir
    -h, --help      display this help and exit
    -V, --version   display version information and exit
EOF

  # shellcheck disable=SC2086
  exit "$exit_code"
}

progVersion() {
  printf '%s\n' "$PROG $PROG_VERSION"
  exit
}

################################################################################
# parse options
################################################################################

declare -a files=()
selected=false
while [ $# -gt 0 ]; do
  case "$1" in
  -s | --selected)
    selected=true
    shift
    ;;
  -h | --help)
    usage
    ;;
  -V | --version)
    progVersion
    ;;
  --)
    shift
    files=(${files[@]:+"${files[@]}"} "$@")
    break
    ;;
  -*)
    usage 2 "${PROG}: unrecognized option '$1'"
    ;;
  *)
    files=(${files[@]:+"${files[@]}"} "$1")
    shift
    ;;
  esac
done

# if files is empty, use one element "."
files=("${files[@]:-.}")

# if program name is xpf, set option selected!
[ "xpf" == "${PROG}" ] && selected=true

readonly files selected

################################################################################
# biz logic
################################################################################

# open one file
openOneFile() {
  local file="$1" slt="${selected}"

  case "$(uname)" in
  Darwin*)
    [ -f "${file}" ] && slt=true
    if $slt; then
      open -R "$file"
    else
      open "$file"
    fi
    ;;
  CYGWIN*)
    [ -f "${file}" ] && slt=true
    if $slt; then
      explorer /select, "$(cygpath -w "${file}")"
    else
      explorer "$(cygpath -w "${file}")"
    fi
    ;;
  *)
    if [ -d "${file}" ]; then
      nautilus "$(dirname -- "${file}")"
    else
      if $slt; then
        nautilus "${file}"
      else
        nautilus "$(dirname -- "${file}")"
      fi
    fi
    ;;
  esac

  local selected_msg
  $slt && selected_msg='with selection'
  printf 'open %14s: %s\n' "$selected_msg" "$file"
}

has_error=false

for file in "${files[@]}"; do
  [ ! -e "$file" ] && {
    printf '%s\n' "$file not existed!"
    continue
  }

  openOneFile "$file"
done

# set exit status
! $has_error