Skip to main content

Matching Rules

Matching Rules let you define flexible search patterns for identifying text in IguanaX. IguanaX supports glob expression (*), sequence matching, SQL-like boolean operators, and regular expressions, so you can build rules ranging from basic keyword searches to more precise conditional matches.

By default, space-separated terms are treated as an ordered sequence. For example, #dev #test matches text where #dev appears before #test. You can combine terms with boolean operators such as AND, OR, and NOT to create more expressive rules.

Boolean operator precedence is as follows (highest to lowest):

  1. NOT (unary, right associative)

  2. AND (binary, left-associative)

  3. OR (binary, left-associative)

To use regex, simply enclose the expression in slash characters /<regex>/.

IguanaX does not support the V6 bang regex syntax !<regex> use /<regex>/ instead

The table below provides an overview of example pattern matching techniques you can use and combine to create a matching rule. Combination examples are provided.

Type

Sample

Description


Type

Sample

Description

Wildcard

*

Apply to all components.

#dev*

Apply to components with #dev followed by 0 or more characters

Sequence Matching

#prod #dev

Apply to components containing #prod #dev in order

OR

#prod OR #dev

Apply to components with either #prod or #dev tags.

AND

#prod AND #dev

Apply to components with both #prod and #dev tags.

NOT

NOT #prod

Apply to components without the #prod tag.

Combination

#prod #dev AND #supp

Apply to components containing the sequence #prod #dev and also #supp

Combination

#prod #dev OR #supp

Apply to components containing the sequence #prod #dev or #supp

Combination

#prod AND NOT #dev #supp

Apply to components containing #prod and not the sequence #dev #supp