Glob Pattern Guide with auditor

All glob patterns in auditor must be enclosed with double quotes, like :

auditor hash input_path -i "**/*.txt"

Bellow the rules to use glob patterns:

Basic Wildcards

* - Match any characters (except /)

• *.doc - All .doc files in current directory
• test_*.txt - Files starting with "test_" and ending with ".txt"
• file.* - Any file named "file" with any extension

? - Match exactly one character

• file?.txt - Matches file1.txt, fileA.txt, but not file10.txt
• test?.ts - Matches test1.ts, testX.ts

** - Match any number of directories

• **/*.txt - All txt files in any subdirectory
• src/**/*.json - All JSON files under src/ at any depth
• **/test/** - Any file in a "test" directory at any level

Character Classes

[...] - Match one character from set

• file[123].txt - Matches file1.txt, file2.txt, file3.txt
• [abc]*.txt - txt files starting with a, b, or c
• test[0-9].log - test0.log through test9.log

[!...] - Match one character NOT in set

• [!.]*.txt - Text files not starting with a dot
• file[!0-9].rs - file followed by non-digit

Alternation

{a,b,c} - Match any of the alternatives

• *.{doc,xls} - All doc and xls files
• {src,tests}/**/*.txt - txt files in src/ or tests/ directories
• file.{txt,md,json} - file.txt, file.md, or file.json

Common Examples

# Configuration files
*.{json,yaml,toml,ini}

# Source code (excluding tests)
src/**/*.rs

# All documentation
**/*.{md,txt,rst}

# Test files
{tests,test}/**/*.rs
**/*_test.rs
**/test_*.rs

# Ignore hidden files
[!.]*

# Images
**/*.{png,jpg,jpeg,gif,svg,webp}

# Nested package files
**/Cargo.toml
**/package.json

# Everything in a specific directory
assets/**

# Files at specific depth
*/*.rs      # One level deep
*/*/*.rs    # Two levels deep

Negation Patterns (Wax-specific)

Wax supports negation with !:

# Match all Rust files except in target/
{**/*.rs,!target/**}

# Match all files except hidden ones
{**,!**/.*}