Path Expressions

Path expressions are used to restrict access grants in code owner config files to only apply to a subset of files in a directory (e.g. see per-file rule for the find-owners backend).

Which syntax is used depends on the used code owner backend:

Globs

Globs support the following wildcards:

  • *: matches any string that does not include slashes
  • **: matches any string, including slashes
  • ?: matches any character
  • [abc]: matches one character given in the bracket
  • [a-c]: matches one character from the range given in the bracket
  • {html,htm}: matches either of the 2 expressions, html or htm

See below for examples.

Simple path expressions

Simple path expressions use the following wildcards:

  • *: matches any string that does not include slashes
  • ...: matches any string, including slashes

See below for examples.

Examples

To MatchGlobSimple Path Expression
Concrete file in current folderBUILDBUILD
File type in current folder*.md*.md
Concrete file in the current folder and in all subfolders{**/,}BUILDneeds 2 expressions: BUILD + .../BUILD
File type in the current folder and in all subfolder**.md....md
All files in a subfoldermy-folder/**my-folder/...
All “foo-<1-digit-number>.txt” files in all subfolders{**/,}foo-[0-9].txtnot possible
All “foo-.txt” files in all subfoldersnot possiblenot possible

Back to @PLUGIN@ documentation index

Part of Gerrit Code Review