feat: add reverse option to git-brv

Commands.md

@@ -359,6 +359,13 @@ $ git brv
 2020-01-08 master origin/master 265b03e Merge pull request #816 from spacewander/git-sed-pathspec
 ```
 
+When your repo has many branches, it can be more convenient to see this list in reverse. This can be set as the default by setting the GIT_BRV_REVERSE environment variable to true.
+
+```bash
+$ git brv --reverse
+2020-01-08 master origin/master 265b03e Merge pull request #816 from spacewander/git-sed-pathspec
+2020-01-14 adds-git-brv fork/adds-git-brv 1ca0d76 Fixes #700: Adds git-brv
+```
 
 ## git repl
 

bin/git-brv

@@ -7,6 +7,20 @@ if ! (( BASH_VERSINFO[0] > 4 ||
  exit 1
 fi
 
+# allow the user to set a default reverse option in an environment variable
+reverse=${GIT_BRV_REVERSE:-false}
+while [[ $# -gt 0 ]]; do
+ case $1 in
+ -r | --reverse)
+ reverse=true
+ shift
+ ;;
+ *)
+ break
+ ;;
+ esac
+done
+
 if [[ -t 1 ]]; then
  shopt -s checkwinsize
  COLUMNS=$(tput cols)
@@ -36,9 +50,14 @@ for b in "${!upstream[@]}"; do
 done
 
 mapfile -t ordered < <(
+ # the reverse option of git-brv causes the sort to be sorted normally rather than in reverse
+ reverse_opt=""
+ if [[ $reverse = false ]]; then
+ reverse_opt="-r"
+ fi
  for b in "${!date[@]}"; do
  printf '%d\t%s\n' "${date[$b]}" "$b"
- done | sort -rn | cut -f2-
+ done | sort -n $reverse_opt | cut -f2-
 )
 
 current=$(git symbolic-ref -q --short HEAD)

etc/bash_completion.sh

@@ -26,6 +26,10 @@ _git_authors(){
  __gitcomp "-l --list --no-email"
 }
 
+_git_brv(){
+ __gitcomp "-r --reverse"
+}
+
 _git_coauthor(){
  local oldIfs=$IFS
  IFS=$'\n'

etc/git-extras-completion.zsh

@@ -117,6 +117,11 @@ _git-authors() {
  '--no-email[without email]' \
 }
 
+_git-brv() {
+ _arguments \
+ '(-r --reverse)'{-r,--reverse}'[reverse order]'
+}
+
 _git-changelog() {
  _arguments \
  '(-l --list)'{-l,--list}'[list commits]' \

etc/git-extras.fish

@@ -82,6 +82,8 @@ complete -c git -n __fish_git_needs_command -a "$__fish_git_extras_commands"
 # authors
 complete -c git -f -n '__fish_git_using_command authors' -s l -l list -d 'show authors'
 complete -c git -f -n '__fish_git_using_command authors' -l no-email -d 'without email'
+# brv
+complete -c git -f -n '__fish_git_using_command brv' -s r -l reverse -d 'reverse the sort order'
 # bulk
 complete -c git -n '__fish_git_using_command bulk' -s a -d 'Run a git command on all workspaces and their repositories'
 complete -c git -n '__fish_git_using_command bulk' -s g -d 'Ask the user for confirmation on every execution'

man/git-brv.1

@@ -1,17 +1,23 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "GIT\-BRV" "1" "January 2020" "" "Git Extras"
+.TH "GIT\-BRV" "1" "December 2023" "" "Git Extras"
 .
 .SH "NAME"
 \fBgit\-brv\fR \- List branches sorted by their last commit date
 .
 .SH "SYNOPSIS"
-\fBgit\-brv\fR
+\fBgit\-brv\fR [\-r|\-\-reverse]
 .
 .SH "DESCRIPTION"
 Pretty listing of branches sorted by the date of their last commit\.
 .
+.SH "OPTIONS"
+\-r | \-\-reverse
+.
+.P
+Reverses the output to put the most recent branch at the bottom of the list\. This is useful when there are large amount of branches as the most recent branch is shown just above the next prompt\. This can be configured as the default by setting the GIT_BRV_REVERSE environment variable to true\.
+.
 .SH "EXAMPLES"
 Simply run \fBgit brv\fR
 .
@@ -27,6 +33,21 @@ $ git brv
 .
 .IP "" 0
 .
+.P
+\fBgit brv \-\-reverse\fR
+.
+.IP "" 4
+.
+.nf
+
+$ git brv
+2020\-01\-08 master origin/master 265b03e Merge pull request #816 from spacewander/git\-sed\-pathspec
+2020\-01\-14 adds\-git\-brv fork/adds\-git\-brv 1ca0d76 Fixes #700: Adds git\-brv
+.
+.fi
+.
+.IP "" 0
+.
 .SH "AUTHOR"
 Written by Øsse <\fIhttps://github\.com/Osse\fR>
 .

man/git-brv.md

@@ -3,12 +3,18 @@ git-brv(1) -- List branches sorted by their last commit date
 
 ## SYNOPSIS
 
-`git-brv`
+`git-brv` [-r|--reverse]
 
 ## DESCRIPTION
 
  Pretty listing of branches sorted by the date of their last commit.
 
+## OPTIONS
+
+ -r | --reverse
+
+ Reverses the output to put the most recent branch at the bottom of the list. This is useful when there are large amount of branches as the most recent branch is shown just above the next prompt. This can be configured as the default by setting the GIT_BRV_REVERSE environment variable to true.
+
 ## EXAMPLES
 
  Simply run `git brv`
@@ -17,6 +23,11 @@ git-brv(1) -- List branches sorted by their last commit date
  2020-01-14 adds-git-brv fork/adds-git-brv 1ca0d76 Fixes #700: Adds git-brv
  2020-01-08 master origin/master 265b03e Merge pull request #816 from spacewander/git-sed-pathspec
 
+ `git brv --reverse`
+
+ $ git brv
+ 2020-01-08 master origin/master 265b03e Merge pull request #816 from spacewander/git-sed-pathspec
+ 2020-01-14 adds-git-brv fork/adds-git-brv 1ca0d76 Fixes #700: Adds git-brv
 
 ## AUTHOR
 

man/git-extras.md

@@ -51,7 +51,7 @@ git-extras(1) -- Awesome GIT utilities
  - **git-delete-tag(1)** Delete tags
  - **git-delta(1)** Lists changed files
  - **git-effort(1)** Show effort statistics on file(s)
- - **git-feature(1)** Create/Merge feature branch
+ - **# git-feature(1)** Create/Merge feature branch
  - **git-force-clone(1)** overwrite local repositories with clone
  - **git-fork(1)** Fork a repo on github
  - **git-fresh-branch(1)** Create fresh branches