I love playing around with commands on the Unix shell but one of the ones that I’ve found the most difficult to learn beyond the very basics is http://unixhelp.ed.ac.uk/CGI/man-cgi?find.

I think this is partially because I find the find man page quite difficult to read and partially because it’s usually quicker to work out how to solve my problem with a command I already know than to learn another one.

However, I recently came across Greg’s wiki which seems to do a pretty good job of explaining it.

Reasonably frequently I want to get a list of files to scan but want to exclude files in the .git directory since the results tend to become overwhelming with those included:

Here we’re saying find items which don’t have git in their path and which are of type 'f' (file) and then print them out.

If we don’t include the -type flag then the results will also include directories which isn’t what we want in this case. The -print is optional in this case since by default what we select will be printed.

Sometimes we want to exclude more than one directory which can be done with the following command:

Here we’re excluding the 'target', 'tools' and 'git' directories from the listing of files that we return.

The -a flag stands for 'and' so the above command reads 'find all files/directories which do not have target in their path and do not have tools in their path and do not have .git in their path'.

We can always make that command a bit more specific if any of those words legitimately appear in a path.

As well as the -print flag there is also a -prune flag which we can use to stop find from descending into a folder.

The first command could therefore be written like this:

This reads 'don’t go any further into a folder which has git in the path but print any other files which don’t have git in their path'.

I’m still finding -prune a bit confusing to understand and as the wiki points out:

A couple of months ago I was playing around with our git repository trying to get a list of all the scala files in the 'src/main' directory and I went with this command:

Using the above flags it could instead be written like this:

or

Interestingly those latter two versions seem to be a bit slower than the one that uses the -regex flag.

I’m not entirely sure why that is - presumably by supplying two flags on the latter two solutions find has to do more operations per line than it does with the -regex option or something like that?