---

Ⅰ. 插件描述

Freaky fast fuzzy finder for (denite.nvim/CtrlP matcher) for vim/neovim

Ⅱ. 基本信息

创建日期：  2018-09-27 使用用户：  8 Github星：  110 插件作者：  Raghu

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin 'raghur/fruzzy'

… 然后在Vim中运行以下命令:

:source %
:PluginInstall

对于Vundle版本 < 0.10.2，请用上面的Bundle替换Plugin。

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle 'raghur/fruzzy'

… 然后在Vim中运行以下命令:

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug 'raghur/fruzzy'

… 然后在Vim中运行以下命令:

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/raghur/fruzzy

Ⅳ. 文档说明

# Freaky fast fuzzy Denite/CtrlP matcher for vim/neovim

This is a matcher plugin for https://github.com/Shougo/denite.nvim[denite.nvim]
and https://github.com/ctrlpvim/ctrlp.vim[CtrlP].

Read more at https://blog.rraghur.in/2018/09/27/fruzzy---a-freaky-fast-fuzzy-finder-for-vim/neovim/

Installation

In your .vimrc:

" vim-plug; for other plugin managers, use what's appropriate
" if you don't want to trust a prebuilt binary, skip the 'do' part
" and build the binaries yourself. Instructions are further down
" and place them in the /path/to/plugin/rplugin/python3 folder

Plug 'raghur/fruzzy', {'do': { -> fruzzy#install()}}

" optional - but recommended - see below
let g:fruzzy#usenative = 1

" When there's no input, fruzzy can sort entries based on how similar they are to the current buffer
" For ex: if you're on /path/to/somefile.h, then on opening denite, /path/to/somefile.cpp
" would appear on the top of the list.
" Useful if you're bouncing a lot between similar files.
" To turn off this behavior, set the variable below  to 0

let g:fruzzy#sortonempty = 1 " default value

" tell denite to use this matcher by default for all sources
call denite#custom#source('_', 'matchers', ['matcher/fruzzy'])

" tell CtrlP to use this matcher
let g:ctrlp_match_func = {'match': 'fruzzy#ctrlp#matcher'}
let g:ctrlp_match_current_file = 1 " to include current file in matches

Native modules

Native module gives a 10 - 15x speedup over python - ~40-60μs!. Not that you'd notice
it in usual operation (python impl is at 300 - 600μs)

. Run command :call fruzzy#install() if you're not using vim-plug.
. restart nvim

Manual installation

. Download the module for your platform. If on mac, rename to fruzzy_mod.so
. place in /path/to/fruzzy/rplugin/python3
. Make sure you set the pref to use native module - g:fruzzy#usenative=1
. restart vim/nvim

Troubleshooting/Support

Raise a ticket - please include the following info:

.Get the version
. Start vim/nvim
. Activate denite/ctrlp as the case may be.
. Execute :call fruzzy#version() - this will print one of the following
.. version number and branch - all is good
.. purepy - you're using the pure python version.
.. modnotfound - you requested the native mod with let g:fruzzy#usenative=1 but it could not be loaded
.. outdated - native mod was loaded but it's < v0.3. You can update the native mod from the releases.
. include output of the above

.Describe the issue
. include the list of items
. include your query
. What it did vs what you expected it to do.

Development

.Build native module
. install nim >= 0.19
. dependencies
.. nimble install binaryheap
.. nimble install nimpy
. cd rplugin/python3
. [Windows] nim c --app:lib --out:fruzzy_mod.pyd -d:release -d:removelogger fruzzy_mod
. [Linux] nim c --app:lib --out:fruzzy_mod.so -d:release -d:removelogger fruzzy_mod
. -d:removelogger

- removes all log statements from code.
- When `removelogger` is not defined, only info level logs are emitted
- Debug builds (ie: without `-d:release` flag) also turns on additional debug level logs

.Running tests
. cd rplugin
. pytest - run tests with python implementation
. FUZZY_CMOD=1 pytest - run tests with native module