Add Show Summary Stats For Current Branch as a Git TIL

README.md

@@ -10,7 +10,7 @@ pairing with smart people at Hashrocket.
 
 For a steady stream of TILs, [sign up for my newsletter](https://crafty-builder-6996.ck.page/e169c61186).
 
-_1683 TILs and counting..._
+_1684 TILs and counting..._
 
 See some of the other learning resources I work on:
 
@@ -409,6 +409,7 @@ If you've learned something here, support my efforts writing daily TILs by
 - [Show File Diffs When Viewing Git Log](git/show-file-diffs-when-viewing-git-log.md)
 - [Show List Of Most Recently Committed Branches](git/show-list-of-most-recently-committed-branches.md)
 - [Show Only Commits That Touch Specific Lines](git/show-only-commits-that-touch-specific-lines.md)
+- [Show Summary Stats For Current Branch](git/show-summary-stats-for-current-branch.md)
 - [Show The diffstat Summary Of A Commit](git/show-the-diffstat-summary-of-a-commit.md)
 - [Show The Good And The Bad With Git Bisect](git/show-the-good-and-the-bad-with-git-bisect.md)
 - [Show What Is In A Stash](git/show-what-is-in-a-stash.md)

git/show-summary-stats-for-current-branch.md

@@ -0,0 +1,26 @@
+# Show Summary Stats For Current Branch
+
+When I push a branch up to GitHub as a PR, there is a part of the UI that shows
+you how many lines you've added and removed for this branch. It bases that off
+the target branch which is typically your `main` branch.
+
+The `git diff` command can provide those same stats right in the terminal. The
+key is to specify the `--shortstat` flag which tells `git` to exclude other diff
+output and only show:
+
+- Number of files changed
+- Number of insertions
+- Number of deletions
+
+Here is the summary stats for a branch I'm working on:
+
+```bash
+❯ git diff --shortstat main
+ 8 files changed, 773 insertions(+), 25 deletions(-)
+```
+
+We have to be on our feature branch and then we point to the branch (or whatever
+ref) we want to diff against. Since I want to know how my feature branch
+compares to `main`, I specify that.
+
+See `man git-diff` for more details.