安装

Arch Linux

从 AUR 安装 amber-search-git 包。

yaourt -S amber-search-git

Cargo

您可以使用 cargo 进行安装。

cargo install amber

手册

从 发布页面 下载，并将其提取到 PATH 目录中。

用法

提供了两个命令（ambs/ambr）。ambs 表示 "amber 搜索"，而 ambr 表示 "amber 替换"。默认情况下，搜索关键字不是正则表达式。如果想要使用正则表达式，请添加 --regex。

ambs keyword                  // recursively search 'keyword' from the current directory.
ambs keyword path             // recursively search 'keyword' from 'path'.
ambr keyword replacement      // recursively search 'keyword' from the current directory, and replace to 'replacement' interactively.
ambr keyword replacement path // recursively search 'keyword' from 'path', and replace to 'replacement' interactively.

amber 默认以交互式方式替换。如果找到关键字，则显示以下提示并等待。如果输入 'y'、'Y'、'Yes'，则替换关键字。'a'、'A'、'All' 表示非交互式替换所有关键字。

Replace keyword? ( Yes[Y], No[N], All[A], Quit[Q] ):

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

$ 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
• MEM: 1.5TB
• OS : CentOS 7.5

目标数据

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

模式

• pattern1(包含许多匹配的多个文件): 'EXPORT_SYMBOL_GPL' 在 source1 中
• pattern2(包含少量匹配的多个文件): 'irq_bypass_register_producer' 在 source1 中
• pattern3(包含许多匹配的大文件): '検索結果' 在 source2 中
• pattern4(包含少量匹配的大文件): '"Quick Search"' 在 source2 中

比较工具

• 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 )

• 替换 ( compare_ambr.sh )