serpl下载 - serpl源码下载

serpl

其他源码

0.3.3

下载

塞尔普尔

serpl是一个终端用户界面 (TUI) 应用程序，允许用户搜索和替换整个文件夹中的关键字，类似于 VS Code 中提供的功能。

serpl-demo.mp4

特征

在整个项目文件夹中搜索关键字，并提供区分大小写、AST Grep 等选项。
将关键字替换为保留大小写、AST Grep 等选项。
搜索结果的交互式预览。
键盘导航可实现高效的工作流程。
可配置的键绑定和搜索模式。

安装与更新

先决条件

ripgrep 安装在您的系统上。
（可选）如果您想使用 AST Grep 功能，请在您的系统上安装 ast-grep。

步骤

使用 Cargo 安装应用程序：

cargo install serpl

如果要安装具有 AST Grep 功能的应用程序，可以使用以下命令：
```
cargo install serpl --features ast_grep
```

运行应用程序：

serpl

二进制文件

检查发布页面以获取最新的二进制文件。

操作系统特定安装

酿造

serpl可以使用 Homebrew 安装：

brew install serpl

架构Linux

可以使用pacman从官方存储库安装serpl ：

pacman -S serpl

尼克斯/尼克斯操作系统

serpl自 24.11 起包含在 nixpkgs 中，并且可以通过 Nix 以不同方式安装：

在独立 Nix 设置上：

nix profile install nixpkgs#serpl

在 NixOS 上（通过configuration.nix或类似的）：

 { pkgs , ... } : {
  environment . systemPackages = [ pkgs . serpl ] ;
}

在家庭管理器上：

 { pkgs , ... } : {
  home . packages = [ pkgs . serpl ] ;
}

用法

基本命令

在当前目录启动应用程序：
```
serpl
```
启动应用程序并提供项目根路径：
```
serpl --project-root /path/to/project
```

按键绑定

可以通过config.json文件自定义默认键绑定。

默认按键绑定

组合键	行动
`Ctrl + c`	辞职
`Ctrl + b`	帮助
`Tab`	在选项卡之间切换
`Backtab`	切换到上一个选项卡
`Ctrl + o`	处理所有文件的替换
`r`	处理选定文件或行的替换
`Ctrl + n`	切换搜索和替换模式
`Enter`	执行搜索（对于大文件夹）
`g` / `Left` / `h`	转到列表顶部
`G` / `Right` / `l`	转到列表底部
`j` / `Down`	移至下一个项目
`k` / `Up`	移至上一项
`/`	搜索结果列表
`d`	删除选定的文件或行
`Esc`	退出当前窗格或对话框
`Enter` （在对话框中）/ `y`	确认动作
`Esc` （在对话框中）/ `n`	取消操作
`h` 、 `l` 、 `Tab` （在对话框中）	导航对话框选项

配置

serpl使用配置文件来管理按键绑定和其他设置。默认情况下，可以通过运行serpl --version找到配置文件的路径。您可以使用各种文件格式进行配置，例如 JSON、JSON5、YAML、TOML 或 INI。

配置示例

JSON

{
  "keybindings" : {
    "<Ctrl-d>" : " Quit " ,
    "<Ctrl-c>" : " Quit " ,
    "<Tab>" : " LoopOverTabs " ,
    "<Backtab>" : " BackLoopOverTabs " ,
    "<Ctrl-o>" : " ProcessReplace " ,
    "<Ctrl-b>" : " ShowHelp "
  }
}

JSON5

 {
  keybindings : {
    "<Ctrl-d>" : "Quit" ,
    "<Ctrl-c>" : "Quit" ,
    "<Tab>" : "LoopOverTabs" ,
    "<Backtab>" : "BackLoopOverTabs" ,
    "<Ctrl-o>" : "ProcessReplace" ,
    "<Ctrl-b>" : "ShowHelp" ,
  } ,
}

YAML

 keybindings :
  " <Ctrl-d> " : " Quit "
  " <Ctrl-c> " : " Quit "
  " <Tab> " : " LoopOverTabs "
  " <Backtab> " : " BackLoopOverTabs "
  " <Ctrl-o> " : " ProcessReplace "
  " <Ctrl-b> " : " ShowHelp "

TOML

[ keybindings ]
"<Ctrl-d>" = " Quit "
"<Ctrl-c>" = " Quit "
"<Tab>" = " LoopOverTabs "
"<Backtab>" = " BackLoopOverTabs "
"<Ctrl-o>" = " ProcessReplace "
"<Ctrl-b>" = " ShowHelp "

INI

 [keybindings]
<Ctrl-d> = Quit
<Ctrl-c> = Quit
<Tab> = LoopOverTabs
<Backtab> = BackLoopOverTabs
<Ctrl-o> = ProcessReplace
<Ctrl-b> = ShowHelp

您可以通过以您选择的格式修改配置文件来自定义按键绑定。

窗格

搜索输入

