git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH 0/8] Introduce git-blame-tree(1) command

From
Taylor Blau <me@ttaylorr.com>
Date
Mar 27, 2025, 21:58 UTC
Message-ID
<Z+XJ+1L3PnC9Dyba@nand.local>
In-Reply-To
<20250327063243.GB3042475@coredump.intra.peff.net>
On Thu, Mar 27, 2025 at 02:32:43AM -0400, Jeff King wrote:
Show 7 quoted lines
> The pathspec-trie stuff is, I think, still a reasonable idea for general
> use. But IIRC, the rewritten blame-tree you guys worked on does not
> benefit from it, because it ditches pathspecs entirely (both because
> they're too slow without the tries, but also because it's important to
> continually narrow the pathspec while traversing). That trie code was
> never run in production, I think (and I see there is a patch to narrow
> the pathspec while traversing; I suspect that likewise was never used).

Yeah, the rewritten blame-tree code uses changed-path Bloom filters to narrow the set of revisions that we need to actually compute tree-diffs for.

The general idea is that we have a set of paths that we have yet to blame, and those are the "interesting" ones. IOW, if a changed-path Bloom filter tells us that we are at some revision where there is maybe a change to one or more unblamed paths, we need to compute a tree-diff. But if the Bloom filter says "no", then we can skip the tree-diff at that layer entirely.

Show 6 quoted lines
> The max-depth diff code is also in theory a reasonable thing to have in
> general. But it is awkward to use, and not really necessary for
> blame-tree. There we really only care about recursing vs not recursing,
> but the usual "recursive" flag for diffing isn't enough (we have to
> recurse down to the tree of interest, but may not want to go further). I
> don't remember how that is handled in your blame-tree rewrites.

I think that's mostly true, but the blame-tree caching stuff that Stolee worked on many years ago and mentioned below does require it IIRC.

> So yeah. I don't know if all of this is really a very good starting
> point. Taylor, if you can share the current code that GitHub is running,
> I think that would be beneficial for the community.

Sure. You can fetch from the 'tb/blame-tree' branch from my tree (which is located at 'git@github.com:ttaylorr/git.git'). I owe a huge "thank you" to Victoria Dye, who split out the various topics from GitHub's fork into individual rebased branches.

There were many more patches on top that came after Victoria's split above, and I applied those manually. The commit structure probably needs significant clean-up and polishing before it's ready for serious review, since this is more-or-less a raw dump of the work on GitHub's side over more than a decade.

It also doesn't pass the tests in t9932 (and the test number should probably also be reworked, it's in the t99xx range so that inclusion in GitHub's fork doesn't cause collisions with new tests when we merge upstream). To that end, I removed everybody's Signed-off-by in case I have mangled their work in some way unintentionally.

Thanks, Taylor

Previous: Jeff KingNext: Toon Claes
Message 12 of 15 in “Introduce git-blame-tree(1) command”
  1. 0/8 Introduce git-blame-tree(1) commandToon Claes, Mar 26, 2025
  2. 1/8 combine-diff: zero memory used for callback filepairsToon Claes, Mar 26, 2025
  3. 2/8 within_depth: fix return for empty pathToon Claes, Mar 26, 2025
  4. 3/8 diff: teach tree-diff a max-depth parameterToon Claes, Mar 26, 2025
  5. 4/8 blame-tree: introduce new subcommand to blame filesToon Claes, Mar 26, 2025
  6. 5/8 pathspec: add optional trie indexToon Claes, Mar 26, 2025
  7. 6/8 pathspec: turn on tries when appropriateToon Claes, Mar 26, 2025
  8. 7/8 tree-diff: use pathspec triesToon Claes, Mar 26, 2025
  9. 8/8 blame-tree: narrow pathspec as we traverseToon Claes, Mar 26, 2025
  10. Taylor BlauMar 26, 2025
  11. Jeff KingMar 27, 2025
  12. Taylor BlauMar 27, 2025
  13. Toon ClaesMar 28, 2025
  14. Jeff KingApr 1, 2025
  15. Derrick StoleeMar 27, 2025

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.