Command whose exit code indicates clean or dirty working directory

Command whose exit code indicates clean or dirty working directory

[Ross Goldberg]

[-- Attachment #1.1.1: Type: text/plain, Size: 530 bytes --]

What is the simplest git command that returns 0 if the working directory is completely clean, or nonzero if it is dirty in any way (staged diff, unstaged diff, file that is both untracked & not ignored, etc.), with nothing printed to stdout or to stderr?
If the simplest such command is complex, is there any feature request to create a simple command, possibly with options that specify what is considered dirty (staged diffs, unstaged diffs, untracked & not ignored, etc.)?

 
 
   Sent from   Proton Mail for iOS

[-- Attachment #1.1.2.1: Type: text/html, Size: 757 bytes --]

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 249 bytes --]

Re: Command whose exit code indicates clean or dirty working directory

[Junio C Hamano]

Ross Goldberg <ross.goldberg@proton.me> writes:

> If the simplest such command is complex, is there any feature request to create a simple
> command, possibly with options that specify what is considered dirty (staged diffs,
> unstaged diffs, untracked & not ignored, etc.)?

With the "possibly with options" part, I doubt there is.  Once you
start having to specify options, you admit that the problem space is
no longer simple.  Depending on occasion, you would be caring
different kind of cleanliness.

If you want to know if there are changes added to the index, "git
diff --cached --quiet" would be a way to ask about it.  If you want
to know if there are changes in the working tree relative to the
index, "git diff --quiet" would be a way to ask about it.  If you
want to know if there are changes in the working tree relative to
the HEAD commit, "git diff --quiet HEAD" would be.  You can use them
to ask about various things you care about, and you can combine
yourself, instead of using a single command with options to specify
which questions to ask.

Having said all that, if what you care the most is simplicity, you
can probably use "git describe --always --dirty", and see if the
output ends with "-dirty" suffix, perhaps?  I suspect that it does
not care about untracked files, which you may have to independently
ask command like "git clean -n".

Re: Command whose exit code indicates clean or dirty working directory

[brian m. carlson]

[-- Attachment #1: Type: text/plain, Size: 840 bytes --]

On 2025-04-10 at 17:49:23, Ross Goldberg wrote:
> What is the simplest git command that returns 0 if the working directory is completely clean, or nonzero if it is dirty in any way (staged diff, unstaged diff, file that is both untracked & not ignored, etc.), with nothing printed to stdout or to stderr?
> If the simplest such command is complex, is there any feature request to create a simple command, possibly with options that specify what is considered dirty (staged diffs, unstaged diffs, untracked & not ignored, etc.)?

Here's what I've used:

[ -z "$(git status --porcelain)" ]

That assumes you know the directory is a non-bare working tree.

`git status --porcelain` prints nothing if the working directory is
clean and prints what's dirty otherwise.
-- 
brian m. carlson (they/them)
Toronto, Ontario, CA

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 263 bytes --]