updated README

list files provided by package

README.md

@@ -1,15 +1,33 @@
 # pman.sh
-A `pacman` helper script, because you forget the stupid flags
+A `pacman` helper script, because you forget all the stupid flags
 
 ## Usage / Features:
+- aur/yay
 - search
+- info
+- localinfo
+- provides
+- providefiles
+- installed
+- install
 - update
 - upgradable
 - upgrade
-- install
-- provides
+- remove
+- purge
+- clean
+- reflector
+- ignored
+- ignore
+- unignore
 - config
 
-`config` is the only flag that is not appended to `pacman`, instead it resolves to `nano /etc/pacman.conf`.
+`reflector` and `config` are the only flag that are not appended to `pacman` (or `yay`)<br>
+instead `reflector` resolves to using the `reflector` program with the previously used parameters stored in `/etc/pacman.d/mirrorlist`<br>
+and `config` resolves to `nano /etc/pacman.conf`.<br>
+`ignore` and `unignore` require the file `/etc/pacman.d/ignorepkg` to exist (you can use `install -m0644 /etc/pacman.d/ignorepkg` to create it),<br>
+and the line `Include /etc/pacman.d/ignorepkg` to be inserted into `/etc/pacman.conf`.
 
-`sudo` gets prepended automatically if the command requires it and if installed - no, there is no check if your user is in the `sudo` group, if you download this script you should already be, or know you can only use part of this utility
+`sudo` gets prepended automatically if the command requires root privileges, if the UID is not 0 (you are not `root`) and if `sudo` installed.<br>
+no, there is no check if your user is in the `sudo` group, if you download this script you should already be, or know you can only use part of this utility<br>
+tho such a feature is planned, to make the script truly ubiquitus.

pman.sh

@@ -7,8 +7,26 @@ command=""
 more_arguments=false
 su_needed=false
 
+# If sudo is needed and necessary (and installed), prepend it, if not installed throw error
+check_sudo() {
+  if [ "$su_needed" = "true" ] && [ "$UID" != 0 ]; then
+    if command -v "sudo" &>/dev/null; then
+      command="sudo $command"
+    else
+      echo "sudo command needed but not found" > /dev/stderr
+      exit 1
+    fi
+  fi
+}
+
+# Execute the command
+execute_command() {
+  check_sudo
+  $command $command_args "${@}"
+}
+
 # Check if yay (aur)
-if [ "$command_args" = "yay" ]; then
+if [ "$command_args" = "yay" ] || [ "$command_args" = "aur" ]; then
   command="yay"
   command_args="$1"
   shift
@@ -18,6 +36,38 @@ elif [ "$command_args" = "config" ]; then
   command="nano"
   command_args="/etc/pacman.conf"
   su_needed=true
+elif [ "$command_args" = "reflector" ]; then
+  command="reflector"
+  command_args=$(cat /etc/pacman.d/mirrorlist 2>/dev/null | grep -e "With.*reflector" | sed 's/#.*reflector //')
+  # Check if reflector was actually used to generate the mirrorlist
+  if [ "$command_args" = "" ]; then
+    echo "Error: reflector was not used to generate mirrorlist or mirrorlist location differ from standard"
+    exit 1
+  fi
+  su_needed=true
+elif [ "$command_args" = "ignored" ]; then
+  command="echo"
+  command_args="$(cat /etc/pacman.d/ignorepkg | sed 's/IgnorePkg = //' | sort)"
+elif [ "$command_args" = "ignore" ]; then
+  for pkg in "${@}"; do
+    if [ "$(grep -e "$pkg$" /etc/pacman.d/ignorepkg)" != "" ]; then
+      echo "$pkg is already ignored, skipping..."
+      continue
+    fi
+    command="tee"
+    command_args="-a /etc/pacman.d/ignorepkg"
+    su_needed=true
+    echo "IgnorePkg = $pkg" | execute_command &>/dev/null
+  done
+  exit 0
+elif [ "$command_args" = "unignore" ]; then
+  for pkg in "${@}"; do
+    command="sed"
+    su_needed=true
+    check_sudo
+    $command -i "/IgnorePkg = $pkg/d" /etc/pacman.d/ignorepkg
+  done
+  exit 0
 fi
 
 # If command is empty, command is pacman
@@ -27,29 +77,86 @@ if [ "$command" = "" ]; then
 fi
 
 # Evaluate the command arguments
-if [ "$command_args" = "search" ]; then
+case "$command_args" in
+  "search")
     command_args="-Ss"
