Lib.rs

重复与字符类结合使用效果良好。最常见的glob表达式如下：{????}，但更具体的表达式<[0-9]:4>将进一步限制匹配字符为数字，例如。重复也可以更加简洁，如<?:8>。此外，重复还可以形成树表达式，进一步限制组件，例如<[!.]*/>[!.]*以匹配任何组件中不包含前导点.的路径。

重复必须考虑相邻规则和邻近模式。例如，a/<b/**:1,>是允许的，但<a/**:1,>/b则不允许。此外，它们不能包含由单个分隔符/、单个零或更多通配符*或$组成的子glob，也不能包含单个树通配符**。具有零下界的重复不能作为glob表达式的根，因为这可能导致表达式匹配或遍历重叠的树。

组合器

可以使用any组合器将glob模式组合并匹配在一起。any接受一个IntoIterator，其项是编译后的Pattern或str切片。输出是一个Any，它实现了Pattern并高效地匹配其输入模式中的任何一个。

use wax::{Glob, Pattern};

let any = wax::any(["**/*.txt", "src/**/*.rs"]).unwrap();
assert!(any.is_match("src/lib.rs"));

与替代不同，Any支持具有重叠树（根和未根表达式）的模式。然而，组合器只能执行逻辑匹配，并且无法将Any与目录树匹配（如使用Glob::walk）。

标志和大小写敏感性

标志切换glob的匹配行为。重要的是，标志是glob表达式的组成部分，而不是API的一部分。行为在标志之后立即切换，其顺序与glob表达式中的出现顺序相同。标志由带有前导问号的括号分隔（(?...)），并且可以在glob表达式的任何位置出现，只要它们不分割树形通配符（例如，a/*(?i)*是不允许的）。每个标志由一个字符表示，可以通过在相应的字符之前加一个减号来取消其作用-。标志的切换顺序与它们在(?...)中出现的顺序相同。

唯一支持的标志是不区分大小写的标志i。默认情况下，glob表达式使用与目标平台文件系统API相同的区分大小写的方式（Unix上是区分大小写，Windows上是不区分大小写），但可以使用i来明确切换。例如，(?-i)photos/**/*.(?i){jpg,jpeg}匹配photos目录下具有区分大小写的基本名和区分大小写扩展名jpg或jpeg的文件路径。

Wax在通过Glob::partition对glob表达式进行分区时，考虑了文字、它们的配置的大小写敏感性和目标平台文件系统API的大小写敏感性时。没有标志的glob表达式的分区不受影响。

错误和诊断

GlobError类型表示在构建模式或遍历目录树时可能发生的错误条件。GlobError及其子错误通过thiserror实现了标准的Error和Display特性。

Wax可以选择与miette crate集成，该crate可以用于捕获和显示诊断信息。这对于向用户提供glob表达式很有用。当启用时，错误类型实现Diagnostic特性。

Error: wax::glob::adjacent_zero_or_more

  x malformed glob expression: adjacent zero-or-more wildcards `*` or `$`
   ,----
 1 | doc/**/*{.md,.tex,*.txt}
   :        |^^^^^^^^|^^^^^^^
   :        |        | `-- here
   :        |        `-- in this alternative
   :        `-- here
   `----

Wax还提供了检查API，允许代码查询glob元数据，如捕获和变体。

use wax::Glob;

let glob = Glob::new("videos/**/{*.{mp4,webm}}").unwrap();
assert_eq!(2, glob.captures().count());

Cargo特性

Wax提供了一些可选的集成和特性，可以通过以下描述的Cargo特性进行切换。

可以在crate的Cargo.toml清单中配置特性。

[dependency.wax]
version = "^0.x.0"
default-features = false
features = [
    "miette",
    "walk"
]

不支持的路径特性

任何既不被识别为分隔符也不被识别为模式的组件都被解释为字面量。与严格规则结合使用时，这意味着某些特定平台的路径功能不能直接在glob中使用。这种限制是设计上的，对于某些用例可能需要额外的代码来弥合这一差距。

分区和语义字面量

Glob不支持当前或父目录的概念。路径组件.和..被解释为字面量，并且只匹配具有相应组件的路径（即使在Unix和Windows上）。例如，glob src/../*.rs 匹配路径 src/../lib.rs，但不匹配语义等效的路径 lib.rs。

当父目录组件在glob中跟随模式时，它们的意义不明确，并且用途也大大减少。然而，当它们作为变体模式的前缀时（即作为前缀），这些组件是直观的，并且对于跳出工作目录非常重要。例如，glob ../src/**/*.rs 的意图比glob src/**/../*.rs 更明显。然而，如上所述，第一个glob只会匹配字面路径组件 ..，而不会匹配用父目录替换此处的路径。

Glob::partition可用于隔离模式之前的语义组件，并将语义路径操作应用于它们（即..）。Glob::partition将glob分成一个不变的PathBuf前缀和一个可变的Glob后缀。在这里，不变意味着分区不包含glob模式，这些模式在目标平台文件系统API中使用等效的本地路径解析时会有所不同。前缀可以与glob结合使用。

use dunce; // Avoids UNC paths on Windows.
use std::path::Path;
use wax::{Glob, Pattern};

let path: &Path = /* ... */ // Candidate path.

let directory = Path::new("."); // Working directory.
let (prefix, glob) = Glob::new("../../src/**").unwrap().partition();
let prefix = dunce::canonicalize(directory.join(&prefix)).unwrap();
if dunce::canonicalize(path)
    .unwrap()
    .strip_prefix(&prefix)
    .map(|path| glob.is_match(path))
    .unwrap_or(false)
{
    // ...
}

此外，可以使用Glob::has_semantic_literals来检测glob中具有目标平台特殊语义的字面量组件。当启用miette功能时，此类字面量作为警告报告。

use wax::Glob;

let glob = Glob::new("../**/src/**/main.rs").unwrap();
assert!(glob.has_semantic_literals());

方案和前缀

虽然glob可以有根，但不能包含方案或Windows路径前缀。例如，Windows的UNC共享路径 \\server\share\src 不能直接表示为glob。

这可能有限制，但Wax的设计明确禁止了这一点：Windows前缀和其他卷组件是不可移植的。相反，当需要这样做时，必须使用额外的本地路径或工作目录，例如Nym提供的--tree选项。在大多数情况下，glob是相对于此类工作目录应用。

非规范约束

Glob是严格规范的，不支持任何非规范约束。在glob表达式中，无法直接根据额外的元数据（如修改时间戳）过滤路径或文件。然而，用户代码可以查询匹配路径的任何此类元数据，或者使用FileIterator::filter_tree在匹配目录树时有效地应用此类过滤。

有关此类附加功能，包括使用匹配文本进行元数据和转换，请参阅Nym。

编码

Glob仅对UTF-8编码的文本进行操作。然而，这种编码并不是所有平台上路径的编码。Wax使用CandidatePath类型通过使用Unicode替换代码点进行有损转换来重新编码本地路径，这些代码点在路径的某个部分无法表示为有效的UTF-8时使用。在实践中，大多数路径都可以无损地编码为UTF-8，但这意味着Wax无法匹配或捕获一些字面字节字符串。

稳定性

在撰写本文时，Wax处于实验性和不稳定状态。在0.y.z系列版本之间，glob表达式语法和语义可能会在不警告和不弃用的情况下发生变化。