以编程方式确定 Git 分支状态的正确方法是什么？

Question

我阅读了其他各种 SO 帖子和 Google 搜索结果，如果您正在解析当前的 git 分支，git status --porcelain 并不是您真正想要依赖的命令以编程方式。我最终被指向执行此操作的 rev-parse、diff-index 和 diff-files 命令 - 但是，我当前使用的方法有点错误，特别是在 master 以外的分支上。像 Bureau for oh-my-zsh 这样的主题似乎正在使用 git status --porcelain，我在上面提到的 Git 社区不推荐。那么读取这些分支状态的正确方法是什么？

来自 Bureau Oh-My-ZSH 主题的代码段，以便清楚我要重现的行为。

bureau_git_status () {
  _INDEX=$(command git status --porcelain -b 2> /dev/null)
  _STATUS=""
  if $(echo "$_INDEX" | grep '^[AMRD]. ' &> /dev/null); then
    _STATUS="$_STATUS$ZSH_THEME_GIT_PROMPT_STAGED"
  fi
  if $(echo "$_INDEX" | grep '^.[MTD] ' &> /dev/null); then
    _STATUS="$_STATUS$ZSH_THEME_GIT_PROMPT_UNSTAGED"
  fi
  if $(echo "$_INDEX" | command grep -E '^\?\? ' &> /dev/null); then
    _STATUS="$_STATUS$ZSH_THEME_GIT_PROMPT_UNTRACKED"
  fi
  if $(echo "$_INDEX" | grep '^UU ' &> /dev/null); then
    _STATUS="$_STATUS$ZSH_THEME_GIT_PROMPT_UNMERGED"
  fi
  if $(command git rev-parse --verify refs/stash >/dev/null 2>&1); then
    _STATUS="$_STATUS$ZSH_THEME_GIT_PROMPT_STASHED"
  fi
  if $(echo "$_INDEX" | grep '^## .*ahead' &> /dev/null); then
    _STATUS="$_STATUS$ZSH_THEME_GIT_PROMPT_AHEAD"
  fi
  if $(echo "$_INDEX" | grep '^## .*behind' &> /dev/null); then
    _STATUS="$_STATUS$ZSH_THEME_GIT_PROMPT_BEHIND"
  fi
  if $(echo "$_INDEX" | grep '^## .*diverged' &> /dev/null); then
    _STATUS="$_STATUS$ZSH_THEME_GIT_PROMPT_DIVERGED"
  fi

  echo $_STATUS
}

我最终将支持上述所有行为，这是我的开始以及我目前用来做事的基本命令（很抱歉它是 Haskell，希望如此这不会阻止任何人了解代码的要点 - 没有双关语意）。

hasCommitsToPush :: IO (Maybe Bool)
hasCommitsToPush = do
  latestCommits <- liftM (fmap $ deleteNulls . splitOnNewLine) $ parseProcessResponse gitRemoteRefDiff
  case latestCommits
    of Nothing                                      -> return Nothing
       Just []                                      -> return $ Just False
       Just [_]                                     -> return $ Just True -- This case is for a new repository with the first commit in local but not yet pushed.
       Just [latestRemoteCommit, latestLocalCommit] -> return . Just $ latestRemoteCommit /= latestLocalCommit
       _                                            -> return Nothing
  where gitRemoteRefDiff = readProcessWithExitCode "git" ["rev-parse", "@{u}", "HEAD"] []

hasStagedChanges :: IO (Maybe Bool)
hasStagedChanges = liftM (fmap isResponseNull) $ parseProcessResponse gitResponse
  where gitResponse = readProcessWithExitCode "git" ["diff-index","--cached","--ignore-submodules","HEAD"] []

hasUnstagedChanges :: IO (Maybe Bool)
hasUnstagedChanges = liftM (fmap isResponseNull) $ parseProcessResponse gitStatus
  where gitStatus = readProcessWithExitCode "git" ["diff-files","--ignore-submodules"] []

Edit AndrewC 指出 --porcelain 在文档中被描述为用于脚本解析。这让我问这个问题，我什么时候应该使用 rev-parse 与 --porcelain??

Answer 1

原来有官方回答：

如评论中所述，文档确实表示带有 Git 状态的 --porcelain 标志可以为脚本提供解析。我的困惑来源是，一般来说，这不是瓷旗的作用，传统上，通常会在 Git 中为此目的指定一个 'plumbing' 命令。因此，在这种情况下，使用 --porcelain 标志似乎是解析 Git 存储库状态的一种可接受的方式，但这是 --porcelain 通常意味着什么的例外。

我在搜索更好的解释时发现的以下 SO 帖子中包含更多详细信息。 What does git rev-parse do? What does the term "porcelain" mean in Git?

以编程方式确定 Git 分支状态的正确方法是什么？

What's the proper way to determine the status of a Git branch programmatically?

git

parsing

haskell