From f13a96834d6ee2fa13e41187232146253dcf802d Mon Sep 17 00:00:00 2001
From: James Brundage <+@noreply.github.com>
Date: Tue, 24 Sep 2024 22:25:24 -0700
Subject: [PATCH] docs: ChangesByIssueNumber example ( Fixes #294 )

---
 Examples/ChangesByIssueNumber.ugit.ps1 | 40 ++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)
 create mode 100644 Examples/ChangesByIssueNumber.ugit.ps1

diff --git a/Examples/ChangesByIssueNumber.ugit.ps1 b/Examples/ChangesByIssueNumber.ugit.ps1
new file mode 100644
index 00000000..74af4f47
--- /dev/null
+++ b/Examples/ChangesByIssueNumber.ugit.ps1
@@ -0,0 +1,40 @@
+<#
+.SYNOPSIS
+    Generates a Mermaid graph of changes by issue number.
+.DESCRIPTION
+    Generates a Mermaid graph of changes by the referenced issue number, for the current branch.
+#>
+param()
+
+$gitRemote = git remote
+$headBranch = git remote |
+    Select-Object -First 1 |
+    git remote show |
+    Select-Object -ExpandProperty HeadBranch
+
+$currentBranch = git branch | ? IsCurrentBranch
+if ($currentBranchName -eq $headBranch) {
+    Write-Warning "Not graphing the main branch."
+    return
+}
+
+$currentBranchCommits = git log "$($gitRemote.RemoteName)/$headBranch..$CurrentBranch"
+$changesByUserName = $currentBranchCommits |     
+    Group-Object GitUserName -NoElement    
+
+if ($env:GITHUB_STEP_SUMMARY) { 
+"
+~~~mermaid
+$(
+@(
+"pie title Changes by Issue"
+foreach ($changeSet in $changesByUserName) {
+    (' ' * 4) + '"' + $($changeSet.Name) + '"' + ' : ' + ($changeSet.Count)
+}
+) -join [Environment]::NewLine)
+~~~
+
+" |
+        Out-File -Append -FilePath $env:GITHUB_STEP_SUMMARY
+}
+