This plugin is mainly used for locating files, buffers, mrus, tags in large project.

• Written in Python.
• Support fuzzy and regex searching.
• Manage buffers and mrus.
• Open multiple files at once.
• Extensible.

• vim7.3 or higher. Only support vim7.4.330 or higher after v1.01.
• vim compiled with Python support, you can check by using echo has('python') or echo has('python3') to see if the result is 1; Make sure that your python2 version is Python 2.7 or higher and python3 version is Python 3.1 or higher.

To install this plugin just put the plugin files in your ~/.vim (Linux) or ~/vimfiles (Windows).
For Vundle user, just add Plugin 'Yggdroot/LeaderF' to your .vimrc.

LeaderF is already very fast. If you want better performance, install the C extension of the fuzzy matching algorithm, which is more than 10 times faster.
To install the C extension, follow the below:

• On Linux/Unix/MacOS:

  First, make sure python2 and/or python3 commands are available.
  Then run the installation script:

  cd ~/.vim/bundle/LeaderF
  ./install.sh

  Uninstall the C extension:

   ./install.sh --reverse
  

  If you are using vim-plug:

   Plug 'Yggdroot/LeaderF', { 'do': './install.sh' }
  

• On Windows:

  First, make sure py -2 and/or py -3 commands are available.
  Then run the installation script:

  cd ~\.vim\bundle\LeaderF
  .\install.bat

  There may be some error during the installation, please google the error messages to resolve it.
  For example, "error: Unable to find vcvarsall.bat", you can turn to here for help.

  Uninstall the C extension:

   .\install.bat --reverse
  

  If you are using vim-plug:

   Plug 'Yggdroot/LeaderF', { 'do': '.\install.bat' }
  

After running any command of LeaderF, check the value of echo g:Lf_fuzzyMatch_C, if the value is 1, it means the C extension is loaded sucessfully.

usage: Leaderf[!] [-h] [--reverse] [--stayOpen] [--input INPUT | --cword]
                  [--top | --bottom | --left | --right | --belowright | --aboveleft | --fullScreen]
                  [--nameOnly | --fullPath | --fuzzy | --regex]
                  {file,tag,function,mru,searchHistory,cmdHistory,help,line,colorscheme,self,bufTag,buffer}
                  ...

optional arguments:
  -h, --help            show this help message and exit
  --reverse             show results in bottom-up order
  --stayOpen            don't quit LeaderF after accepting an entry
  --input INPUT         specifies INPUT as the pattern inputted in advance
  --cword               current word under cursor is inputted in advance
  --top                 the LeaderF window is at the top of the screen
  --bottom              the LeaderF window is at the bottom of the screen
  --left                the LeaderF window is at the left of the screen
  --right               the LeaderF window is at the right of the screen
  --belowright          the LeaderF window is at the belowright of the screen
  --aboveleft           the LeaderF window is at the aboveleft of the screen
  --fullScreen          the LeaderF window takes up the full screen
  --nameOnly            LeaderF is in NameOnly mode by default
  --fullPath            LeaderF is in FullPath mode by default
  --fuzzy               LeaderF is in Fuzzy mode by default
  --regex               LeaderF is in Regex mode by default

subcommands:

  {file,tag,function,mru,searchHistory,cmdHistory,help,line,colorscheme,self,bufTag,buffer}
    file                search files
    tag                 navigate tags using the tags file
    function            navigate functions or methods in the buffer
    mru                 search most recently used files
    searchHistory       execute the search command in the history
    cmdHistory          execute the command in the history
    help                navigate the help tags
    line                search a line in the buffer
    colorscheme         switch between colorschemes
    self                execute the commands of itself
    bufTag              navigate tags in the buffer
    buffer              search buffers

If [!] is given, enter normal mode directly.

use :Leaderf <subcommand> -h to get specific help of subcommand, e.g., :Leaderf mru -h

usage: Leaderf[!] mru [-h] [--cwd] [--reverse] [--stayOpen]
                      [--input INPUT | --cword]
                      [--top | --bottom | --left | --right | --belowright | --aboveleft | --fullScreen]
                      [--nameOnly | --fullPath | --fuzzy | --regex]

optional arguments:
  -h, --help     show this help message and exit

specific arguments:
  --cwd          search MRU in current working directory

common arguments:
  --reverse      show results in bottom-up order
  --stayOpen     don't quit LeaderF after accepting an entry
  --input INPUT  specifies INPUT as the pattern inputted in advance
  --cword        current word under cursor is inputted in advance
  --top          the LeaderF window is at the top of the screen
  --bottom       the LeaderF window is at the bottom of the screen
  --left         the LeaderF window is at the left of the screen
  --right        the LeaderF window is at the right of the screen
  --belowright   the LeaderF window is at the belowright of the screen
  --aboveleft    the LeaderF window is at the aboveleft of the screen
  --fullScreen   the LeaderF window takes up the full screen
  --nameOnly     LeaderF is in NameOnly mode by default
  --fullPath     LeaderF is in FullPath mode by default
  --fuzzy        LeaderF is in Fuzzy mode by default
  --regex        LeaderF is in Regex mode by default

If [!] is given, enter normal mode directly.

Once LeaderF is launched:

Input formats:

• In NameOnly mode (fuzzy mode)

  If the first character you input is ';', then the searching will be the same as in FullPath mode.
  If you input string as 'abc;def', then 'abc' will match the file name and 'def' will match the directory name.

• In FullPath mode (fuzzy mode)

  Same as in NameOnly mode except that the pattern will match the full path but not the file name only.

• In Regexp mode

  The input string is the same as the Vim's regexp.

Smart Case:

• If the characters in search pattern are all lowercase, the matching is case-insensitive. If the search pattern contains uppercase characters, all lowercase characters still are matched case-insensitively, the uppercase characters can only match upper case. So uppercase characters can speed up the narrowing down of the searching result.

  e.g., input abcDef，it can match the following strings:

  abcDef
  AbcDef
  abcDEf
  aBcDeF
  

  but can not match the strings such as:

  abcdef
  Abcdef
  

  Note: abc and ef are still case-insensitive.

And operator:

• In fuzzy mode, using ' '(space) as the and operator, the candidate lines should fuzzily match all the substrings separated by space.

  e.g., input abc def gh，it can match the following strings:

  ...a.b.c...d.e.f...g.h...
  ...a.b.c...g.h...d.e.f...
  ...a.d..e.g.b.c...h..f...
  ...gh...def...abc...
  

• Change key bindings

  By default, <Tab> is the shortcut key to switch to normal mode, if you want to change the key into <ESC>:

  let g:Lf_CommandMap = {'<Tab>': ['<ESC>']}

  for more detail, please refer to here.

• Customize the statusline

  Please refer to here.

• Change the highlight of matched string

  highlight Lf_hl_match gui=bold guifg=Blue cterm=bold ctermfg=21
  highlight Lf_hl_matchRefine  gui=bold guifg=Magenta cterm=bold ctermfg=201

• Change the default mapping of searching files command

  e.g. let g:Lf_ShortcutF = '<C-P>'

This plugin is released under the Apache License, Version 2.0 (the "License").