mirror of https://github.com/bpkg/bpkg
List Commands with Descriptions (#161)
* Updated `utils.sh` with `bpkg_exec_exist` and `bpkg_exec_or_exit`. * Updated scripts with `bpkg_exec_or_exit`. * Updated `install.sh` to utilize utility functions. * Updated `runner` in `run.sh`. * Added `--list` option to `run.sh`. * Added `commands-description` to `bpkg.json`. * Updated README TOC and missing `dependencies-dev` section. * Added `commands-description` section to README. * Corrected failing shellcheck.pull/162/head
parent
e2e373acf6
commit
79481450fe
@ -1,161 +1,185 @@
|
|||||||
#!/usr/bin/env bash
|
#!/usr/bin/env bash
|
||||||
|
|
||||||
if ! type -f bpkg-env &>/dev/null; then
|
if [ -z "${BPKG_UTILS}" ]; then
|
||||||
echo "error: bpkg-env not found, aborting"
|
BPKG_UTILS=1
|
||||||
exit 1
|
|
||||||
else
|
## Collection of shared bpkg functions
|
||||||
# shellcheck disable=SC2230
|
|
||||||
# shellcheck source=lib/env/env.sh
|
## Init local config and set environmental defaults
|
||||||
source "$(which bpkg-env)"
|
bpkg_initrc () {
|
||||||
fi
|
local global_config=${BPKG_GLOBAL_CONFIG:-"/etc/bpkgrc"}
|
||||||
|
# shellcheck disable=SC1090
|
||||||
|
[ -f "$global_config" ] && source "$global_config"
|
||||||
|
local config=${BPKG_CONFIG:-"$HOME/.bpkgrc"}
|
||||||
|
# shellcheck disable=SC1090
|
||||||
|
[ -f "$config" ] && source "$config"
|
||||||
|
## set defaults
|
||||||
|
if [ ${#BPKG_REMOTES[@]} -eq 0 ]; then
|
||||||
|
BPKG_REMOTES[0]=${BPKG_REMOTE-https://raw.githubusercontent.com}
|
||||||
|
BPKG_GIT_REMOTES[0]=${BPKG_GIT_REMOTE-https://github.com}
|
||||||
|
|
||||||
|
export BPKG_REMOTES
|
||||||
|
export BPKG_GIT_REMOTE
|
||||||
|
export BPKG_GIT_REMOTES
|
||||||
|
fi
|
||||||
|
|
||||||
## Collection of shared bpkg functions
|
export BPKG_PACKAGE_USER="${BPKG_PACKAGE_USER:-"bpkg"}"
|
||||||
|
export BPKG_INDEX=${BPKG_INDEX:-"$HOME/.bpkg/index"}
|
||||||
## Init local config and set environmental defaults
|
|
||||||
bpkg_initrc() {
|
bpkg_validate
|
||||||
local global_config=${BPKG_GLOBAL_CONFIG:-"/etc/bpkgrc"}
|
|
||||||
# shellcheck disable=SC1090
|
return $?
|
||||||
[ -f "$global_config" ] && source "$global_config"
|
}
|
||||||
local config=${BPKG_CONFIG:-"$HOME/.bpkgrc"}
|
|
||||||
# shellcheck disable=SC1090
|
## check parameter consistency
|
||||||
[ -f "$config" ] && source "$config"
|
bpkg_validate () {
|
||||||
## set defaults
|
if [ ${#BPKG_GIT_REMOTES[@]} -ne ${#BPKG_REMOTES[@]} ]; then
|
||||||
if [ ${#BPKG_REMOTES[@]} -eq 0 ]; then
|
bpkg_error "$(printf 'BPKG_GIT_REMOTES[%d] differs in size from BPKG_REMOTES[%d] array' "${#BPKG_GIT_REMOTES[@]}" "${#BPKG_REMOTES[@]}")"
|
||||||
BPKG_REMOTES[0]=${BPKG_REMOTE-https://raw.githubusercontent.com}
|
return 1
|
||||||
BPKG_GIT_REMOTES[0]=${BPKG_GIT_REMOTE-https://github.com}
|
fi
|
||||||
|
return 0
|
||||||
export BPKG_REMOTES
|
}
|
||||||
export BPKG_GIT_REMOTE
|
|
||||||
export BPKG_GIT_REMOTES
|
|
||||||
fi
|
## format and output message
|
||||||
|
bpkg_message () {
|
||||||
export BPKG_PACKAGE_USER="${BPKG_PACKAGE_USER:-"bpkg"}"
|
bpkg_exec_exist bpkg-term &&
|
||||||
export BPKG_INDEX=${BPKG_INDEX:-"$HOME/.bpkg/index"}
|
bpkg-term color "${1}"
|
||||||
|
shift
|
||||||
bpkg_validate
|
|
||||||
|
echo -n " ${1}"
|
||||||
return $?
|
|
||||||
}
|
|
||||||
|
|
||||||
## check parameter consistency
|
|
||||||
bpkg_validate () {
|
|
||||||
if [ ${#BPKG_GIT_REMOTES[@]} -ne ${#BPKG_REMOTES[@]} ]; then
|
|
||||||
bpkg_error "$(printf 'BPKG_GIT_REMOTES[%d] differs in size from BPKG_REMOTES[%d] array' "${#BPKG_GIT_REMOTES[@]}" "${#BPKG_REMOTES[@]}")"
|
|
||||||
return 1
|
|
||||||
fi
|
|
||||||
return 0
|
|
||||||
}
|
|
||||||
|
|
||||||
## format and output message
|
|
||||||
bpkg_message () {
|
|
||||||
if type -f bpkg-term > /dev/null 2>&1; then
|
|
||||||
bpkg-term color "${1}"
|
|
||||||
fi
|
|
||||||
|
|
||||||
shift
|
|
||||||
echo -n " ${1}"
|
|
||||||
shift
|
|
||||||
|
|
||||||
if type -f bpkg-term > /dev/null 2>&1; then
|
|
||||||
bpkg-term reset
|
|
||||||
fi
|
|
||||||
|
|
||||||
printf ": "
|
|
||||||
|
|
||||||
if type -f bpkg-term > /dev/null 2>&1; then
|
|
||||||
bpkg-term reset
|
|
||||||
bpkg-term bright
|
|
||||||
fi
|
|
||||||
|
|
||||||
printf "%s\n" "${@}"
|
|
||||||
|
|
||||||
if type -f bpkg-term > /dev/null 2>&1; then
|
|
||||||
bpkg-term reset
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
|
|
||||||
## output error
|
|
||||||
bpkg_error () {
|
|
||||||
{
|
|
||||||
bpkg_message "red" "error" "${@}"
|
|
||||||
} >&2
|
|
||||||
}
|
|
||||||
|
|
||||||
## output warning
|
|
||||||
bpkg_warn () {
|
|
||||||
{
|
|
||||||
bpkg_message "yellow" "warn" "${@}"
|
|
||||||
} >&2
|
|
||||||
}
|
|
||||||
|
|
||||||
## output info
|
|
||||||
bpkg_info () {
|
|
||||||
local title="info"
|
|
||||||
if (( "${#}" > 1 )); then
|
|
||||||
title="${1}"
|
|
||||||
shift
|
shift
|
||||||
fi
|
|
||||||
bpkg_message "cyan" "${title}" "${@}"
|
bpkg_exec_exist bpkg-term &&
|
||||||
}
|
bpkg-term reset
|
||||||
|
|
||||||
## takes a remote and git-remote and sets the globals:
|
printf ": "
|
||||||
## BPKG_REMOTE: raw remote URI
|
|
||||||
## BPKG_GIT_REMOTE: git remote for cloning
|
bpkg_exec_exist bpkg-term && {
|
||||||
## BPKG_AUTH_GIT_REMOTE: git remote with oauth info embedded,
|
bpkg-term reset
|
||||||
## BPKG_OAUTH_TOKEN: token for x-oauth-basic
|
bpkg-term bright
|
||||||
## BPKG_CURL_AUTH_PARAM: auth arguments for raw curl requests
|
}
|
||||||
## BPKG_REMOTE_INDEX: location of local index for remote
|
|
||||||
bpkg_select_remote () {
|
printf "%s\n" "${@}"
|
||||||
local remote=$1
|
|
||||||
local git_remote=$2
|
bpkg_exec_exist bpkg-term &&
|
||||||
export BPKG_REMOTE_HOST=$(echo "$git_remote" | sed 's/.*:\/\///' | sed 's/\/$//' | tr '/' '_')
|
bpkg-term reset
|
||||||
export BPKG_REMOTE_INDEX="$BPKG_INDEX/$BPKG_REMOTE_HOST"
|
}
|
||||||
# shellcheck disable=SC2034
|
|
||||||
export BPKG_REMOTE_INDEX_FILE="$BPKG_REMOTE_INDEX/index.txt"
|
## output error
|
||||||
export BPKG_OAUTH_TOKEN=""
|
bpkg_error () {
|
||||||
export BPKG_CURL_AUTH_PARAM=""
|
{
|
||||||
export BPKG_GIT_REMOTE=$git_remote
|
bpkg_message "red" "error" "${@}"
|
||||||
export BPKG_AUTH_GIT_REMOTE=$git_remote
|
} >&2
|
||||||
if [ "${remote:0:10}" == "raw-oauth|" ]; then
|
}
|
||||||
OLDIFS="${IFS}"
|
|
||||||
IFS="|"
|
## output warning
|
||||||
# shellcheck disable=SC2206
|
bpkg_warn () {
|
||||||
local remote_parts=($remote)
|
{
|
||||||
IFS="${OLDIFS}"
|
bpkg_message "yellow" "warn" "${@}"
|
||||||
export BPKG_OAUTH_TOKEN=${remote_parts[1]}
|
} >&2
|
||||||
|
}
|
||||||
|
|
||||||
|
## output info
|
||||||
|
bpkg_info () {
|
||||||
|
local title="info"
|
||||||
|
if (( "${#}" > 1 )); then
|
||||||
|
title="${1}"
|
||||||
|
shift
|
||||||
|
fi
|
||||||
|
bpkg_message "cyan" "${title}" "${@}"
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
## check if executable exists in path
|
||||||
|
bpkg_exec_exist () {
|
||||||
|
local exec_name="${1}"
|
||||||
|
|
||||||
|
type -f "${exec_name}" > /dev/null 2>&1
|
||||||
|
}
|
||||||
|
|
||||||
|
## executable exists in path or exit with message
|
||||||
|
bpkg_exec_or_exit () {
|
||||||
|
local exec_name="${1}"
|
||||||
|
local exit_error="${2:-1}"
|
||||||
|
|
||||||
|
if ! bpkg_exec_exist "${exec_name}"; then
|
||||||
|
bpkg_error "${exec_name} not found, aborting"
|
||||||
|
exit "${exit_error}"
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
## takes a remote and git-remote and sets the globals:
|
||||||
|
## BPKG_REMOTE: raw remote URI
|
||||||
|
## BPKG_GIT_REMOTE: git remote for cloning
|
||||||
|
## BPKG_AUTH_GIT_REMOTE: git remote with oauth info embedded,
|
||||||
|
## BPKG_OAUTH_TOKEN: token for x-oauth-basic
|
||||||
|
## BPKG_CURL_AUTH_PARAM: auth arguments for raw curl requests
|
||||||
|
## BPKG_REMOTE_INDEX: location of local index for remote
|
||||||
|
bpkg_select_remote () {
|
||||||
|
local remote=$1
|
||||||
|
local git_remote=$2
|
||||||
|
export BPKG_REMOTE_HOST=$(echo "$git_remote" | sed 's/.*:\/\///' | sed 's/\/$//' | tr '/' '_')
|
||||||
|
export BPKG_REMOTE_INDEX="$BPKG_INDEX/$BPKG_REMOTE_HOST"
|
||||||
# shellcheck disable=SC2034
|
# shellcheck disable=SC2034
|
||||||
export BPKG_CURL_AUTH_PARAM="-u $BPKG_OAUTH_TOKEN:x-oauth-basic"
|
export BPKG_REMOTE_INDEX_FILE="$BPKG_REMOTE_INDEX/index.txt"
|
||||||
export BPKG_REMOTE=${remote_parts[2]}
|
export BPKG_OAUTH_TOKEN=""
|
||||||
if [[ "$git_remote" == https://* ]] && [[ "$git_remote" != *x-oauth-basic* ]] && [[ "$git_remote" != *${BPKG_OAUTH_TOKEN}* ]]; then
|
export BPKG_CURL_AUTH_PARAM=""
|
||||||
|
export BPKG_GIT_REMOTE=$git_remote
|
||||||
|
export BPKG_AUTH_GIT_REMOTE=$git_remote
|
||||||
|
if [ "${remote:0:10}" == "raw-oauth|" ]; then
|
||||||
|
OLDIFS="${IFS}"
|
||||||
|
IFS="|"
|
||||||
|
# shellcheck disable=SC2206
|
||||||
|
local remote_parts=($remote)
|
||||||
|
IFS="${OLDIFS}"
|
||||||
|
export BPKG_OAUTH_TOKEN=${remote_parts[1]}
|
||||||
# shellcheck disable=SC2034
|
# shellcheck disable=SC2034
|
||||||
export BPKG_AUTH_GIT_REMOTE=${git_remote/https:\/\//https:\/\/$BPKG_OAUTH_TOKEN:x-oauth-basic@}
|
export BPKG_CURL_AUTH_PARAM="-u $BPKG_OAUTH_TOKEN:x-oauth-basic"
|
||||||
|
export BPKG_REMOTE=${remote_parts[2]}
|
||||||
|
if [[ "$git_remote" == https://* ]] && [[ "$git_remote" != *x-oauth-basic* ]] && [[ "$git_remote" != *${BPKG_OAUTH_TOKEN}* ]]; then
|
||||||
|
# shellcheck disable=SC2034
|
||||||
|
export BPKG_AUTH_GIT_REMOTE=${git_remote/https:\/\//https:\/\/$BPKG_OAUTH_TOKEN:x-oauth-basic@}
|
||||||
|
fi
|
||||||
|
else
|
||||||
|
export BPKG_REMOTE="$remote"
|
||||||
fi
|
fi
|
||||||
else
|
}
|
||||||
export BPKG_REMOTE="$remote"
|
|
||||||
fi
|
## given a user and name, sets BPKG_REMOTE_RAW_PATH using the available
|
||||||
}
|
## BPKG_REMOTE and BPKG_OAUTH_TOKEN details
|
||||||
|
bpkg_select_raw_path () {
|
||||||
## given a user and name, sets BPKG_REMOTE_RAW_PATH using the available
|
local user=$1
|
||||||
## BPKG_REMOTE and BPKG_OAUTH_TOKEN details
|
local name=$2
|
||||||
bpkg_select_raw_path() {
|
if [ "$BPKG_OAUTH_TOKEN" == "" ]; then
|
||||||
local user=$1
|
export BPKG_REMOTE_RAW_PATH="$BPKG_REMOTE/$user/$name"
|
||||||
local name=$2
|
else
|
||||||
if [ "$BPKG_OAUTH_TOKEN" == "" ]; then
|
# shellcheck disable=SC2034
|
||||||
export BPKG_REMOTE_RAW_PATH="$BPKG_REMOTE/$user/$name"
|
Export BPKG_REMOTE_RAW_PATH="$BPKG_REMOTE/$user/$name/raw"
|
||||||
else
|
fi
|
||||||
# shellcheck disable=SC2034
|
return 0
|
||||||
Export BPKG_REMOTE_RAW_PATH="$BPKG_REMOTE/$user/$name/raw"
|
}
|
||||||
fi
|
|
||||||
return 0
|
|
||||||
}
|
|
||||||
|
|
||||||
export -f bpkg_initrc
|
bpkg_exec_or_exit bpkg-env
|
||||||
export -f bpkg_validate
|
|
||||||
|
# shellcheck disable=SC2230
|
||||||
|
# shellcheck source=lib/env/env.sh
|
||||||
|
source "$(which bpkg-env)"
|
||||||
|
|
||||||
export -f bpkg_message
|
|
||||||
export -f bpkg_warn
|
|
||||||
export -f bpkg_error
|
|
||||||
export -f bpkg_info
|
|
||||||
|
|
||||||
export -f bpkg_select_remote
|
export -f bpkg_initrc
|
||||||
export -f bpkg_select_raw_path
|
export -f bpkg_validate
|
||||||
|
|
||||||
|
export -f bpkg_message
|
||||||
|
export -f bpkg_warn
|
||||||
|
export -f bpkg_error
|
||||||
|
export -f bpkg_info
|
||||||
|
|
||||||
|
export -f bpkg_exec_exist
|
||||||
|
export -f bpkg_exec_or_exit
|
||||||
|
|
||||||
|
export -f bpkg_select_remote
|
||||||
|
export -f bpkg_select_raw_path
|
||||||
|
fi
|
||||||
|
Loading…
Reference in New Issue