Name filter

pls allows the user to filter the contents by regex matching on names. Name matching can be used to exclude the names that match a certain pattern or only include the names that match a certain pattern. Both can be used in tandem to perform very powerful filtering.

Arguments

--exclude/-e can be used to remove the files that match the given pattern. --only/-o can be used to remove the files that do not match the given pattern.

Caution

Specifying both --only/-o and --exclude/-e will limit pls to only showing files that simultaneously match both rules.

Caution

Name filtering is not applicable when listing a specific node.

Examples

pls # or --only='.*' --exclude='$^'

󰋩  a.jpg
  a.rs
󰋩  b.jpg
  b.rs
󰋩  c.jpeg
  c.rs

pls --only='(a|c)' --exclude='\.jpe?g$'

 a.rs c.rs

pls --exclude='\.jpe?g$' a.jpg # `--exclude` has no effect

󰋩 a.jpg