用于输入搜索关键字的输入字段。
切换搜索模式（简单、区分大小写、匹配整个单词、匹配大小写整个单词、正则表达式、AST Grep）。
- 简单：搜索所有出现的关键字。
- 大小写匹配：搜索与关键字大小写相同的匹配项。
- 全字匹配：搜索与关键字完全匹配的匹配项。
- 匹配大小写全字：搜索与相同大小写的关键字完全匹配的匹配项。
- 正则表达式：使用正则表达式搜索匹配项。
- AST Grep：使用 AST Grep 搜索出现的情况。

提示

如果当前目录很大，则必须单击Enter才能开始搜索。

替换输入

用于输入替换文本的输入字段。
切换替换模式（简单、保留大小写、AST Grep）。
- 简单：替换所有出现的关键字。
- 保留大小写：替换出现的情况，同时保留关键字的大小写。
- AST Grep：使用 AST Grep 替换出现的内容。

搜索结果面板

包含搜索结果的文件列表。
用于选择和查看文件的导航。
从搜索结果中删除文件的选项。
搜索结果计数和当前文件计数。
能够使用/键搜索列表。

预览面板

显示所选文件以及突出显示的搜索结果和上下文。
导航以查看文件中的不同匹配项。
删除包含匹配项的单个行的选项。

快速提示

使用Ctrl + b组合键显示帮助对话框。
使用Ctrl + o组合键对所有文件进行替换。
使用r键处理所选文件或行的替换。
使用Ctrl + n组合键在搜索和替换模式之间切换。
使用g 、 G 、 j和k键浏览搜索结果。
使用d键删除选定的文件或行。

使用toggleterm 集成 Neovim

查看 Neovim 的toggleterm.nvim 插件，它提供了一个可以通过按键绑定切换的终端。或者，如果您使用 AstroNvim，则可以使用以下配置：

 return {
  " akinsho/toggleterm.nvim " ,
  cmd = { " ToggleTerm " , " TermExec " },
  dependencies = {
    {
      " AstroNvim/astrocore " ,
      opts = function ( _ , opts )
        local maps = opts . mappings
        local astro = require " astrocore "
        maps . n [ " <Leader>t " ] = vim . tbl_get ( opts , " _map_sections " , " t " )

        local serpl = {
          callback = function ()
            astro . toggle_term_cmd " serpl "
          end ,
          desc = " ToggleTerm serpl " ,
        }
        maps . n [ " <Leader>sr " ] = { serpl . callback , desc = serpl . desc }

        maps . n [ " <Leader>tf " ] = { " <Cmd>ToggleTerm direction=float<CR> " , desc = " ToggleTerm float " }
        maps . n [ " <Leader>th " ] = { " <Cmd>ToggleTerm size=10 direction=horizontal<CR> " , desc = " ToggleTerm horizontal split " }
        maps . n [ " <Leader>tv " ] = { " <Cmd>ToggleTerm size=80 direction=vertical<CR> " , desc = " ToggleTerm vertical split " }
        maps . n [ " <F7> " ] = { ' <Cmd>execute v:count . "ToggleTerm"<CR> ' , desc = " Toggle terminal " }
        maps . t [ " <F7> " ] = { " <Cmd>ToggleTerm<CR> " , desc = " Toggle terminal " }
        maps . i [ " <F7> " ] = { " <Esc><Cmd>ToggleTerm<CR> " , desc = " Toggle terminal " }
        maps . n [ " <C-'> " ] = { ' <Cmd>execute v:count . "ToggleTerm"<CR> ' , desc = " Toggle terminal " }
        maps . t [ " <C-'> " ] = { " <Cmd>ToggleTerm<CR> " , desc = " Toggle terminal " }
        maps . i [ " <C-'> " ] = { " <Esc><Cmd>ToggleTerm<CR> " , desc = " Toggle terminal " }
      end ,
    },
  },
  opts = {
    highlights = {
      Normal = { link = " Normal " },
      NormalNC = { link = " NormalNC " },
      NormalFloat = { link = " NormalFloat " },
      FloatBorder = { link = " FloatBorder " },
      StatusLine = { link = " StatusLine " },
      StatusLineNC = { link = " StatusLineNC " },
      WinBar = { link = " WinBar " },
      WinBarNC = { link = " WinBarNC " },
    },
    size = 10 ,
    --- @param t Terminal
    on_create = function ( t )
      vim . opt_local . foldcolumn = " 0 "
      vim . opt_local . signcolumn = " no "
      if t . hidden then
        local toggle = function () t : toggle () end
        vim . keymap . set ({ " n " , " t " , " i " }, " <C-'> " , toggle , { desc = " Toggle terminal " , buffer = t . bufnr })
        vim . keymap . set ({ " n " , " t " , " i " }, " <F7> " , toggle , { desc = " Toggle terminal " , buffer = t . bufnr })
      end
    end ,
    shading_factor = 2 ,
    direction = " float " ,
    float_opts = { border = " rounded " },
  },
}