本文主要介绍一下 glob 库的使用。
glob 库的 pub 仓库地址:glob
1. glob 库的介绍
glob 库提供了文件和目录的通配符规则,它可以帮助我们检查某个 path 路径是否满足我们给定的通配符规则,同时支持列出所有满足通配符条件的文件和目录。
2. 依赖 glob 库
2.1 添加依赖
dependencies:
glob: ^2.0.2
glob 的版本号参考:Stable versions of glob
2.2 导包
import 'package:glob/glob.dart';
3. glob 库的使用
3.1 构造一个 glob
想要创建一个 glob 对象,只需要使用 Glob()
即可。
import 'package:glob/glob.dart';
/// 最好定义为全局变量,方便复用
final dartFile = Glob("**.dart");
3.2 检查是否匹配
检查一个 path 是否满足 Glob 的条件,使用 Glob.matches()
。
import 'package:glob/glob.dart';
final dartFile = Glob("**.dart");
void main(List<String> arguments) {
for (var argument in arguments) {
if (dartFile.matches(argument)) print(argument);
}
}
3.3 列出所有满足条件的文件
可以使用 Glob.list()
或 Glob.listSync()
列出与 glob 匹配的所有文件。
import 'package:glob/glob.dart';
import 'package:glob/list_local_fs.dart';
final dartFile = Glob("**.dart");
// Recursively list all Dart files in the current directory.
void main(List<String> arguments) {
for (var entity in dartFile.listSync()) {
print(entity.path);
}
}
4. glob 库的通配符规则
4.1 匹配当前目录下,文件名中的任意字符:*
例子: lib/*.dart
会匹配 lib/glob.dart
但不会匹配 lib/src/utils.dart
。
4.2 跨目录匹配文件名中的任意字符:**
例子:lib/**.dart
会匹配 lib/glob.dart
和 lib/src/utils.dart
。
如果 **
出现在 glob 的开头,它将不匹配 绝对路径
或以 ../ 开头
的路径。
例如,**.dart
不会匹配 /foo.dart
,但 /**.dart
会匹配。
4.3 匹配任何单个字符:?
这 ?
字符匹配除 /
之外的 单个字符
。 与 *
不同,它不会匹配多于或少于一个字符。
例如, test?.dart
将匹配 test1.dart
但不匹配 test10.dart
或 test.dart
4.4 匹配给定范围内的字符:[...]
匹配几个字符中的一个。它可以包含单个字符,例如 [abc],在这种情况下,它将匹配任何这些字符;
它可以包含范围,例如 [a-zA-Z],在这种情况下,它将匹配范围内的任何字符;或者它可以包含两者的混合。
例如,test[a-zA-Z_].dart
将匹配 testx.dart
、testA.dart
和 test_.dart
,但不匹配 test-.dart
。
如果它以 ^
或 !
开头,则匹配所有 未提及
的字符。例如,test[^a-z].dart
将匹配 test1.dart
但不匹配 testa.dart
。
4.5 匹配几种可能性之一:{...,...}
{...,...}
结构匹配几个选项之一,每个选项本身都是一个 glob。
例如,lib/{*.dart,src/*}
匹配 lib/glob.dart
和 lib/src/data.txt
。 它可以包含任何数量大于一的选项,甚至可以包含嵌套选项。
4.6 转义字符:\
\
字符可以在任何上下文中用于转义一个在语义上有意义的字符。 例如,*.dart
匹配 *.dart
但不匹配 test.dart
。