X-Git-Url: https://glassweightruler.freedombox.rocks/gitweb/xdg-ninja.git/blobdiff_plain/dac2f65809187c27832ee2c15c19d82981ebe6fe..4e9316b332eaa0ed5832a1246878dd6b015cb038:/xdg-ninja.sh?ds=sidebyside diff --git a/xdg-ninja.sh b/xdg-ninja.sh index 820c8e9..94a8969 100755 --- a/xdg-ninja.sh +++ b/xdg-ninja.sh @@ -1,10 +1,17 @@ -#!/bin/bash - -USE_GLOW=true -if ! command -v glow &> /dev/null -then - echo "Glow not found, markdown rendering not available." - USE_GLOW=false +#!/usr/bin/env sh + +USE_GLOW=false +USE_BAT=false +if command -v glow >/dev/null 2>/dev/null; then + USE_GLOW=true +elif command -v bat >/dev/null 2>/dev/null; then + USE_BAT=true + printf "Glow not found, markdown rendering will be done by bat.\n" + printf "Install glow for easier reading & copy-paste.\n" +else + printf "Glow or bat not found, markdown rendering not available.\n" + printf "Output will be raw markdown and might look weird.\n" + printf "Install glow for easier reading & copy-paste.\n" fi unalias -a @@ -12,70 +19,90 @@ unalias -a HELPSTRING="""\ - \e[37;45;1mxdg-ninja\e[0m + \033[37;45;1mxdg-ninja\033[0m - \e[1;3mCheck your \$HOME for unwanted files.\e[1;0m + \033[1;3mCheck your \$HOME for unwanted files.\033[1;0m ──────────────────────────────────── - \e[3m--help\e[0m \e[1mThis help menu\e[0m - \e[3m-h\e[0m + \033[3m--help\033[0m \033[1mThis help menu\033[0m + \033[3m-h\033[0m - \e[3m--no-skip-ok\e[0m \e[1mDisplay messages for all files checked (verbose)\e[0m - \e[3m-v\e[0m + \033[3m--no-skip-ok\033[0m \033[1mDisplay messages for all files checked (verbose)\033[0m + \033[3m-v\033[0m - \e[3m--skip-ok\e[0m \e[1mDon't display anything for files that do not exist (default)\e[0m + \033[3m--skip-ok\033[0m \033[1mDon't display anything for files that do not exist (default)\033[0m """ SKIP_OK=true -for i in "$@" ; do - if [[ $i == "--help" ]] || [[ $i == "-h" ]] ; then - echo -e "$HELPSTRING" +for i in "$@"; do + if [ "$i" = "--help" ] || [ "$i" = "-h" ]; then + printf "%b" "$HELPSTRING" exit - elif [[ $i == "--skip-ok" ]] ; then + elif [ "$i" = "--skip-ok" ]; then SKIP_OK=true - elif [[ $i == "--no-skip-ok" ]] ; then + elif [ "$i" = "--no-skip-ok" ]; then SKIP_OK=false - elif [[ $i == "-v" ]] ; then + elif [ "$i" = "-v" ]; then SKIP_OK=false fi done -if ! command -v jq &> /dev/null -then - echo "jq is needed to run this script, but it wasn't found. Please install it to be able to use this script." +if [ -z "${XDG_DATA_HOME}" ]; then + printf '\033[1;36m%s\033[1;0m\n' "The \$XDG_DATA_HOME environment variable is not set, make sure to add it to your shell's configuration before setting any of the other environment variables!" + printf "\033[1;36m ⤷ \033[1mThe recommended value is: \033[1;3m\$HOME/.local/share\033[1;0m\n" +fi +if [ -z "${XDG_CONFIG_HOME}" ]; then + printf '\033[1;36m%s\033[1;0m\n' "The \$XDG_CONFIG_HOME environment variable is not set, make sure to add it to your shell's configuration before setting any of the other environment variables!" + printf "\033[1;36m ⤷ \033[1mThe recommended value is: \033[1;3m\$HOME/.config\033[1;0m\n" +fi +if [ -z "${XDG_STATE_HOME}" ]; then + printf '\033[1;36m%s\033[1;0m\n' "The \$XDG_STATE_HOME environment variable is not set, make sure to add it to your shell's configuration before setting any of the other environment variables!" + printf "\033[1;36m ⤷ \033[1mThe recommended value is: \033[1;3m\$HOME/.local/state\033[1;0m\n" +fi +if [ -z "${XDG_CACHE_HOME}" ]; then + printf '\033[1;36m%s\033[1;0m\n' "The \$XDG_CACHE_HOME environment variable is not set, make sure to add it to your shell's configuration before setting any of the other environment variables!" + printf "\033[1;36m ⤷ \033[1mThe recommended value is: \033[1;3m\$HOME/.cache\033[1;0m\n" +fi +if [ -z "${XDG_RUNTIME_DIR}" ]; then + printf '\033[1;36m%s\033[1;0m\n' "The \$XDG_RUNTIME_DIR environment variable is not set, make sure to add it to your shell's configuration before setting any of the other environment variables!" + printf "\033[1;36m ⤷ \033[1mThe recommended value is: \033[1;3m/run/user/\$UID\033[1;0m\n" +fi + +if ! command -v jq >/dev/null 2>/dev/null; then + printf "jq is needed to run this script, but it wasn't found. Please install it to be able to use this script.\n" exit fi -ERR=0 -WARN=1 -INFO=2 -SUCS=3 -HELP=4 +printf "\n" -# Function to expand enviornment variables in string +# Function to expand environment variables in string # https://stackoverflow.com/a/20316582/11110290 apply_shell_expansion() { - declare data="$1" - declare delimiter="__apply_shell_expansion_delimiter__" - declare command="cat <<$delimiter"$'\n'"$data"$'\n'"$delimiter" + data="$1" + delimiter="__apply_shell_expansion_delimiter__" + command=$(printf "cat <<%s\n%s\n%s" "$delimiter" "$data" "$delimiter") eval "$command" } # Returns 0 if the path doesn't lead anywhere -# Return 1 if the path points to a file, 2 if it points to a directory -check_not_exists_file() { +# Returns 1 if the path leads to something +check_if_file_exists() { FILE_PATH=$(apply_shell_expansion "$1") - if [ -f "$FILE_PATH" ]; then + if [ -e "$FILE_PATH" ]; then return 1 - elif [ -d "$FILE_PATH" ]; then - return 2 else return 0 fi } +decode_string() { + printf "%s" "$1" | sed -e 's/\\n/\ +/g' -e 's/\\\"/\"/g' -e '$ s/\n*$/\ +\ +/' # Replace \n with literal newline and \" with ", normalize number of trailing newlines to 2 +} # Function to handle the formatting of output log() { @@ -86,91 +113,86 @@ log() { case "$MODE" in - ERR) - printf "[\e[1;31m$NAME\e[1;0m]: \e[1;3m$FILENAME\e[1;0m\n" - ;; - - WARN) - printf "[\e[1;33m$NAME\e[1;0m]: \e[1;3m$FILENAME\e[1;0m\n" - ;; - - INFO) - printf "[\e[1;36m$NAME\e[1;0m]: \e[1;3m$FILENAME\e[1;0m\n" - ;; - - SUCS) - if [ "$SKIP_OK" = false ]; then - printf "[\e[1;32m$NAME\e[1;0m]: \e[1;3m$FILENAME\e[1;0m\n" - fi - ;; - - HELP) - if $USE_GLOW; then - echo "$HELP" | glow - - else - echo "$HELP" - fi - ;; + ERR) + printf '[\033[1;31m%s\033[1;0m]: \033[1;3m%s\033[1;0m\n' "$NAME" "$FILENAME" + ;; + + WARN) + printf '[\033[1;33m%s\033[1;0m]: \033[1;3m%s\033[1;0m\n' "$NAME" "$FILENAME" + ;; + + INFO) + printf '[\033[1;36m%s\033[1;0m]: \033[1;3m%s\033[1;0m\n' "$NAME" "$FILENAME" + ;; + + SUCS) + [ "$SKIP_OK" = false ] && + printf '[\033[1;32m%s\033[1;0m]: \033[1;3m%s\033[1;0m\n' "$NAME" "$FILENAME" + ;; + + HELP) + if [ "$USE_GLOW" = true ]; then + decode_string "$HELP" | glow - + elif [ "$USE_BAT" = true ]; then + decode_string "$HELP" | bat -pp --decorations=always --color=always --language markdown + else + decode_string "$HELP" + fi + ;; esac } # Checks that the given file does not exist, otherwise outputs help check_file() { - INPUT="$1" - NAME="$2" - - FILENAME=$(echo -E "$INPUT" | jq -r .path) - MOVABLE=$(echo -E "$INPUT" | jq -r .movable) - HELP=$(echo -E "$INPUT" | jq -r .help) + NAME="$1" + FILENAME="$2" + MOVABLE="$3" + HELP="$4" - check_not_exists_file "$FILENAME" + check_if_file_exists "$FILENAME" case $? in - 0) - log SUCS "$NAME" "$FILENAME" "$HELP" - ;; - - 1 | 2) - if "$MOVABLE"; then - log ERR "$NAME" "$FILENAME" "$HELP" - else - log WARN "$NAME" "$FILENAME" "$HELP" - fi - if ! [ -z "$HELP" ]; then - log HELP "$NAME" "$FILENAME" "$HELP" - else - log HELP "$NAME" "$FILENAME" "_No help available._" - fi - ;; + 0) + log SUCS "$NAME" "$FILENAME" "$HELP" + ;; + + 1) + if [ "$MOVABLE" = true ]; then + log ERR "$NAME" "$FILENAME" "$HELP" + else + log WARN "$NAME" "$FILENAME" "$HELP" + fi + if [ "$HELP" ]; then + log HELP "$NAME" "$FILENAME" "$HELP" + else + log HELP "$NAME" "$FILENAME" "_No help available._" + fi + ;; esac } -# Reads a file from programs/, calls check_file on each file specified for the program -check_program() { - INPUT=$1 - - NAME=$(echo "$INPUT" | jq -r .name) - - - while IFS= read -r file; do - check_file "$file" "$NAME" - done <<< "$(echo "$INPUT" | jq -rc '.files[]')" +# Reads files from programs/, calls check_file on each file specified for each program +do_check_programs() { + while IFS=" +" read -r name; read -r filename; read -r movable; read -r help; do + check_file "$name" "$filename" "$movable" "$help" + done <