threads / discuss / 57960

How to watch files in a Git repository

Subject: How to watch files in a Git repository

## tl;dr

5 messages between Jun 6, 2022 and Jun 9, 2022.

replies: 4people: 4as markdown or json

R. Diez· Jun 6, 2022, 16:04 UTC · lore
Hi all:
I would like to get a notification e-mail when certain files or directories change in a Git repository.
In the good old CVS days, you could just 'watch' a file with your favourite CVS GUI.
Some online services like GitHub offer their own notification mechanism, but I would like something generic. I am not looking for a hook solution, because the Git repositories may not be mine, so I may only have read access.
The idea is that I can set up a cron job to periodically pull a repository, and run a script to generate the e-mails from the commit history. Any new commits which match the desired branch and modify the desired files and/or directories would trigger the notifications.
I've searched the Web, but couldn't find anything straightforward.
If there is nothing of the sort, I could write my own script in Bash or Perl. I can handle cron and sending e-mails, but I do not know much about Git's internals. Could someone provide a few pointers about how to code this? I would expect there is some command to list commits, and all files touched by a particular commit. And there would be some way to interface with Bash or Perl, which does not need parsing complicated text output from Git.
Thanks in advance,
   rdiez
Jeff King· Jun 8, 2022, 23:55 UTC · re: R. Diez · lore

Re: How to watch files in a Git repository

On Mon, Jun 06, 2022 at 06:04:11PM +0200, R. Diez wrote:
Show 7 quoted lines
> If there is nothing of the sort, I could write my own script in Bash
> or Perl. I can handle cron and sending e-mails, but I do not know much
> about Git's internals. Could someone provide a few pointers about how
> to code this? I would expect there is some command to list commits,
> and all files touched by a particular commit. And there would be some
> way to interface with Bash or Perl, which does not need parsing
> complicated text output from Git.
This sounds kind of like git-multimail:
  https://github.com/git-multimail/git-multimail

That's usually triggered from a hook, I think, but it would not be hard to trigger it with arbitrary segments of history.

You'd probably want to keep a "seen" ref of processed commits, and move from that, like:

  # assuming you just care about one branch on the remote, but this
  # concept can be extended to several
  branch=refs/remotes/origin/main
  seen=refs/heads/seen
  git fetch
  # I don't know what git-multimail expects, but this is similar to what
  # a server-side receive hook would show
  echo "$(git rev-parse $seen) $(git rev-parse $branch) $branch" |
  some-git-multimail-command
  # now move your pointer forward for next time
  git update-ref $seen $branch

If multimail doesn't do what you want, then you can probably just script around:

  git rev-list $seen..$branch -- $paths_you_care_about |
  git diff-tree --stdin -r --name-only --format="Commit %h touched: " -- $paths_you_care_about
depending how you want to format things.
-Peff
rsbecker@nexbridge.com· Jun 9, 2022, 06:16 UTC · re: Jeff King · lore

RE: How to watch files in a Git repository

On June 8, 2022 7:55 PM, Jeff King wrote:
Show 43 quoted lines
>On Mon, Jun 06, 2022 at 06:04:11PM +0200, R. Diez wrote:
>
>> If there is nothing of the sort, I could write my own script in Bash
>> or Perl. I can handle cron and sending e-mails, but I do not know much
>> about Git's internals. Could someone provide a few pointers about how
>> to code this? I would expect there is some command to list commits,
>> and all files touched by a particular commit. And there would be some
>> way to interface with Bash or Perl, which does not need parsing
>> complicated text output from Git.
>
>This sounds kind of like git-multimail:
>
>  https://github.com/git-multimail/git-multimail
>
>That's usually triggered from a hook, I think, but it would not be hard to trigger it
>with arbitrary segments of history.
>
>You'd probably want to keep a "seen" ref of processed commits, and move from
>that, like:
>
>  # assuming you just care about one branch on the remote, but this
>  # concept can be extended to several
>  branch=refs/remotes/origin/main
>  seen=refs/heads/seen
>
>  git fetch
>
>  # I don't know what git-multimail expects, but this is similar to what
>  # a server-side receive hook would show
>  echo "$(git rev-parse $seen) $(git rev-parse $branch) $branch" |
>  some-git-multimail-command
>
>  # now move your pointer forward for next time
>  git update-ref $seen $branch
>
>If multimail doesn't do what you want, then you can probably just script
>around:
>
>  git rev-list $seen..$branch -- $paths_you_care_about |
>  git diff-tree --stdin -r --name-only --format="Commit %h touched: " --
>$paths_you_care_about
>
>depending how you want to format things.
I am unsure this solves the question. Is the OP looking for anyone who modifies any set or subset of files in any clone or in the upstream repo? This is generally considered a "watch" function and is sometimes available on the upstream repo manager, like GitHub/GitLab/BitBucket rather than in core git, so take into account changes made anywhere. If that is the case and the watch functions are not sufficient, you might have to put the hooks on your upstream rather than in your clone.

Just my thoughts, Randall

Jeff King· Jun 9, 2022, 15:07 UTC · re: rsbecker@nexbridge.com · lore

Re: How to watch files in a Git repository

On Thu, Jun 09, 2022 at 02:16:03AM -0400, rsbecker@nexbridge.com wrote:
Show 5 quoted lines
> I am unsure this solves the question. Is the OP looking for anyone who
> modifies any set or subset of files in any clone or in the upstream
> repo? This is generally considered a "watch" function and is sometimes
> available on the upstream repo manager, like GitHub/GitLab/BitBucket
> rather than in core git, so take into account changes made anywhere.

In the original message the OP said they wanted to watch repos to which they only have read access. So I think any solution has to be "fetch and check for changes".

-Peff
Son Luong Ngoc· Jun 9, 2022, 08:33 UTC · re: R. Diez · lore

Re: How to watch files in a Git repository

Hi Diez,
Show 13 quoted lines
> On Jun 6, 2022, at 6:04 PM, R. Diez <rdiez1999@gmail.com> wrote:
> 
> Hi all:
> 
> I would like to get a notification e-mail when certain files or directories change in a Git repository.
> 
> In the good old CVS days, you could just 'watch' a file with your favourite CVS GUI.
> 
> Some online services like GitHub offer their own notification mechanism, but I would like something generic. I am not looking for a hook solution, because the Git repositories may not be mine, so I may only have read access.
> 
> The idea is that I can set up a cron job to periodically pull a repository, and run a script to generate the e-mails from the commit history. Any new commits which match the desired branch and modify the desired files and/or directories would trigger the notifications.
> 
> I've searched the Web, but couldn't find anything straightforward.

I would encourage you to try SourceGraph’s CodeMonitoring feature (1). You can configure a search query which target a file path inside a repository, then it will send email to you when there are new commits/diffs touching those files.

I have no affiliation with them except for being a happy end user. In fact, I used SourceGraph extensively while studying git/git codebase.

Show 5 quoted lines
> 
> If there is nothing of the sort, I could write my own script in Bash or Perl. I can handle cron and sending e-mails, but I do not know much about Git's internals. Could someone provide a few pointers about how to code this? I would expect there is some command to list commits, and all files touched by a particular commit. And there would be some way to interface with Bash or Perl, which does not need parsing complicated text output from Git.
> 
> Thanks in advance,
>  rdiez

Cheers, Son Luong

(1): https://docs.sourcegraph.com/code_monitoring

← back to recent threads