test(git-alias): add its unit test

bin/git-alias

@@ -1,16 +1,27 @@
 #!/usr/bin/env bash
 
+options=""
+
 usage() {
 cat <<HERE
-usage: git alias # list all aliases
- or: git alias <search-pattern> # show aliases matching pattern
- or: git alias <alias-name> <command> # alias a command
+usage: git alias [options] # list all aliases
+ or: git alias [options] <search-pattern> # show aliases matching pattern
+ or: git alias [options] <alias-name> <command> # alias a command
+options:
+
+ --global Show aliased matched in the system config
+ --local Show aliased matched in the repository config
 HERE
 }
 
+if [[ "$1" == "--local" || "$1" == "--global" ]]; then
+ options="$1"
+ shift
+fi
+
 case $# in
- 0) git config --get-regexp 'alias.*' | sed 's/^alias\.//' | sed 's/[ ]/ = /' | sort ;;
- 1) git alias | grep -e "$1" ;;
- 2) git config --global alias."$1" "$2" ;;
+ 0) git config $options --get-regexp 'alias.*' | sed 's/^alias\.//' | sed 's/[ ]/ = /' | sort ;;
+ 1) git config $options --get-regexp 'alias.*' | sed 's/^alias\.//' | sed 's/[ ]/ = /' | sort | grep -e "$1" ;;
+ 2) git config $options alias."$1" "$2" ;;
  *) >&2 echo "error: too many arguments." && usage && exit 1 ;;
 esac

man/git-alias.1

@@ -1,17 +1,21 @@
 .\" generated with Ronn-NG/v0.9.1
 .\" http://github.com/apjanke/ronn-ng/tree/0.9.1
-.TH "GIT\-ALIAS" "1" "August 2021" "" "Git Extras"
+.TH "GIT\-ALIAS" "1" "September 2023" "" "Git Extras"
 .SH "NAME"
 \fBgit\-alias\fR \- Define, search and show aliases
 .SH "SYNOPSIS"
-\fBgit\-alias\fR
-.br
-\fBgit\-alias\fR <search\-pattern>
-.br
-\fBgit\-alias\fR <alias\-name> <command>
+\fBgit\-alias\fR \fBgit\-alias\fR <search\-pattern> \fBgit\-alias\fR <alias\-name> <command> \fBgit\-alias\fR [\-\-global] \fBgit\-alias\fR [\-\-local] \fBgit\-alias\fR [\-\-global] <search\-pattern> \fBgit\-alias\fR [\-\-local] <search\-pattern> \fBgit\-alias\fR [\-\-global] <alias\-name> <command> \fBgit\-alias\fR [\-\-local] <alias\-name> <command>
 .SH "DESCRIPTION"
-List all aliases, show one alias, or set one (global) alias\.
+List all aliases, show one alias, or set one (global or local) alias\.
 .SH "OPTIONS"
+\-\-global
+.P
+Show or create alias in the system config
+.P
+\-\-local
+.P
+Show or create alias in the repository config
+.P
 <search\-pattern>
 .P
 The pattern used to search aliases\.

man/git-alias.md

@@ -3,16 +3,30 @@ git-alias(1) -- Define, search and show aliases
 
 ## SYNOPSIS
 
-`git-alias` 
-`git-alias` <search-pattern> 
-`git-alias` <alias-name> <command> 
+`git-alias`
+`git-alias` <search-pattern>
+`git-alias` <alias-name> <command>
+`git-alias` [--global]
+`git-alias` [--local]
+`git-alias` [--global] <search-pattern>
+`git-alias` [--local] <search-pattern>
+`git-alias` [--global] <alias-name> <command>
+`git-alias` [--local] <alias-name> <command>
 
 ## DESCRIPTION
 
- List all aliases, show one alias, or set one (global) alias.
+ List all aliases, show one alias, or set one (global or local) alias.
 
 ## OPTIONS
 
+ --global
+
+ Show or create alias in the system config
+
+ --local
+
+ Show or create alias in the repository config
+
  <search-pattern>
 
  The pattern used to search aliases.

tests/helper.py

@@ -4,10 +4,12 @@
 import tempfile
 import git
 