-elif [ "$command_args" = "update" ]; then
-  command_args="-Sy"
-  if [ "$command" = "pacman" ]; then
+    ;;
+  "info")
+    command_args="-Si"
+    ;;
+  "localinfo")
+    command_args="-Qi"
+    ;;
+  "provides")
+    # Update the cache
     su_needed=true
-  fi
-elif [ "$command_args" = "upgradable" ]; then
-  command_args="-Qu"
-elif [ "$command_args" = "upgrade" ]; then
-  command_args="-Syu"
-  if [ "$command" = "pacman" ]; then
+    command_args="-Fy"
+    execute_command "${@}"
+
+    su_needed=false
+    command_args="-F"
+    ;;
+  "providefiles")
+    # Update the cache
     su_needed=true
-  fi
-elif [ "$command_args" = "install" ]; then
+    command_args="-Fy"
+    execute_command "${@}"
+
+    su_needed=false
+    command_args="-Fl"
+    ;;
+  "installed")
+    command_args="-Q"
+    ;;
+  "install")
     command_args="-S"
     if [ "$command" = "pacman" ]; then
       su_needed=true
     fi
-elif [ "$command_args" = "provides" ]; then
-  command_args="-F"
-elif [ "$more_arguments" = "true" ]; then
-  echo "Invalid command: \"$command $command_args\""
+    ;;
+  "update")
+    command_args="-Sy"
+    if [ "$command" = "pacman" ]; then
+      su_needed=true
+    fi
+    execute_command "${@}"
+
+    su_needed=false
+    command_args="-Qu"
+    echo
+    echo "$(execute_command "${@}" | wc -l) packages are available for update"
+    exit 0
+    ;;
+  "upgradable")
+    command_args="-Qu"
+    ;;
+  "upgrade")
+    command_args="-Syu"
+    if [ "$command" = "pacman" ]; then
+      su_needed=true
+    fi
+    ;;
+  "remove")
+    command_args="-Rs"
+    if [ "$command" = "pacman" ]; then
+      su_needed=true
+    fi
+    ;;
+  "purge")
+    command_args="-Rns"
+    if [ "$command" = "pacman" ]; then
+      su_needed=true
+    fi
+    ;;
+  "clean")
+    command_args="-Scc"
+    if [ "$command" = "pacman" ]; then
+      su_needed=true
+    fi
+    ;;
+  *)
+    if [ "$more_arguments" = "true" ]; then
+      echo "Invalid command: \"$command_args\""
       echo
       echo "Usage: pman <command> [args...]"
       echo "Available commands:"
@@ -57,17 +164,28 @@ elif [ "$more_arguments" = "true" ]; then
       echo "               (aur packages - all the normal operations except config are available)"
       echo "  aur (yay)    - yay                     | same as \"yay\""
       echo "  search       - pacman -Ss              | search packages"
+      echo "  info         - pacman -Si              | show package information"
+      echo "  localinfo    - pacman -Qi              | show local package information"
+      echo "  provides     - pacman -F               | list packages that provide file"
+      echo "  providefiles - pacman -Fl              | list files provided by package"
+      echo "  installed    - pacman -Q               | list installed packages"
+      echo "  install      - pacman -S               | install packages"
       echo "  update       - pacman -Sy              | updates the repositories"
       echo "  upgradable   - pacman -Qu              | list available upgrades"
       echo "  upgrade      - pacman -Syu             | upgrades your system"
-  echo "  provides   - pacman -F        | list packages that provide file"
+      echo "  remove       - pacman -Rs              | remove packages & dependencies"
+      echo "  purge        - pacman -Rns             | remove packages, dependencies & conf"
+      echo "  clean        - pacman -Scc             | remove all package files & trash"
+      echo "  reflector    - mirrorlist              | refresh the mirrorlist with reflector (if used)"
+      echo "               (do not use if file location differ from default /etc/pacman.d/mirrorlist)"
+      echo "  ignored      - /etc/pacman.d/ignorepkg | lists the packages which are ignored from update"
+      echo "               (must create /etc/pacman.d/ignorepkg file and import it in /etc/pacman.conf)"
+      echo "  ignore       - /etc/pacman.d/ignorepkg | ignore package(s) from update"
+      echo "  unignore     - /etc/pacman.d/ignorepkg | un-ignore package(s) from update"
       echo "  config       - /etc/pacman.conf        | edits pacman configuration"
       exit 1
-fi
+    fi
+    ;;
+esac
 
-# If sudo is needed and necessary (and installed), prepend it
-if [ "$su_needed" = "true" ] && [ "$UID" != 0 ] && command -v "sudo" &>/dev/null; then
-  sudo $command $command_args "${@}"
-else
-  $command $command_args "${@}"
-fi
+execute_command "${@}"