mirror of
https://github.com/pyenv/pyenv.git
synced 2024-11-14 20:39:55 -05:00
d38d18ec25
Sometimes the command fails with a 'type: write error: Broken pipe'. This is because 'head -1' only reads the first line, then exits. If 'type' writes the second line after 'head -1' has already exited, then the aforementioned error is triggered. We fix this by buffering the entire output of 'type' before invoking 'head -1'.
175 lines
3.4 KiB
Bash
Executable file
175 lines
3.4 KiB
Bash
Executable file
#!/usr/bin/env bash
|
|
#
|
|
# Summary: Display help for a command
|
|
#
|
|
# Usage: rbenv help [--usage] COMMAND
|
|
#
|
|
# Parses and displays help contents from a command's source file.
|
|
#
|
|
# A command is considered documented if it starts with a comment block
|
|
# that has a `Summary:' or `Usage:' section. Usage instructions can
|
|
# span multiple lines as long as subsequent lines are indented.
|
|
# The remainder of the comment block is displayed as extended
|
|
# documentation.
|
|
|
|
set -e
|
|
[ -n "$RBENV_DEBUG" ] && set -x
|
|
|
|
# Provide rbenv completions
|
|
if [ "$1" = "--complete" ]; then
|
|
echo --usage
|
|
exec rbenv-commands
|
|
fi
|
|
|
|
command_path() {
|
|
local command="$1"
|
|
command -v rbenv-"$command" || command -v rbenv-sh-"$command" || true
|
|
}
|
|
|
|
extract_initial_comment_block() {
|
|
sed -ne "
|
|
/^#/ !{
|
|
q
|
|
}
|
|
|
|
s/^#$/# /
|
|
|
|
/^# / {
|
|
s/^# //
|
|
p
|
|
}
|
|
"
|
|
}
|
|
|
|
collect_documentation() {
|
|
local all_awks
|
|
local first_awk
|
|
all_awks=$(type -p gawk awk)
|
|
first_awk=$(head -1 <<<"$all_awks")
|
|
|
|
# shellcheck disable=SC2016
|
|
"$first_awk" '
|
|
/^Summary:/ {
|
|
summary = substr($0, 10)
|
|
next
|
|
}
|
|
|
|
/^Usage:/ {
|
|
reading_usage = 1
|
|
usage = usage "\n" $0
|
|
next
|
|
}
|
|
|
|
/^( *$| )/ && reading_usage {
|
|
usage = usage "\n" $0
|
|
next
|
|
}
|
|
|
|
{
|
|
reading_usage = 0
|
|
help = help "\n" $0
|
|
}
|
|
|
|
function escape(str) {
|
|
gsub(/[`\\$"]/, "\\\\&", str)
|
|
return str
|
|
}
|
|
|
|
function trim(str) {
|
|
sub(/^\n*/, "", str)
|
|
sub(/\n*$/, "", str)
|
|
return str
|
|
}
|
|
|
|
END {
|
|
if (usage || summary) {
|
|
print "summary=\"" escape(summary) "\""
|
|
print "usage=\"" escape(trim(usage)) "\""
|
|
print "help=\"" escape(trim(help)) "\""
|
|
}
|
|
}
|
|
'
|
|
}
|
|
|
|
documentation_for() {
|
|
local filename
|
|
filename="$(command_path "$1")"
|
|
if [ -n "$filename" ]; then
|
|
extract_initial_comment_block < "$filename" | collect_documentation
|
|
fi
|
|
}
|
|
|
|
print_summary() {
|
|
local command="$1"
|
|
local summary usage help
|
|
eval "$(documentation_for "$command")"
|
|
|
|
if [ -n "$summary" ]; then
|
|
printf " %-9s %s\n" "$command" "$summary"
|
|
fi
|
|
}
|
|
|
|
print_summaries() {
|
|
for command; do
|
|
print_summary "$command"
|
|
done
|
|
}
|
|
|
|
print_help() {
|
|
local command="$1"
|
|
local summary usage help
|
|
eval "$(documentation_for "$command")"
|
|
[ -n "$help" ] || help="$summary"
|
|
|
|
if [ -n "$usage" ] || [ -n "$summary" ]; then
|
|
if [ -n "$usage" ]; then
|
|
echo "$usage"
|
|
else
|
|
echo "Usage: rbenv ${command}"
|
|
fi
|
|
if [ -n "$help" ]; then
|
|
echo
|
|
echo "$help"
|
|
echo
|
|
fi
|
|
else
|
|
echo "Sorry, this command isn't documented yet." >&2
|
|
return 1
|
|
fi
|
|
}
|
|
|
|
print_usage() {
|
|
local command="$1"
|
|
local summary usage help
|
|
eval "$(documentation_for "$command")"
|
|
[ -z "$usage" ] || echo "$usage"
|
|
}
|
|
|
|
unset usage
|
|
if [ "$1" = "--usage" ]; then
|
|
usage="1"
|
|
shift
|
|
fi
|
|
|
|
if [ -z "$1" ] || [ "$1" == "rbenv" ]; then
|
|
echo "Usage: rbenv <command> [<args>]"
|
|
[ -z "$usage" ] || exit
|
|
echo
|
|
echo "Some useful rbenv commands are:"
|
|
print_summaries commands local global shell install uninstall rehash version versions which whence
|
|
echo
|
|
echo "See \`rbenv help <command>' for information on a specific command."
|
|
echo "For full documentation, see: https://github.com/rbenv/rbenv#readme"
|
|
else
|
|
command="$1"
|
|
if [ -n "$(command_path "$command")" ]; then
|
|
if [ -n "$usage" ]; then
|
|
print_usage "$command"
|
|
else
|
|
print_help "$command"
|
|
fi
|
|
else
|
|
echo "rbenv: no such command \`$command'" >&2
|
|
exit 1
|
|
fi
|
|
fi
|