Initial

examle.config

@@ -0,0 +1,76 @@
+[alias]
+  ### Basic usage
+
+  # This is the alias description
+  # Descriptions can be multiline
+  # use: example "these" "are the parameters"
+  # see: this-is-the-alias-explanatory-url
+  # !# this an ignored comment line
+  ;    this line is not ignored (but could be in 'isComment()')
+  # !: here are linting options
+  # !# lint options are comma separated: show cmd, inline, pretty
+  example = !echo "this is the alias command"
+
+
+  ### git-alias, directives
+
+  # use: usage param1 param2
+  # !# or 'usage:'
+  usage = !echo "show expected alias parameters in red"
+  # https://example.com
+  # !# or prefix with: 'see:', 'link:', 'url:', 'web:'
+  link = !echo "print url with light gray color"
+
+
+  ### git-alias, lint options
+
+  # !: ignore
+  # this description is also ignored
+  ignored = !echo "this alias is completly ignored unless --all"
+
+  # !: hide, hide cmd, not cmd, no cmd, hide command, not command, no command
+  # this description is still printed
+  hide_cmd = !echo "hide command unless --all"
+
+  # !: show cmd, show command
+  show_cmd = !echo "always show command even if not inline"
+
+  # !: inline, singleline, single line
+  single_line = !echo "forces command inline regardless of how long the line is"
+
+  # !: newline, new line, multiline, multi line, not inline, no inline, not single line, not singleline, no single line, no singleline
+  multi_line = !echo "force line break before cmd"
+
+  # !: pretty, prettify
+  prettify = "!f() { echo \"force pretty print command\"; }; f"
+
+
+  ## Simple aliases
+
+  fpull = pull --rebase
+  fpush = push --force --all
+  fpushtags = push --force --tags
+  # Replace an existing tag with new commit
+  # use: ftag v1.0 c9a...d87
+  ftag = tag -a -f
+
+
+  ### Advanced ###
+
+  # List all contributers with email
+  authors = !"echo; git log --format='%aN <%aE>' | sort -u; echo;"
+  # Replace email information
+  # see: https://help.github.com/articles/changing-author-info/
+  # use: new-email "old email" "new name" "new email"
+  new-email = !"f() { git filter-branch -f --env-filter ' \
+      if [ \"$GIT_COMMITTER_EMAIL\" = \"'\"$1\"'\" ]; then \
+        export GIT_COMMITTER_NAME=\"'\"$2\"'\"; \
+        export GIT_COMMITTER_EMAIL=\"'\"$3\"'\"; \
+      fi;\
+      if [ \"$GIT_AUTHOR_EMAIL\" = \"'\"$1\"'\" ]; then \
+        export GIT_AUTHOR_NAME=\"'\"$2\"'\"; \
+        export GIT_AUTHOR_EMAIL=\"'\"$3\"'\"; \
+      fi' --tag-name-filter cat -- --branches --tags; }; f"
+  # Show this message (help: -h)
+  # !: ignore, inline
+  alias = !python3 /usr/local/bin/git-alias.py