Support passing ref to git-commits-since (#1228)

2026-09-10 07:26:17 -04:00 · 2026-02-03 06:39:48 +01:00 · 2026-02-03 06:39:48 +01:00 · 5367101f2e
parent 6ed2643252
commit 5367101f2e
7 changed files with 133 additions and 76 deletions
--- a/bin/git-commits-since
+++ b/bin/git-commits-since
@ -1,6 +1,36 @@
 #!/usr/bin/env bash

-SINCE="last week"
-test $# -ne 0 && SINCE=$*
-echo "... commits since $SINCE" >&2
-git log --pretty='%an - %s' --after="@{$SINCE}"
+REF=""
+SINCE=""
+
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        -r|--ref)
+            if [[ -z "$2" ]]; then
+                echo "error: option $1 requires an argument" >&2
+                exit 1
+            fi
+            REF="$2"
+            shift
+            shift
+            ;;
+        *)
+            # non-flag args accumulation, e.g. "last " + "week" -> "last week"
+            SINCE="${SINCE:+$SINCE }$1"
+            shift
+            ;;
+    esac
+done
+
+if [[ -n "$REF" && -n "$SINCE" ]]; then
+    echo "error: '--ref <ref>' and '<date>' are mutually exclusive" >&2
+    exit 1
+fi
+
+SINCE="${SINCE:-last week}"
+
+if [[ -n "$REF" ]]; then
+    git log --pretty='%h %an - %s' "$REF..HEAD"
+else
+    git log --pretty='%h %an - %s' --after="@{$SINCE}"
+fi
--- a/etc/bash_completion.sh
+++ b/etc/bash_completion.sh
@ -82,6 +82,10 @@ _git_contrib(){
  COMPREPLY=($(compgen -W "$all" -- "$cur"))
 }

+_git_commits_since(){
+  __gitcomp "-r --ref"
+}
+
 _git_count(){
  __gitcomp "--all"
 }
--- a/etc/git-extras-completion.zsh
+++ b/etc/git-extras-completion.zsh
@ -171,6 +171,11 @@ _git-coauthor() {
        ':co-author-email[email address of co-author to add]:__gitex_author_emails'
 }

