From a5e25cb70208b39aa47b05455c39665908338ce1 Mon Sep 17 00:00:00 2001
From: Wesley Moore <wes@wezm.net>
Date: Thu, 29 Sep 2016 21:33:43 +1000
Subject: [PATCH] Add /technical/2016/09/ripgrep-with-vim

---
 content/technical/2016/09/ripgrep-with-vim.md | 47 +++++++++++++++++++
 .../technical/2016/09/ripgrep-with-vim.yaml   | 15 ++++++
 2 files changed, 62 insertions(+)
 create mode 100644 content/technical/2016/09/ripgrep-with-vim.md
 create mode 100644 content/technical/2016/09/ripgrep-with-vim.yaml

diff --git a/content/technical/2016/09/ripgrep-with-vim.md b/content/technical/2016/09/ripgrep-with-vim.md
new file mode 100644
index 0000000..7b7efd1
--- /dev/null
+++ b/content/technical/2016/09/ripgrep-with-vim.md
@@ -0,0 +1,47 @@
+[ripgrep][rg] (`rg`) is a new text search tool by [Andrew Gallant][BurntSushi]:
+
+> ripgrep combines the usability of [The Silver Searcher][ag] (an [ack] clone)
+> with the raw performance of [GNU grep][grep]. ripgrep is fast, cross platform
+> (with binaries available for Linux, Mac and Windows) and written in
+> [Rust][rust].
+
+[BurntSushi]: http://blog.burntsushi.net/about/
+[ack]: http://beyondgrep.com/
+[ag]: https://github.com/ggreer/the_silver_searcher
+[grep]: https://www.gnu.org/software/grep/
+[rg]: https://github.com/BurntSushi/ripgrep
+[rgbench]: http://blog.burntsushi.net/ripgrep/
+[rust]: https://www.rust-lang.org/
+
+Andrew has written in [extensive detail on the benchmarking][rgbench] he did,
+which shows `ripgrep` is one of the fastest and most correct tools of this
+nature. To make use of `ripgrep` within vim here are a few options:
+
+Set [grepprg](http://vimdoc.sourceforge.net/htmldoc/options.html#'grepprg'),
+which is used by [:grep][colon-grep] to search a project and add the matches
+the quickfix list:
+
+    if executable("rg")
+        set grepprg=rg\ --vimgrep\ --no-heading
+        set grepformat=%f:%l:%c:%m,%f:%l:%m
+    endif
+
+[colon-grep]: http://vimdoc.sourceforge.net/htmldoc/quickfix.html#:grep
+
+For use with [ack.vim](https://github.com/mileszs/ack.vim) set `g:ackprg` as
+follows. Now when you run `:Ack` it will use `rg` instead:
+
+    let g:ackprg = 'rg --vimgrep --no-heading'
+
+One of my favourite plugins, [fzf.vim](https://github.com/junegunn/fzf.vim) has
+built-in support for `ag`. I've created an [experimental fork][fork] that adds
+support for `rg` to it.  My fork adds the `:Rg` user command, which works the
+same was as the existing `:Ag` command.  To use my version of the plugin with
+[vim-plug] add the following to your `.vimrc`:
+
+    Plug 'wezm/fzf.vim', { 'branch': 'rg' }
+
+The line will be similar in Vundle or pathogen.
+
+[fork]: https://github.com/wezm/fzf.vim/tree/rg
+[vim-plug]: https://github.com/junegunn/vim-plug
diff --git a/content/technical/2016/09/ripgrep-with-vim.yaml b/content/technical/2016/09/ripgrep-with-vim.yaml
new file mode 100644
index 0000000..3a711c6
--- /dev/null
+++ b/content/technical/2016/09/ripgrep-with-vim.yaml
@@ -0,0 +1,15 @@
+---
+title: Using ripgrep With Vim
+extra: A few ways to use the ripgrep text search tool within vim.
+kind: article
+section: technical
+created_at: 2016-09-28 13:46:00.000000000 +10:00
+keywords:
+- ack
+- ag
+- productivity
+- ripgrep
+- rust
+- tools
+- vim
+short_url: