mercurialdvcs

How do you check if a mercurial repo is in a clean state?


As a user, I usually use hg st to check the status of a repo, and verify that it is in a clean state, with no modified files.

Here I would like to do this programmatically. I know I can also use hg st for that, but the output is less than ideal for consumption by a computer program. Is there a better way to check whether a mercurial repo is in a clean state?


Solution

  • If you issue the hg identify --id command, it will suffix the ID with a + character when the repository has modified files. (Note: this flag does not report untracked files.)

    If you grep the output of this command for the + character, you can use the exit status to determine whether there are modifications or no:

    $ hg init
    $ hg identify --id | grep --quiet + ; echo $?
    1
    $ touch a
    $ hg identify --id | grep --quiet + ; echo $?
    1
    $ hg add a
    $ hg identify --id | grep --quiet + ; echo $?
    0