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 " },
  },
}