File: get.sh
   1 #!/bin/sh
   2 
   3 # The MIT License (MIT)
   4 #
   5 # Copyright © 2020-2025 pacman64
   6 #
   7 # Permission is hereby granted, free of charge, to any person obtaining a copy
   8 # of this software and associated documentation files (the “Software”), to deal
   9 # in the Software without restriction, including without limitation the rights
  10 # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  11 # copies of the Software, and to permit persons to whom the Software is
  12 # furnished to do so, subject to the following conditions:
  13 #
  14 # The above copyright notice and this permission notice shall be included in
  15 # all copies or substantial portions of the Software.
  16 #
  17 # THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  18 # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  19 # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  20 # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  21 # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  22 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  23 # SOFTWARE.
  24 
  25 
  26 # get [options...] [filepaths/URIs/data-URIs...]
  27 #
  28 # Get data from the named source given, whether this is a filename, a URI,
  29 # or even a base64-encoded data-URI. Data-URIs are simply decoded into the
  30 # bytes they represent, no loading/fetching required.
  31 #
  32 # The only options show this help message, via any of `-h`, `--h`, `-help`,
  33 # or `--help`.
  34 
  35 
  36 # fail quits the script right after showing the message given, using
  37 # exit code given as its 2nd arg
  38 fail() {
  39     printf "%s\n" "$1" > /dev/stderr
  40     exit "${2:-1}"
  41 }
  42 
  43 
  44 case "$1" in
  45     -h|--h|-help|--help)
  46         awk '/^# +get /, /^$/ { gsub(/^# ?/, ""); print }' "$0"
  47         exit 0
  48     ;;
  49 esac
  50 
  51 [ "$1" = "--" ] && shift
  52 
  53 dashes=0
  54 for name in "${@:--}"; do
  55     if [ "${name}" = "-" ]; then
  56         dashes="$((dashes + 1))"
  57     fi
  58 
  59     if [ "${dashes}" -gt 1 ]; then
  60         printf "can't use dash/stdin multiple times\n" >&2
  61         exit 1
  62     fi
  63 done
  64 
  65 for name in "${@:--}"; do
  66     if [ -z "${name}" ]; then
  67         continue
  68     fi
  69 
  70     # if the argument given is an existing file, just use `cat`, even if the
  71     # name looks like a protocol presumably meant for `curl`
  72     if [ -e "${name}" ]; then
  73         cat "${name}" || fail "failed to read file '${name}'" $?
  74         continue
  75     fi
  76 
  77     case "${name}" in
  78         # handle the commonest kinds of URIs
  79         http://*|https://*|ftp://*)
  80             # wget -O - "${name}" || fail "failed to fetch URI '${name}'" $?
  81             curl -s -L "${name}" || fail "failed to fetch URI '${name}'" $?
  82         ;;
  83 
  84         # handle more kinds of URIs
  85         dict://*|ftps://*|gopher://*|gophers://*|rtmp://*|rtsp://*|scp://*|\
  86         sftp://*|smb://*|smbs://*|telnet://*|tftp://*)
  87             curl -s -L "${name}" || fail "failed to fetch URI '${name}'" $?
  88         ;;
  89 
  90         # handle data-URIs
  91         data:*)
  92             {
  93                 echo "${name}" | sed -E 's-^data:.{0,50};base64,--' | base64 -d
  94             } || fail "failed to decode data-URI '${name}'" $?
  95         ;;
  96 
  97         # handle files
  98         file://*)
  99             cat "$(echo "${name}" | sed 's-^file://--')" 2> /dev/null ||
 100                 fail "failed to open file '${name}'" $?
 101         ;;
 102 
 103         # handle standard input
 104         -)
 105             cat "${name}" 2> /dev/null ||
 106                 fail "failed to read from the standard input" $?
 107         ;;
 108 
 109         # handle files
 110         *)
 111             cat "${name}" 2> /dev/null ||
 112                 fail "failed to open file '${name}'" $?
 113         ;;
 114     esac
 115 done