amber

amber 是一个用 Rust 编写的代码搜索和替换工具。这个工具的灵感来自 ack、 ag 和其他类似 grep 的工具。

特性

实用的默认设置

从当前目录递归搜索
忽略版本控制系统目录（.git、.hg、.svn、.bzr）
忽略二进制文件
以彩色格式输出

多线程搜索

大文件（默认 > 1MB）会被分割并并行搜索。

交互式替换

amber 可以在多个目录中替换关键词（传统方式是使用 find ... | xargs sed -i '...'）。您可以交互式地决定是否进行替换。

安装

Arch Linux

从 AUR 安装 amber-search-git 包。

yay -S amber-search-git

Cargo

您可以使用 cargo 安装。

cargo install amber

手动安装

从发布页面下载，并解压到 PATH 中的目录。

使用方法

提供了两个命令（ambs/ambr）。ambs 表示 "amber search"，ambr 表示 "amber replace"。默认情况下，搜索关键词不是正则表达式。如果您想使用正则表达式，请添加 --regex 选项。

ambs 关键词                   // 从当前目录递归搜索 '关键词'。
ambs 关键词 路径              // 从 '路径' 递归搜索 '关键词'。
ambr 关键词 替换内容          // 从当前目录递归搜索 '关键词'，并交互式地替换为 '替换内容'。
ambr 关键词 替换内容 路径     // 从 '路径' 递归搜索 '关键词'，并交互式地替换为 '替换内容'。

amber 默认进行交互式替换。如果找到关键词，会显示以下提示并等待输入。如果您输入 'y'、'Y'、'Yes'，关键词将被替换。'a'、'A'、'All' 表示非交互式地替换所有关键词。

替换关键词？（是[Y]，否[N]，全部[A]，退出[Q]）：

如果启用了 --regex 选项，可以在 ambr 的 替换内容 中使用正则表达式捕获。

$ cat text.txt
aaa bbb
$ ambr --no-interactive --regex '(aaa) (?<pat>bbb)' '$1 $pat ${1} ${pat}' test.txt
$ cat text.txt
aaa bbb aaa bbb

配置

配置文件路径

您可以通过编写配置文件来更改配置。配置文件的位置因操作系统而异：

Linux: ~/.config/amber/ambs.toml、/etc/amber/ambs.toml
macOS: ~/Library/Preferences/com.github.dalance.amber/ambs.toml、/etc/amber/ambs.toml
Windows: ~/AppData/Roaming/dalance/amber/config/ambs.toml

为了兼容性，如果 ~/.ambs.toml 存在，它将优先于特定操作系统的位置。

上述路径是 ambs 命令配置的示例。同一目录下的 ambr.toml 用于 ambr 命令。

可配置的值

可用条目和默认值如下：

regex          = false
column         = false
row            = false
binary         = false
statistics     = false
skipped        = false
interactive    = true
recursive      = true
symlink        = true
color          = true
file           = true
skip_vcs       = true
skip_gitignore = true
fixed_order    = true
parent_ignore  = true
line_by_match  = false

你可以选择一些条目来覆盖，如下所示：

column = true

基准测试

环境

CPU: Intel(R) Xeon(R) Gold 6134 CPU @ 3.20GHz
内存: 1.5TB
操作系统: CentOS 7.5

目标数据

源1: https://github.com/torvalds/linux ( 52998个文件，2.2GB )
源2: https://dumps.wikimedia.org/jawiki/latest/jawiki-latest-pages-articles.xml.bz2 ( 1个文件，8.5GB )

模式

模式1( 多个文件有多个匹配 ): 在源1中搜索 'EXPORT_SYMBOL_GPL'
模式2( 多个文件有少量匹配 ): 在源1中搜索 'irq_bypass_register_producer'
模式3( 一个大文件有多个匹配 ): 在源2中搜索 '検索結果'
模式4( 一个大文件有少量匹配 ): 在源2中搜索 '"Quick Search"'

比较工具

amber (v0.5.1)
ripgrep (v0.10.0)
grep (v2.20)
fastmod (v0.2.0)
find/sed (v4.5.11/v4.2.2)

基准测试工具

hyperfine，使用以下选项：

--warmup 3: 将所有数据加载到内存中。

结果

搜索 ( compare_ambs.sh )

模式	amber	ripgrep	grep
1	212.8ms ( 139% )	154.1ms ( 100% )	685.2ms ( 448% )
2	199.7ms ( 132% )	151.6ms ( 100% )	678.7ms ( 448% )
3	1.068s ( 100% )	4.642s ( 434% )	3.869s ( 362% )
4	1.027s ( 100% )	4.409s ( 429% )	3.118s ( 304% )

替换 ( compare_ambr.sh )

| 模式 | amber | fastmod | find/sed | | 1 | 792.2毫秒 (100%) | 1231毫秒 (155%) | 155724毫秒 (19657%) | | 2 | 418.1毫秒 (119%) | 352.4毫秒 (100%) | 157396毫秒 (44663%) | | 3 | 18.390秒 (100%) | 74.282秒 (404%) | 639.740秒 (3479%) | | 4 | 17.777秒 (100%) | 74.204秒 (417%) | 625.756秒 (3520%) |