1
diff.ps1 [-verbose] [-baseDir BASE_DIR] [-out OUT_FILE] COMMIT_HASH

1
git log --name-only --no-merges --dense --format="%n>>%h|%ai|%s" abc123..HEAD

1
for arg in $@
2
do
3
  case $arg in
4
    -verbose)
5
    verbose=1
6
    shift
7
    ;;
8
    -baseDir)
9
    shift
10
    baseDir=$1
11
    shift
12
    ;;
13
    *)
14
    -out)
15
    shift
16
    outFile=$1
17
    shift
18
    ;;
19
    afterCommit=$1
20
    shift
21
    ;;
22
  esac
23
done

1
param(
2
  [string]$baseDir = "content/blog/",
3
  [string]$out,
4
  [Parameter(Position = 0, Mandatory = $true)] [string] $afterCommit
5
)

1
function GetDiffList ([string] $startHash, [string] $relTo) {
2
  # 调用 git 命令
3
  [string[]]$lines = git log --name-only --no-merges --dense --format="%n>>%h|%ai|%s" "$startHash..HEAD"
4

5
  foreach ($line in $lines) {
6
    $line = $line.Trim()
7
    if ([String]::IsNullOrEmpty($line)) {
8
      continue
9
    }
10
    elseif ($line -match ">>([a-z0-9]+?)\|(.+?)\|(.+)") {
11
      # 正则匹配结果自动保存到内置的 $Matches 变量中
12
      $hash = $Matches[1]
13
      $datetime = $Matches[2]
14
      $subject = $Matches[3]
15
      Write-Verbose "$hash / $datetime / $subject"
16
    }
17
    elseif ($line.StartsWith($baseDir)) {
18
      $relPath = $line.Substring($baseDir.Length)
19
      Write-Verbose $relPath
20
    }
21
  }
22
}
23

24
# 调用函数并传参
25
GetDiffList $afterCommit $baseDir

1
[String]:IsNullOrEmpty($line)

1
# highlight-start
2
# 你甚至可以用 using namespace 来简化代码
3
using namespace System.Collections
4
using namespace System.Collections.Generic
5
# highlight-end
6

7
...
8

9
# highlight-start
10
# 这里是我们的比较器，按路径字符串升序排序，且不区分大小写
11
class FilePathComparer:IComparer[string] {
12
  [CaseInsensitiveComparer]$caseiComp = [CaseInsensitiveComparer]::new()
13
  [int] Compare([string]$a, [string]$b) {
14
    return $this.caseiComp.Compare($a, $b)
15
  }
16
}
17
# highlight-end
18

19
function GetDiffList (...) {
20
  ...
21
  # highlight-start
22
  # 创建 SortedSet 和 List ，注意这里展示了两种不同的 new 对象的方式
23
  $filePaths = [SortedSet[string]]::new([FilePathComparer]::new())
24
  $commits = New-Object List[Commit]
25
  # highlight-end
26
  foreach ($line in $lines) {
27
    $line = $line.Trim()
28
    if ([String]::IsNullOrEmpty($line)) {
29
      continue
30
    }
31
    elseif ($line -match ">>([a-z0-9]+?)\|(.+?)\|(.+)") {
32
      ...
33
      # highlight-range{1-2}
34
      # $commit 对象会在下一节中创建
35
      $commits.Add($commit)
36
    }
37
    elseif ($line.StartsWith($baseDir)) {
38
      $relPath = $line.Substring($baseDir.Length)
39
      Write-Verbose $relPath
40
      # highlight-range{1-2}
41
      # 要用管道操作将命令输出传递给空目标，否则会影响 return 的值
42
      $filePaths.Add($relPath) | Out-Null
43
    }
44
  }
45
}
46
...

1
...
2