-def invoke_git_extras_command(name):
+def invoke_git_extras_command(name, *params):
  current_dir = os.path.dirname(os.path.abspath(__file__))
  git_extras_bin = os.path.join(current_dir, "..", "bin")
- return subprocess.run(os.path.join(git_extras_bin, name), capture_output=True)
+ script = [os.path.join(git_extras_bin, name), *params]
+ print(f"Run the script \"{script}\"")
+ return subprocess.run(script, capture_output=True)
 
 class TempRepository:
  def __init__(self, repo_work_dir = None):
@@ -60,7 +62,7 @@ def teardown(self):
  shutil.rmtree(self._cwd, ignore_errors=True)
  print(f"The temp directory {self._cwd} has been removed")
 
- def invoke_extras_command(self, name):
+ def invoke_extras_command(self, name, *params):
  command = "git-" + name
  print(f"Invoke the git-extras command - {command}")
- return invoke_git_extras_command(command)
+ return invoke_git_extras_command(command, *params)

tests/test_git_alias.py

@@ -0,0 +1,70 @@
+class TestGitAlias:
+ def test_init(self, temp_repo):
+ git = temp_repo.get_repo_git()
+ git.config("--global", "alias.globalalias", "status")
+ git.config("--global", "alias.x", "status")
+ git.config("--local", "alias.localalias", "status")
+ git.config("--local", "alias.y", "status")
+
+ def test_list_all(self, temp_repo):
+ actual = temp_repo.invoke_extras_command("alias")
+ actual = actual.stdout.decode()
+ assert "globalalias = status" in actual
+ assert "x = status" in actual
+ assert "localalias = status" in actual
+ assert "y = status" in actual
+
+ def test_list_all_globally(self, temp_repo):
+ actual = temp_repo.invoke_extras_command("alias", "--global")
+ actual = actual.stdout.decode()
+ assert "globalalias = status" in actual
+
+ def test_list_all_locally(self, temp_repo):
+ actual = temp_repo.invoke_extras_command("alias", "--local")
+ actual = actual.stdout.decode()
+ assert "localalias = status" in actual
+
+ def test_search_globally(self, temp_repo):
+ actual = temp_repo.invoke_extras_command("alias", "--global", "global")
+ actual = actual.stdout.decode()
+ assert "globalalias = status" in actual
+ actual = temp_repo.invoke_extras_command("alias", "--global", "local")
+ actual = actual.stdout.decode()
+ assert "" == actual
+
+ def test_search_locally(self, temp_repo):
+ actual = temp_repo.invoke_extras_command("alias", "--local", "local")
+ actual = actual.stdout.decode()
+ assert "localalias = status" in actual
+ actual = temp_repo.invoke_extras_command("alias", "--local", "global")
+ actual = actual.stdout.decode()
+ assert "" == actual
+
+ def test_get_alias_globally_and_defaultly(self, temp_repo):
+ actual = temp_repo.invoke_extras_command("alias", "globalalias")
+ actual = actual.stdout.decode()
+ assert "globalalias = status" in actual
+
+ def test_set_alias_globally_and_defaultly(self, temp_repo):
+ temp_repo.invoke_extras_command("alias", "globalalias", "diff")
+ actual = temp_repo.invoke_extras_command("alias")
+ actual = actual.stdout.decode()
+ assert "globalalias = diff" in actual
+
+ def test_get_alias_locally(self, temp_repo):
+ actual = temp_repo.invoke_extras_command("alias", "--local", "localalias")
+ actual = actual.stdout.decode()
+ assert "localalias = status" in actual
+
+ def test_set_alias_locally(self, temp_repo):
+ temp_repo.invoke_extras_command("alias", "--local", "localalias", "diff")
+ actual = temp_repo.invoke_extras_command("alias")
+ actual = actual.stdout.decode()
+ assert "localalias = diff" in actual
+
+ def test_teardown(self, temp_repo):
+ git = temp_repo.get_repo_git()
+ git.config("--global", "--unset", "alias.globalalias")
+ git.config("--global", "--unset", "alias.x")
+ git.config("--local", "--unset", "alias.localalias")
+ git.config("--local", "--unset", "alias.y")