Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/brooth/far.vim
Find And Replace Vim plugin
https://github.com/brooth/far.vim
neovim vim
Last synced: 3 months ago
JSON representation
Find And Replace Vim plugin
- Host: GitHub
- URL: https://github.com/brooth/far.vim
- Owner: brooth
- License: mit
- Created: 2016-09-16T19:26:54.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-05-14T20:26:10.000Z (9 months ago)
- Last Synced: 2024-08-02T13:35:45.375Z (7 months ago)
- Topics: neovim, vim
- Language: Vim Script
- Homepage:
- Size: 385 KB
- Stars: 902
- Watchers: 14
- Forks: 43
- Open Issues: 26
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-list - far.vim
README
# far.vim - Find And Replace Vim plugin
## Disclaimer
This plugin is completely community-driven. The author has betrayed the pure vim experience and fallen down a slippery slope of using VSCode with a vim plugin. **Please do not raise issues without a PR**, they will be ignored anyway.## Intro
Far.vim makes it easier to find and replace text through multiple files.
It's inspired by fancy IDEs, like IntelliJ and Eclipse, that provide
cozy tools for such tasks.## Installation
#### [vim-plug](https://github.com/junegunn/vim-plug)
```vim
Plug 'brooth/far.vim'
```## Usage
### Searching with Command
```bash
:Far foo bar **/*.py
:Fardo
```
#### :Far {pattern} {replace-with} {file-mask} [params]
Find the text to replace.#### :F {pattern} {file-mask} [params]
Find only.### Searching Interactively
```bash
:Farr foo bar **/*.py
```
#### :Farr [params]
Interactive `Far`. Shows searching modes in the status bar (regex, case sensitive, word boundary, replace). Modes can be toggled by the key mapping it prompted. Allows to enter {pattern}, {replace-with}, and {file-mask} one after the other.#### :Farf [params]
Interactive `F`. The interaction is similar to `Farr`.### Commands in the search result window
#### :Fardo [params]
Runs the replacement task. The shortcut for it is `s` (substitute).#### :Farundo [params]
Undo the recurrent replacement. The shortcut for it is `u` (undo). It is available when setting `let g:far#enable_undo=1`.#### :Refar [params]
Change `Far`/`F`/`Farr`/`Farf` params.### Need help?
```bash
:help far.vim
```## Extras
### Multiline Replacement
### Neovim-Async, Ack, Ag, Ripgrep support
### Command-Line Completion
### Consistency Check
..and many more! Check out `:help far.vim`.
## Troubleshooting
#### Recommented Setting
You can add the following settings to your vim configuration:```vim
set lazyredraw " improve scrolling performance when navigating through large results
set regexpengine=1 " use old regexp engine
set ignorecase smartcase " ignore case only when the pattern contains no capital letters" shortcut for far.vim find
nnoremap :Farf
vnoremap :Farf" shortcut for far.vim replace
nnoremap :Farr
vnoremap :Farr
```## License
MIT