#!/usr/bin/env bash
# ------------------------------------------------------------------------------
# Copyright (c) 2013-2026 Geoffray Levasseur <fatalerrors@geoffray-levasseur.org>
# Protected by the BSD3 license. Please read bellow for details.
#
# * Redistribution and use in source and binary forms,
# * with or without modification, are permitted provided
# * that the following conditions are met:
# *
# *   Redistributions of source code must retain the above
# *   copyright notice, this list of conditions and the
# *   following disclaimer.
# *
# *   Redistributions in binary form must reproduce the above
# *   copyright notice, this list of conditions and the following
# *   disclaimer in the documentation and/or other materials
# *   provided with the distribution.
# *
# *   Neither the name of the copyright holder nor the names
# *   of any other contributors may be used to endorse or
# *   promote products derived from this software without
# *   specific prior written permission.
# *
# * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
# * CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
# * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
# * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
# * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
# * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
# * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
# * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
# * OF SUCH DAMAGE.
# ------------------------------------------------------------------------------

# ------------------------------------------------------------------------------
# Look for a package within installed one
# Usage: dpkgs <string>
pkgs()
{
    local ignore_case=0

    local PARSED
    PARSED=$(getopt -o hi --long help,ignore-case -n 'pkgs' -- "$@")
    if [[ $? -ne 0 ]]; then
        disp E "Invalid options, use \"pkgs --help\" to display usage."
        return 1
    fi
    eval set -- "$PARSED"

    while true; do
        case "$1" in
            -h|--help)
                printf "pkgs: Look for an installed package by its name.\n\n"
                printf "Usage: pkgs [options] <string>\n\n"
                printf "Options:\n"
                printf "\t-h, --help\tDisplay this help screen\n"
                printf "\t-i, --ignore-case\tIgnore case distinctions\n"
                return 0
                ;;
            -i|--ignore-case)
                ignore_case=1
                shift
                ;;
            --)
                shift
                break
                ;;
            *)
                disp E "Invalid option: $1"
                return 1
                ;;
        esac
    done

    local pkg="$1"
    [[ -z "$pkg" ]] && {
        disp E "Please specify a package name, without space, eventually partial."
        return 1
    }

    # Build grep command
    local grep_opt=""
    (( ignore_case )) && grep_opt="-i"

    command -v dpkg >/dev/null 2>&1 && local cmd="dpkg -l"
    command -v rpm >/dev/null 2>&1 && local cmd="rpm -qa"
    if [[ -z $cmd ]]; then
        disp E "No usable package manager seems unavialable."
        return 2
    fi
    $cmd | grep $grep_opt $pkg
}
export -f pkgs
# ------------------------------------------------------------------------------


# EOF