diff --git a/README.md b/README.md index ba55047..5a658d9 100644 --- a/README.md +++ b/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) diff --git a/git/show-summary-stats-for-current-branch.md b/git/show-summary-stats-for-current-branch.md new file mode 100644 index 0000000..5fdbd78 --- /dev/null +++ b/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.