view tests/test-help @ 11989:f853873fc66d

aliases: provide more flexible ways to work with shell alias arguments

This patch changes the functionality of shell aliases to add more powerful
options for working with shell alias arguments.

First: the alias name + arguments to a shell alias are set as an HG_ARGS
environment variable, delimited by spaces. This matches the behavior of hooks.

Second: any occurrences of "$@" (without quotes) are replaced with the
arguments, separated by spaces. This happens *before* the alias gets to the shell.

Third: any positive numeric variables ("$1", "$2", etc) are replaced with the
appropriate argument, indexed from 1. "$0" is replaced with the name of the
alias. Any "extra" numeric variables are replaced with an empty string.  This
happens *before* the alias gets to the shell.

These changes allow for more flexible shell aliases:

    [alias]
    echo = !echo $@
    count = !hg log -r "$@" --template='.' | wc -c | sed -e 's/ //g'
    qqueuemv = !mv "`hg root`/.hg/patches-$1" "`hg root`/.hg/patches-$2"

In action:

    $ hg echo foo
    foo

    $ hg count 'branch(default)'
    901

    $ hg count 'branch(stable) and keyword(fixes)'
    102

    $ hg qqueuemv myfeature somefeature

#!/bin/sh

hg
hg -q
hg help
hg -q help

echo %% test short command list with verbose option
hg -v help shortlist | sed 's/[(]version [^)]*[)]/(version xxx)/'

hg add -h

echo %% verbose help for add
hg add -hv

echo %% test help option with version option
hg add -h --version | sed 's/[(]version [^)]*[)]/(version xxx)/'

hg add --skjdfks

echo %% test ambiguous command help
hg help ad

echo %% test command without options
hg help verify

hg help diff
hg help status
hg -q help status
hg help foo
hg skjdfks

cat > helpext.py <<EOF
import os
from mercurial import commands

def nohelp(ui, *args, **kwargs):
    pass

cmdtable = {
    "nohelp": (nohelp, [], "hg nohelp"),
}

commands.norepo += ' nohelp'
EOF
abspath=`pwd`/helpext.py

echo '[extensions]' >> $HGRCPATH
echo "helpext = $abspath" >> $HGRCPATH

echo %% test command with no help text
hg help nohelp

echo %% test that default list of commands omits extension commands
hg help

echo %% test list of commands with command with no help text
hg help helpext

echo %% test a help topic
hg help revs

exit 0