Selecting files

Every command takes the same three options to choose the files it updates.

Update one file

meziantou.html append-version --single-file dist/index.html

Update the files that match a pattern

--file-pattern is a glob pattern, relative to --root-directory:

meziantou.html append-version --file-pattern "**/*.html" --root-directory dist

The pattern uses the standard dialect of Meziantou.Framework.Globbing: * matches any characters of a name, ** any number of folders, {html,htm} one of the alternatives. The comparison is case-sensitive, and the wildcards do not match the names that start with a dot, such as .cache: see Names that start with a dot. Quote the pattern, so that your shell does not expand it.

A pattern that is not valid gives the message Glob pattern '…' is invalid on the standard error and a non-zero exit code, and no file is updated from the pattern. See Invalid patterns.

Combine the options

--single-file and --file-pattern can be given together: the tool updates the single file first, then the files that the pattern matches. A file that is selected both ways is updated twice. Without either option, the command updates nothing and exits with code 0.