abdullah/til
1
0
Fork 0
mirror of https://github.com/jbranchaud/til synced 2026-01-06 16:48:01 +00:00
Code Issues Projects Releases Wiki Activity

Add Check If A File Is Under Version Control as a Git TIL

Browse Source
This commit is contained in:
jbranchaud
2025-11-02 11:01:30 -06:00
parent 6e066ec72a
commit 6ef998b024
2 changed files with 38 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

36
git/check-if-a-file-is-under-version-control.md Normal file
View File

@@ -0,0 +1,36 @@
# Check If A File Is Under Version Control
The `git ls-files` command can be used with the `--error-unmatch` flag to check
if a file is under version control. It does this by checking if any of the
listed files appears on the _index_. If any does not, it is treated as an error.
In a project, I have a `README.md` that is under version control. And I have
`node_modules` that shouldn't be under version control (which is why they are
listed in my `.gitignore` file). I can check the README and a file somewhere in
`node_modules`.
```bash
❯ git ls-files --error-unmatch README.md
README.md
❯ git ls-files --error-unmatch node_modules/@ai-sdk/anthropic/CHANGELOG.md
error: pathspec 'node_modules/@ai-sdk/anthropic/CHANGELOG.md' did not match any file(s) known to git
Did you forget to 'git add'?
```
Notice the second command results in an error because of the untracked
`CHANGELOG.md` file in `node_modules`.
Here is another example of this at work while specifying multiple files:
```bash
❯ git ls-files --error-unmatch README.md node_modules/@ai-sdk/anthropic/CHANGELOG.md package.json
README.md
package.json
error: pathspec 'node_modules/@ai-sdk/anthropic/CHANGELOG.md' did not match any file(s) known to git
Did you forget to 'git add'?
```
Each tracked file gets listed and then the untracked file results in an error.
See `man git-ls-files` for more details.