3
# highlight-start
4
class Commit {
5
  [string] $hash;       # Commit Hash
6
  [string] $datetime;   # 提交的日期时间，简便起见这里不再转化成专用的数据类型了
7
  [string] $subject;    # 提交说明的主题
8

9
  # Override ToString() 函数，让打印输出更漂亮
10
  [string] ToString() {
11
    return [String]::Format(
12
      # PowerShell中，\n, \t等写作 `n, `t
13
      "[{0}] {1}`n`t @ {2}",
14
      $this.hash,
15
      $this.subject,
16
      $this.datetime)
17
  }
18
}
19
# highlight-end
20

21
function GetDiffList(...) {
22
  ...
23
}
24
...

1
function GetDiffList(...){
2
  ...
3
  # highlight-start
4
  $commit = [Commit] @{
5
    hash     = $Matches[1];
6
    datetime = $Matches[2];
7
    subject  = $Matches[3];
8
  }
9
  Write-Verbose $commit
10
  # highlight-end
11
  $commits.Add($commit)
12
  ...
13
}

1
function GetDiffList(...){
2
  ...
3
  # highlight-start
4
  return @{
5
    commits   = $commits;
6
    filePaths = $filePaths;
7
  }
8
  # highlight-end
9
}

1
...
2
# highlight-start
3
# 先转成 JSON
4
$json = GetDiffList $afterCommit $baseDir | ConvertTo-Json
5
if ([string]::IsNullOrEmpty($out)) {
6
# 如果是 Dry-Run 或没有指定输出文件，则直接打印在控制台中
7
  Write-Host $json
8
}
9
else {
10
  # 否则写到文件里
11
  $json | Out-File $out
12
}
13
# highlight-end

1
.\diff.ps1 -out diff.json 8534dfe55

1
using namespace System.Collections
2
using namespace System.Collections.Generic
3

4
param(
5
  [string]$baseDir = "content/blog/",
6
  [switch]$dryRun,
7
  [string]$out,
8
  [Parameter(Position = 0, Mandatory = $true)] [string] $afterCommit
9
)
10

11
class FilePathComparer:IComparer[string] {
12
  [CaseInsensitiveComparer]$caseiComp = [CaseInsensitiveComparer]::new()
13
  [int] Compare([string]$a, [string]$b) {
14
    return $this.caseiComp.Compare($a, $b)
15
  }
16
}
17

18
class Commit {
19
  [string] $hash;
20
  [string] $datetime;
21
  [string] $subject;
22

23
  [string] ToString() {
24
    return [String]::Format("[{0}] {1}`n`t @ {2}", $this.hash, $this.subject, $this.datetime)
25
  }
26
}
27

28
function GetDiffList ([string] $startHash, [string] $relTo) {
29
  [string[]]$lines = git log --name-only --no-merges --dense --format="%n>>%h|%ai|%s" "$startHash..HEAD"
30
  $filePaths = [SortedSet[string]]::new([FilePathComparer]::new())
31
  $commits = New-Object List[Commit]
32
  foreach ($line in $lines) {
33
    $line = $line.Trim()
34
    if ([String]::IsNullOrEmpty($line)) {
35
      continue
36
    }
37
    elseif ($line -match ">>([a-z0-9]+?)\|(.+?)\|(.+)") {
38
      $commit = [Commit] @{
39
        hash     = $Matches[1];
40
        datetime = $Matches[2];
41
        subject  = $Matches[3];
42
      }
43
      Write-Verbose $commit
44
      $commits.Add($commit)
45
    }
46
    elseif ($line.StartsWith($baseDir)) {
47
      $relPath = $line.Substring($baseDir.Length)
48
      Write-Verbose $relPath
49
      $filePaths.Add($relPath) | Out-Null
50
    }
51
  }
52
  return @{
53
    commits   = $commits;
54
    filePaths = $filePaths;
55
  }
56
}
57

58
$json = GetDiffList $afterCommit $baseDir | ConvertTo-Json
59
if ($dryRun -or [string]::IsNullOrEmpty($out)) {
60
  Write-Host $json
61
}
62
else {
63
  $json | Out-File $out
64
}