+_git-commits-since() {
+    _arguments \
+        '(-r --ref)'{-r,--ref}'[show commits since ref]'
+}
+
 _git-contrib() {
    _arguments \
        ':author:__gitex_author_names'
--- a/etc/git-extras.fish
+++ b/etc/git-extras.fish
@ -131,6 +131,8 @@ function __fish_git_extra_coauthor_email
 end
 complete -c git -f -n '__fish_git_using_command coauthor; and __fish_git_arg_number 2' -a '(__fish_git_extra_coauthor_name)'
 complete -c git -f -n '__fish_git_using_command coauthor; and __fish_git_arg_number 3' -a '(__fish_git_extra_coauthor_email)'
+# commits-since
+complete -c git -f -n '__fish_git_using_command commits-since' -s r -l ref -d 'show commits since ref'
 # count
 complete -c git -f -n '__fish_git_using_command count' -l all -d 'detailed commit count'
 # create-branch
--- a/man/git-commits-since.1
+++ b/man/git-commits-since.1
@ -1,57 +1,52 @@
-.\" generated with Ronn/v0.7.3
-.\" http://github.com/rtomayko/ronn/tree/0.7.3
-.
-.TH "GIT\-COMMITS\-SINCE" "1" "October 2017" "" "Git Extras"
-.
+.\" generated with Ronn-NG/v0.9.1
+.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
+.TH "GIT\-COMMITS\-SINCE" "1" "January 2026" "" "Git Extras"
 .SH "NAME"
 \fBgit\-commits\-since\fR \- Show commit logs since some date
-.
 .SH "SYNOPSIS"
-\fBgit\-commits\-since\fR [<date>]
-.
+.TS
+allbox;
+\fBgit\-commits\-since\fR [\-r	\-\-ref <ref>] [<date>]
+.TE
 .SH "DESCRIPTION"
-List of commits since the given \fIdate\fR\.
-.
+List of commits since the given \fIdate\fR or \fIref\fR\.
 .SH "OPTIONS"
 <date>
-.
 .P
-Show commits more recent than \fIdate\fR\. By default, the command shows the commit logs since "last week"\.
-.
+Show commits more recent than <date>\. By default, the command shows the commit logs since "last week"\.
+.P
+\-r, \-\-ref <ref>
+.P
+Show commits since the given ref (tag, branch, or commit)\. When specified, the command uses \fBref\.\.HEAD\fR instead of date\-based filtering\.
 .SH "EXAMPLES"
 It is really flexible and these are only 3 of the options, go ahead give it a try:
-.
 .IP "" 4
-.
 .nf
-
 $ git commits\-since yesterday
-\.\.\. commits since yesterday
-nickl\- \- Merge branch upstream master\.
-nickl\- \- Rebase bolshakov with master
-TJ Holowaychuk \- Merge pull request #128 from nickl\-/git\-extras\-html\-hyperlinks
-TJ Holowaychuk \- Merge pull request #129 from nickl\-/develop
-nickl\- \- Fix #127 git\-ignore won\'t add duplicates\.
+aa084d9 TweeKane \- Add global gitignore to git\-ignore output
+515e94a TJ Holowaychuk \- Merge pull request #128 from nickl\-/git\-extras\-html\-hyperlinks
+5f86b54 TJ Holowaychuk \- Merge pull request #129 from nickl\-/develop
+7398d10 nickl\- \- Fix #127 git\-ignore won\'t add duplicates\.

 $ git commits\-since 3 o clock pm
-\.\.\. commits since 3 o clock pm
-nickl\- \- Merge branch upstream master\.
+aa084d9 TweeKane \- Add global gitignore to git\-ignore output

 $ git commits\-since 2 hour ago
-\.\.\. commits since 2 hour ago
-nickl\- \- Merge branch upstream master\.
-TJ Holowaychuk \- Merge pull request #128 from nickl\-/git\-extras\-html\-hyperlinks
-TJ Holowaychuk \- Merge pull request #129 from nickl\-/develop
-.
+aa084d9 TweeKane \- Add global gitignore to git\-ignore output
+515e94a TJ Holowaychuk \- Merge pull request #128 from nickl\-/git\-extras\-html\-hyperlinks
+5f86b54 TJ Holowaychuk \- Merge pull request #129 from nickl\-/develop
+
+$ git commits\-since \-\-ref 7\.4\.0
+6ed2643 John Bachir \- ability to specify command when hitting enter (#1223)
+b9bd309 John Bachir \- Improve `git\-repl` prompt (#1224)
+6f4cf0c johnpyp \- feat: `delete\-branch` multiple unique branch names completions (#1221)
+\|\.\|\.\|\.
+215382b 罗泽轩 \- Bump version to 7\.5\.0\-dev (#1207)
 .fi
-.
 .IP "" 0
-.
 .SH "AUTHOR"
 Written by Tj Holowaychuk <\fItj@vision\-media\.ca\fR>
-.
 .SH "REPORTING BUGS"
 <\fIhttps://github\.com/tj/git\-extras/issues\fR>
-.
 .SH "SEE ALSO"
 <\fIhttps://github\.com/tj/git\-extras\fR>
--- a/man/git-commits-since.html
+++ b/man/git-commits-since.html
@ -1,8 +1,8 @@
 <!DOCTYPE html>
 <html>
 <head>
-  <meta http-equiv='content-type' value='text/html;charset=utf8'>
-  <meta name='generator' value='Ronn/v0.7.3 (http://github.com/rtomayko/ronn/tree/0.7.3)'>
+  <meta http-equiv='content-type' content='text/html;charset=utf8'>
+  <meta name='generator' content='Ronn-NG/v0.9.1 (http://github.com/apjanke/ronn-ng/tree/0.9.1)'>
  <title>git-commits-since(1) - Show commit logs since some date</title>
  <style type='text/css' media='all'>
  /* style: man */
@ -69,51 +69,67 @@
    <li class='tr'>git-commits-since(1)</li>
  </ol>

-  <h2 id="NAME">NAME</h2>
+  
+
+<h2 id="NAME">NAME</h2>
 <p class="man-name">
  <code>git-commits-since</code> - <span class="man-whatis">Show commit logs since some date</span>
 </p>
-
 <h2 id="SYNOPSIS">SYNOPSIS</h2>

-<p><code>git-commits-since</code> [&lt;date&gt;]</p>
+<table>
+  <tbody>
+    <tr>
+      <td>
+<code>git-commits-since</code> [-r</td>
+      <td>--ref &lt;ref&gt;] [&lt;date&gt;]</td>
+    </tr>
+  </tbody>
+</table>

 <h2 id="DESCRIPTION">DESCRIPTION</h2>

-<p>  List of commits since the given <em>date</em>.</p>
+<p>List of commits since the given <em>date</em> or <em>ref</em>.</p>

 <h2 id="OPTIONS">OPTIONS</h2>

-<p>  &lt;date&gt;</p>
+<p>&lt;date&gt;</p>

-<p>  Show commits more recent than <var>date</var>. By default, the command shows the commit logs since "last week".</p>
+<p>Show commits more recent than &lt;date&gt;. By default, the command shows the commit logs since "last week".</p>
+
+<p>-r, --ref &lt;ref&gt;</p>
+
+<p>Show commits since the given ref (tag, branch, or commit). When specified, the command uses <code>ref..HEAD</code> instead of date-based filtering.</p>

 <h2 id="EXAMPLES">EXAMPLES</h2>

-<p>  It is really flexible and these are only 3 of the options, go ahead give it a try:</p>
+<p>It is really flexible and these are only 3 of the options, go ahead give it a try:</p>

 <pre><code>$ git commits-since yesterday
-... commits since yesterday
-nickl- - Merge branch upstream master.
-nickl- - Rebase bolshakov with master
-TJ Holowaychuk - Merge pull request #128 from nickl-/git-extras-html-hyperlinks
-TJ Holowaychuk - Merge pull request #129 from nickl-/develop
-nickl- - Fix #127 git-ignore won't add duplicates.
+aa084d9 TweeKane - Add global gitignore to git-ignore output
+515e94a TJ Holowaychuk - Merge pull request #128 from nickl-/git-extras-html-hyperlinks
+5f86b54 TJ Holowaychuk - Merge pull request #129 from nickl-/develop
+7398d10 nickl- - Fix #127 git-ignore won't add duplicates.

 $ git commits-since 3 o clock pm
-... commits since 3 o clock pm
-nickl- - Merge branch upstream master.
+aa084d9 TweeKane - Add global gitignore to git-ignore output

 $ git commits-since 2 hour ago
-... commits since 2 hour ago
-nickl- - Merge branch upstream master.
-TJ Holowaychuk - Merge pull request #128 from nickl-/git-extras-html-hyperlinks
-TJ Holowaychuk - Merge pull request #129 from nickl-/develop
+aa084d9 TweeKane - Add global gitignore to git-ignore output
+515e94a TJ Holowaychuk - Merge pull request #128 from nickl-/git-extras-html-hyperlinks
+5f86b54 TJ Holowaychuk - Merge pull request #129 from nickl-/develop
+
+$ git commits-since --ref 7.4.0
+6ed2643 John Bachir - ability to specify command when hitting enter (#1223)
+b9bd309 John Bachir - Improve `git-repl` prompt (#1224)
+6f4cf0c johnpyp - feat: `delete-branch` multiple unique branch names completions (#1221)
+...
+215382b 罗泽轩 - Bump version to 7.5.0-dev (#1207)
 </code></pre>

 <h2 id="AUTHOR">AUTHOR</h2>

-<p>Written by Tj Holowaychuk &lt;<a href="&#x6d;&#x61;&#x69;&#x6c;&#x74;&#x6f;&#x3a;&#116;&#x6a;&#x40;&#x76;&#105;&#x73;&#x69;&#x6f;&#110;&#45;&#109;&#x65;&#x64;&#105;&#x61;&#x2e;&#99;&#97;" data-bare-link="true">&#x74;&#106;&#64;&#x76;&#x69;&#115;&#105;&#111;&#x6e;&#x2d;&#x6d;&#x65;&#x64;&#x69;&#97;&#46;&#x63;&#97;</a>&gt;</p>
+<p>Written by Tj Holowaychuk &lt;<a href="mailto:tj@vision-media.ca" data-bare-link="true">tj@vision-media.ca</a>&gt;</p>

 <h2 id="REPORTING-BUGS">REPORTING BUGS</h2>

@ -123,10 +139,9 @@ TJ Holowaychuk - Merge pull request #129 from nickl-/develop

 <p>&lt;<a href="https://github.com/tj/git-extras" data-bare-link="true">https://github.com/tj/git-extras</a>&gt;</p>

-
  <ol class='man-decor man-foot man foot'>
    <li class='tl'></li>
-    <li class='tc'>October 2017</li>
+    <li class='tc'>January 2026</li>
    <li class='tr'>git-commits-since(1)</li>
  </ol>

--- a/man/git-commits-since.md
+++ b/man/git-commits-since.md
@ -3,40 +3,46 @@ git-commits-since(1) -- Show commit logs since some date

 ## SYNOPSIS

-`git-commits-since` [&lt;date&gt;]
+`git-commits-since` [-r|--ref &lt;ref&gt;] [&lt;date&gt;]

 ## DESCRIPTION

-  List of commits since the given _date_.
+  List of commits since the given _date_ or _ref_.

 ## OPTIONS

  &lt;date&gt;

-  Show commits more recent than <date>. By default, the command shows the commit logs since "last week".
+  Show commits more recent than &lt;date&gt;. By default, the command shows the commit logs since "last week".
+
+  -r, --ref &lt;ref&gt;
+
+  Show commits since the given ref (tag, branch, or commit). When specified, the command uses `ref..HEAD` instead of date-based filtering.

 ## EXAMPLES

  It is really flexible and these are only 3 of the options, go ahead give it a try:

    $ git commits-since yesterday
-    ... commits since yesterday
-    nickl- - Merge branch upstream master.
-    nickl- - Rebase bolshakov with master
-    TJ Holowaychuk - Merge pull request #128 from nickl-/git-extras-html-hyperlinks
-    TJ Holowaychuk - Merge pull request #129 from nickl-/develop
-    nickl- - Fix #127 git-ignore won't add duplicates.
+    aa084d9 TweeKane - Add global gitignore to git-ignore output
+    515e94a TJ Holowaychuk - Merge pull request #128 from nickl-/git-extras-html-hyperlinks
+    5f86b54 TJ Holowaychuk - Merge pull request #129 from nickl-/develop
+    7398d10 nickl- - Fix #127 git-ignore won't add duplicates.

    $ git commits-since 3 o clock pm
-    ... commits since 3 o clock pm
-    nickl- - Merge branch upstream master.
+    aa084d9 TweeKane - Add global gitignore to git-ignore output

    $ git commits-since 2 hour ago
-    ... commits since 2 hour ago
-    nickl- - Merge branch upstream master.
-    TJ Holowaychuk - Merge pull request #128 from nickl-/git-extras-html-hyperlinks
-    TJ Holowaychuk - Merge pull request #129 from nickl-/develop
+    aa084d9 TweeKane - Add global gitignore to git-ignore output
+    515e94a TJ Holowaychuk - Merge pull request #128 from nickl-/git-extras-html-hyperlinks
+    5f86b54 TJ Holowaychuk - Merge pull request #129 from nickl-/develop

+    $ git commits-since --ref 7.4.0
+    6ed2643 John Bachir - ability to specify command when hitting enter (#1223)
+    b9bd309 John Bachir - Improve `git-repl` prompt (#1224)
+    6f4cf0c johnpyp - feat: `delete-branch` multiple unique branch names completions (#1221)
+    ...
+    215382b 罗泽轩 - Bump version to 7.5.0-dev (#1207)

 ## AUTHOR