468 lines
13 KiB
Bash
468 lines
13 KiB
Bash
BASH_IT_LOAD_PRIORITY_DEFAULT_ALIAS=${BASH_IT_LOAD_PRIORITY_DEFAULT_ALIAS:-150}
|
|
BASH_IT_LOAD_PRIORITY_DEFAULT_PLUGIN=${BASH_IT_LOAD_PRIORITY_DEFAULT_PLUGIN:-250}
|
|
BASH_IT_LOAD_PRIORITY_DEFAULT_COMPLETION=${BASH_IT_LOAD_PRIORITY_DEFAULT_COMPLETION:-350}
|
|
BASH_IT_LOAD_PRIORITY_SEPARATOR="---"
|
|
|
|
# Helper function loading various enable-able files
|
|
function _load_bash_it_files() {
|
|
subdirectory="$1"
|
|
if [ -d "${BASH_IT}/${subdirectory}/enabled" ]
|
|
then
|
|
FILES="${BASH_IT}/${subdirectory}/enabled/*.bash"
|
|
for config_file in $FILES
|
|
do
|
|
if [ -e "${config_file}" ]; then
|
|
source $config_file
|
|
fi
|
|
done
|
|
fi
|
|
}
|
|
|
|
# Function for reloading aliases
|
|
function reload_aliases() {
|
|
_load_bash_it_files "aliases"
|
|
}
|
|
|
|
# Function for reloading auto-completion
|
|
function reload_completion() {
|
|
_load_bash_it_files "completion"
|
|
}
|
|
|
|
# Function for reloading plugins
|
|
function reload_plugins() {
|
|
_load_bash_it_files "plugins"
|
|
}
|
|
|
|
bash-it ()
|
|
{
|
|
about 'Bash-it help and maintenance'
|
|
param '1: verb [one of: help | show | enable | disable | update | search ] '
|
|
param '2: component type [one of: alias(es) | completion(s) | plugin(s) ] or search term(s)'
|
|
param '3: specific component [optional]'
|
|
example '$ bash-it show plugins'
|
|
example '$ bash-it help aliases'
|
|
example '$ bash-it enable plugin git [tmux]...'
|
|
example '$ bash-it disable alias hg [tmux]...'
|
|
example '$ bash-it update'
|
|
example '$ bash-it search ruby [[-]rake]... [--enable | --disable]'
|
|
typeset verb=${1:-}
|
|
shift
|
|
typeset component=${1:-}
|
|
shift
|
|
typeset func
|
|
case $verb in
|
|
show)
|
|
func=_bash-it-$component;;
|
|
enable)
|
|
func=_enable-$component;;
|
|
disable)
|
|
func=_disable-$component;;
|
|
help)
|
|
func=_help-$component;;
|
|
search)
|
|
_bash-it-search $component $*
|
|
return;;
|
|
update)
|
|
func=_bash-it_update;;
|
|
*)
|
|
reference bash-it
|
|
return;;
|
|
esac
|
|
|
|
# pluralize component if necessary
|
|
if ! _is_function $func; then
|
|
if _is_function ${func}s; then
|
|
func=${func}s
|
|
else
|
|
if _is_function ${func}es; then
|
|
func=${func}es
|
|
else
|
|
echo "oops! $component is not a valid option!"
|
|
reference bash-it
|
|
return
|
|
fi
|
|
fi
|
|
fi
|
|
|
|
if [ x"$verb" == x"enable" -o x"$verb" == x"disable" ];then
|
|
for arg in "$@"
|
|
do
|
|
$func $arg
|
|
done
|
|
else
|
|
$func $*
|
|
fi
|
|
}
|
|
|
|
_is_function ()
|
|
{
|
|
_about 'sets $? to true if parameter is the name of a function'
|
|
_param '1: name of alleged function'
|
|
_group 'lib'
|
|
[ -n "$(LANG=C type -t $1 2>/dev/null | grep 'function')" ]
|
|
}
|
|
|
|
_bash-it-aliases ()
|
|
{
|
|
_about 'summarizes available bash_it aliases'
|
|
_group 'lib'
|
|
|
|
_bash-it-describe "aliases" "an" "alias" "Alias"
|
|
}
|
|
|
|
_bash-it-completions ()
|
|
{
|
|
_about 'summarizes available bash_it completions'
|
|
_group 'lib'
|
|
|
|
_bash-it-describe "completion" "a" "completion" "Completion"
|
|
}
|
|
|
|
_bash-it-plugins ()
|
|
{
|
|
_about 'summarizes available bash_it plugins'
|
|
_group 'lib'
|
|
|
|
_bash-it-describe "plugins" "a" "plugin" "Plugin"
|
|
}
|
|
|
|
_bash-it_update() {
|
|
_about 'updates Bash-it'
|
|
_group 'lib'
|
|
|
|
cd "${BASH_IT}"
|
|
if [ -z $BASH_IT_REMOTE ]; then
|
|
BASH_IT_REMOTE="origin"
|
|
fi
|
|
git fetch &> /dev/null
|
|
local status="$(git rev-list master..${BASH_IT_REMOTE}/master 2> /dev/null)"
|
|
if [[ -n "${status}" ]]; then
|
|
git pull --rebase &> /dev/null
|
|
if [[ $? -eq 0 ]]; then
|
|
echo "Bash-it successfully updated, enjoy!"
|
|
reload
|
|
else
|
|
echo "Error updating Bash-it, please, check if your Bash-it installation folder (${BASH_IT}) is clean."
|
|
fi
|
|
else
|
|
echo "Bash-it is up to date, nothing to do!"
|
|
fi
|
|
cd - &> /dev/null
|
|
}
|
|
|
|
_bash-it-describe ()
|
|
{
|
|
_about 'summarizes available bash_it components'
|
|
_param '1: subdirectory'
|
|
_param '2: preposition'
|
|
_param '3: file_type'
|
|
_param '4: column_header'
|
|
_example '$ _bash-it-describe "plugins" "a" "plugin" "Plugin"'
|
|
|
|
subdirectory="$1"
|
|
preposition="$2"
|
|
file_type="$3"
|
|
column_header="$4"
|
|
|
|
typeset f
|
|
typeset enabled
|
|
printf "%-20s%-10s%s\n" "$column_header" 'Enabled?' 'Description'
|
|
for f in $BASH_IT/$subdirectory/available/*.bash
|
|
do
|
|
# Check for both the old format without the load priority, and the extended format with the priority
|
|
if [ -e $BASH_IT/$subdirectory/enabled/$(basename $f) ] || [ -e $BASH_IT/$subdirectory/enabled/*$BASH_IT_LOAD_PRIORITY_SEPARATOR$(basename $f) ]; then
|
|
enabled='x'
|
|
else
|
|
enabled=' '
|
|
fi
|
|
printf "%-20s%-10s%s\n" "$(basename $f | cut -d'.' -f1)" " [$enabled]" "$(cat $f | metafor about-$file_type)"
|
|
done
|
|
printf '\n%s\n' "to enable $preposition $file_type, do:"
|
|
printf '%s\n' "$ bash-it enable $file_type <$file_type name> [$file_type name]... -or- $ bash-it enable $file_type all"
|
|
printf '\n%s\n' "to disable $preposition $file_type, do:"
|
|
printf '%s\n' "$ bash-it disable $file_type <$file_type name> [$file_type name]... -or- $ bash-it disable $file_type all"
|
|
}
|
|
|
|
_disable-plugin ()
|
|
{
|
|
_about 'disables bash_it plugin'
|
|
_param '1: plugin name'
|
|
_example '$ disable-plugin rvm'
|
|
_group 'lib'
|
|
|
|
_disable-thing "plugins" "plugin" $1
|
|
}
|
|
|
|
_disable-alias ()
|
|
{
|
|
_about 'disables bash_it alias'
|
|
_param '1: alias name'
|
|
_example '$ disable-alias git'
|
|
_group 'lib'
|
|
|
|
_disable-thing "aliases" "alias" $1
|
|
}
|
|
|
|
_disable-completion ()
|
|
{
|
|
_about 'disables bash_it completion'
|
|
_param '1: completion name'
|
|
_example '$ disable-completion git'
|
|
_group 'lib'
|
|
|
|
_disable-thing "completion" "completion" $1
|
|
}
|
|
|
|
_disable-thing ()
|
|
{
|
|
_about 'disables a bash_it component'
|
|
_param '1: subdirectory'
|
|
_param '2: file_type'
|
|
_param '3: file_entity'
|
|
_example '$ _disable-thing "plugins" "plugin" "ssh"'
|
|
|
|
subdirectory="$1"
|
|
file_type="$2"
|
|
file_entity="$3"
|
|
|
|
if [ -z "$file_entity" ]; then
|
|
reference "disable-$file_type"
|
|
return
|
|
fi
|
|
|
|
if [ "$file_entity" = "all" ]; then
|
|
typeset f $file_type
|
|
for f in $BASH_IT/$subdirectory/available/*.bash
|
|
do
|
|
plugin=$(basename $f)
|
|
if [ -e $BASH_IT/$subdirectory/enabled/$plugin ]; then
|
|
rm $BASH_IT/$subdirectory/enabled/$(basename $plugin)
|
|
fi
|
|
if [ -e $BASH_IT/$subdirectory/enabled/*$BASH_IT_LOAD_PRIORITY_SEPARATOR$plugin ]; then
|
|
rm $BASH_IT/$subdirectory/enabled/*$BASH_IT_LOAD_PRIORITY_SEPARATOR$(basename $plugin)
|
|
fi
|
|
done
|
|
else
|
|
# Use a glob to search for both possible patterns
|
|
# 250---node.plugin.bash
|
|
# node.plugin.bash
|
|
# Either one will be matched by this glob
|
|
typeset plugin=$(command ls $BASH_IT/$subdirectory/enabled/{[0-9]*$BASH_IT_LOAD_PRIORITY_SEPARATOR$file_entity.*bash,$file_entity.*bash} 2>/dev/null | head -1)
|
|
if [ -z "$plugin" ]; then
|
|
printf '%s\n' "sorry, $file_entity does not appear to be an enabled $file_type."
|
|
return
|
|
fi
|
|
rm $BASH_IT/$subdirectory/enabled/$(basename $plugin)
|
|
fi
|
|
|
|
if [ -n "$BASH_IT_AUTOMATIC_RELOAD_AFTER_CONFIG_CHANGE" ]; then
|
|
exec ${0/-/}
|
|
fi
|
|
|
|
printf '%s\n' "$file_entity disabled."
|
|
}
|
|
|
|
_enable-plugin ()
|
|
{
|
|
_about 'enables bash_it plugin'
|
|
_param '1: plugin name'
|
|
_example '$ enable-plugin rvm'
|
|
_group 'lib'
|
|
|
|
_enable-thing "plugins" "plugin" $1 $BASH_IT_LOAD_PRIORITY_DEFAULT_PLUGIN
|
|
}
|
|
|
|
_enable-alias ()
|
|
{
|
|
_about 'enables bash_it alias'
|
|
_param '1: alias name'
|
|
_example '$ enable-alias git'
|
|
_group 'lib'
|
|
|
|
_enable-thing "aliases" "alias" $1 $BASH_IT_LOAD_PRIORITY_DEFAULT_ALIAS
|
|
}
|
|
|
|
_enable-completion ()
|
|
{
|
|
_about 'enables bash_it completion'
|
|
_param '1: completion name'
|
|
_example '$ enable-completion git'
|
|
_group 'lib'
|
|
|
|
_enable-thing "completion" "completion" $1 $BASH_IT_LOAD_PRIORITY_DEFAULT_COMPLETION
|
|
}
|
|
|
|
_enable-thing ()
|
|
{
|
|
cite _about _param _example
|
|
_about 'enables a bash_it component'
|
|
_param '1: subdirectory'
|
|
_param '2: file_type'
|
|
_param '3: file_entity'
|
|
_param '4: load priority'
|
|
_example '$ _enable-thing "plugins" "plugin" "ssh" "150"'
|
|
|
|
subdirectory="$1"
|
|
file_type="$2"
|
|
file_entity="$3"
|
|
load_priority="$4"
|
|
|
|
if [ -z "$file_entity" ]; then
|
|
reference "enable-$file_type"
|
|
return
|
|
fi
|
|
|
|
if [ "$file_entity" = "all" ]; then
|
|
typeset f $file_type
|
|
for f in $BASH_IT/$subdirectory/available/*.bash
|
|
do
|
|
plugin=$(basename $f .$file_type.bash)
|
|
_enable-thing $subdirectory $file_type $plugin $load_priority
|
|
done
|
|
else
|
|
typeset plugin=$(command ls $BASH_IT/$subdirectory/available/$file_entity.*bash 2>/dev/null | head -1)
|
|
if [ -z "$plugin" ]; then
|
|
printf '%s\n' "sorry, $file_entity does not appear to be an available $file_type."
|
|
return
|
|
fi
|
|
|
|
plugin=$(basename $plugin)
|
|
# Check for existence of the file using a wildcard, since we don't know which priority might have been used when enabling it.
|
|
typeset enabled_plugin=$(command ls $BASH_IT/$subdirectory/enabled/{[0-9]*$BASH_IT_LOAD_PRIORITY_SEPARATOR$plugin,$plugin} 2>/dev/null | head -1)
|
|
if [ ! -z "$enabled_plugin" ] ; then
|
|
printf '%s\n' "$file_entity is already enabled."
|
|
return
|
|
fi
|
|
|
|
mkdir -p $BASH_IT/$subdirectory/enabled
|
|
|
|
# Load the priority from the file if it present there
|
|
local local_file_priority=$(grep -E "^# BASH_IT_LOAD_PRIORITY:" $BASH_IT/$subdirectory/available/$plugin | awk -F': ' '{ print $2 }')
|
|
local use_load_priority=${local_file_priority:-$load_priority}
|
|
|
|
ln -s ../available/$plugin $BASH_IT/$subdirectory/enabled/$use_load_priority$BASH_IT_LOAD_PRIORITY_SEPARATOR$plugin
|
|
fi
|
|
|
|
if [ -n "$BASH_IT_AUTOMATIC_RELOAD_AFTER_CONFIG_CHANGE" ]; then
|
|
exec ${0/-/}
|
|
fi
|
|
|
|
printf '%s\n' "$file_entity enabled with priority $use_load_priority."
|
|
}
|
|
|
|
_help-completions()
|
|
{
|
|
_about 'summarize all completions available in bash-it'
|
|
_group 'lib'
|
|
|
|
_bash-it-completions
|
|
}
|
|
|
|
_help-aliases()
|
|
{
|
|
_about 'shows help for all aliases, or a specific alias group'
|
|
_param '1: optional alias group'
|
|
_example '$ alias-help'
|
|
_example '$ alias-help git'
|
|
|
|
if [ -n "$1" ]; then
|
|
case $1 in
|
|
custom)
|
|
alias_path='custom.aliases.bash'
|
|
;;
|
|
*)
|
|
alias_path="available/$1.aliases.bash"
|
|
;;
|
|
esac
|
|
cat $BASH_IT/aliases/$alias_path | metafor alias | sed "s/$/'/"
|
|
else
|
|
typeset f
|
|
for f in $BASH_IT/aliases/enabled/*
|
|
do
|
|
_help-list-aliases $f
|
|
done
|
|
_help-list-aliases $BASH_IT/aliases/custom.aliases.bash
|
|
fi
|
|
}
|
|
|
|
_help-list-aliases ()
|
|
{
|
|
typeset file=$(basename $1)
|
|
printf '\n\n%s:\n' "${file%%.*}"
|
|
# metafor() strips trailing quotes, restore them with sed..
|
|
cat $1 | metafor alias | sed "s/$/'/"
|
|
}
|
|
|
|
_help-plugins()
|
|
{
|
|
_about 'summarize all functions defined by enabled bash-it plugins'
|
|
_group 'lib'
|
|
|
|
# display a brief progress message...
|
|
printf '%s' 'please wait, building help...'
|
|
typeset grouplist=$(mktemp /tmp/grouplist.XXXXXX)
|
|
typeset func
|
|
for func in $(typeset_functions)
|
|
do
|
|
typeset group="$(typeset -f $func | metafor group)"
|
|
if [ -z "$group" ]; then
|
|
group='misc'
|
|
fi
|
|
typeset about="$(typeset -f $func | metafor about)"
|
|
letterpress "$about" $func >> $grouplist.$group
|
|
echo $grouplist.$group >> $grouplist
|
|
done
|
|
# clear progress message
|
|
printf '\r%s\n' ' '
|
|
typeset group
|
|
typeset gfile
|
|
for gfile in $(cat $grouplist | sort | uniq)
|
|
do
|
|
printf '%s\n' "${gfile##*.}:"
|
|
cat $gfile
|
|
printf '\n'
|
|
rm $gfile 2> /dev/null
|
|
done | less
|
|
rm $grouplist 2> /dev/null
|
|
}
|
|
|
|
_help-update () {
|
|
_about 'help message for update command'
|
|
_group 'lib'
|
|
|
|
echo "Check for a new version of Bash-it and update it."
|
|
}
|
|
|
|
all_groups ()
|
|
{
|
|
about 'displays all unique metadata groups'
|
|
group 'lib'
|
|
|
|
typeset func
|
|
typeset file=$(mktemp /tmp/composure.XXXX)
|
|
for func in $(typeset_functions)
|
|
do
|
|
typeset -f $func | metafor group >> $file
|
|
done
|
|
cat $file | sort | uniq
|
|
rm $file
|
|
}
|
|
|
|
if ! type pathmunge > /dev/null 2>&1
|
|
then
|
|
function pathmunge () {
|
|
about 'prevent duplicate directories in you PATH variable'
|
|
group 'helpers'
|
|
example 'pathmunge /path/to/dir is equivalent to PATH=/path/to/dir:$PATH'
|
|
example 'pathmunge /path/to/dir after is equivalent to PATH=$PATH:/path/to/dir'
|
|
|
|
if ! [[ $PATH =~ (^|:)$1($|:) ]] ; then
|
|
if [ "$2" = "after" ] ; then
|
|
export PATH=$PATH:$1
|
|
else
|
|
export PATH=$1:$PATH
|
|
fi
|
|
fi
|
|
}
|
|
fi
|