Update mru.vim.
This commit is contained in:
Kurtis Moxley
parent
85e39a618a
commit
2538a00dff
|
|
@ -0,0 +1,39 @@
|
|||
name: coverage
|
||||
on: [push, pull_request]
|
||||
jobs:
|
||||
linux:
|
||||
name: linux
|
||||
runs-on: ubuntu-18.04
|
||||
steps:
|
||||
- name: Checkout Code
|
||||
uses: actions/checkout@v2
|
||||
- name: Run Tests
|
||||
run: |
|
||||
uname -a
|
||||
export MRU_PROFILE=1
|
||||
export VIMPRG=vim
|
||||
$VIMPRG --version
|
||||
cd ./test
|
||||
./run_mru_tests.sh
|
||||
- name: Install Python
|
||||
uses: actions/setup-python@v2
|
||||
with:
|
||||
python-version: 3.5
|
||||
- name: Install covimerage
|
||||
run: |
|
||||
pip install covimerage
|
||||
covimerage --version
|
||||
- name: Run covimerage
|
||||
run: |
|
||||
cd ./test
|
||||
covimerage write_coverage mru_profile.txt
|
||||
- name: Take coverage
|
||||
run: |
|
||||
cd ./test
|
||||
coverage report
|
||||
coverage xml
|
||||
- name: Upload coverage to codecov
|
||||
uses: codecov/codecov-action@v2
|
||||
with:
|
||||
token: ${{ secrets.CODECOV_TOKEN }}
|
||||
file: ./test/coverage.xml
|
||||
|
|
@ -0,0 +1,66 @@
|
|||
name: unit-tests
|
||||
on: [push, pull_request]
|
||||
jobs:
|
||||
linux:
|
||||
name: linux
|
||||
runs-on: ubuntu-latest
|
||||
strategy:
|
||||
matrix:
|
||||
vim:
|
||||
- nightly
|
||||
- v8.2.0000
|
||||
- v8.1.0000
|
||||
- v8.0.0000
|
||||
- v7.4
|
||||
steps:
|
||||
- name: Checkout Code
|
||||
uses: actions/checkout@v2
|
||||
- name: Setup Vim
|
||||
uses: rhysd/action-setup-vim@v1
|
||||
id: vim
|
||||
with:
|
||||
version: ${{ matrix.vim }}
|
||||
- name: Run Tests
|
||||
run: |
|
||||
uname -a
|
||||
export VIMPRG=${{ steps.vim.outputs.executable }}
|
||||
$VIMPRG --version
|
||||
cd test
|
||||
./run_mru_tests.sh
|
||||
windows:
|
||||
name: windows
|
||||
runs-on: windows-latest
|
||||
steps:
|
||||
- uses: actions/checkout@v2
|
||||
- name: Download Vim
|
||||
shell: PowerShell
|
||||
run: Invoke-WebRequest -Uri https://github.com/vim/vim-win32-installer/releases/download/v8.2.2488/gvim_8.2.2488_x64.zip -OutFile vim.zip
|
||||
- name: Extract vim
|
||||
shell: PowerShell
|
||||
run: Expand-Archive -Path vim.zip -DestinationPath $env:USERPROFILE
|
||||
- name: Run Tests
|
||||
run: |
|
||||
$env:PATH = $env:PATH + ';' + $env:USERPROFILE + '\vim\vim82'
|
||||
Get-ComputerInfo -Property Windows*
|
||||
vim --version
|
||||
cd test
|
||||
.\run_mru_tests.cmd
|
||||
neovim-linux:
|
||||
name: neovim-linux
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- name: Checkout Code
|
||||
uses: actions/checkout@v2
|
||||
- name: Setup Neovim
|
||||
uses: rhysd/action-setup-vim@v1
|
||||
id: vim
|
||||
with:
|
||||
version: stable
|
||||
neovim: true
|
||||
- name: Run Tests
|
||||
run: |
|
||||
uname -a
|
||||
export VIMPRG=${{ steps.vim.outputs.executable }}
|
||||
$VIMPRG --version
|
||||
cd test
|
||||
./run_mru_tests.sh
|
||||
|
|
@ -0,0 +1,2 @@
|
|||
doc/tags
|
||||
test/results.txt
|
||||
|
|
@ -0,0 +1,20 @@
|
|||
License: MIT License
|
||||
Copyright (c) 2003-2021 Yegappan Lakshmanan
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to
|
||||
deal in the Software without restriction, including without limitation the
|
||||
rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
|
||||
sell copies of the Software, and to permit persons to whom the Software is
|
||||
furnished to do so, subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be included in
|
||||
all copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
|
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
|
||||
IN THE SOFTWARE.
|
||||
|
|
@ -1,192 +0,0 @@
|
|||
This is a mirror of http://www.vim.org/scripts/script.php?script_id=521
|
||||
|
||||
Overview
|
||||
|
||||
The Most Recently Used (MRU) plugin provides an easy access to a list of
|
||||
recently opened/edited files in Vim. This plugin automatically stores the
|
||||
file names as you open/edit them in Vim.
|
||||
|
||||
This plugin will work on all the platforms where Vim is supported. This
|
||||
plugin will work in both console and GUI Vim. This version of the MRU
|
||||
plugin needs Vim 7.0 and above. If you are using an earlier version of
|
||||
Vim, then you should use an older version of the MRU plugin.
|
||||
|
||||
The recently used filenames are stored in a file specified by the Vim
|
||||
MRU_File variable.
|
||||
|
||||
The Github repository for the MRU plugin is available at:
|
||||
|
||||
http://github.com/yegappan/mru
|
||||
|
||||
Usage
|
||||
|
||||
To list and edit files from the MRU list, you can use the ":MRU" command.
|
||||
The ":MRU" command displays the MRU file list in a temporary Vim window. If
|
||||
the MRU window is already opened, then the MRU list displayed in the window
|
||||
is refreshed.
|
||||
|
||||
If you are using GUI Vim, then the names of the recently edited files are
|
||||
added to the "File->Recent Files" menu. You can select the name of a file
|
||||
from this sub-menu to edit the file.
|
||||
|
||||
You can use the normal Vim commands to move around in the MRU window. You
|
||||
cannot make changes in the MRU window.
|
||||
|
||||
You can select a file name to edit by pressing the <Enter> key or by double
|
||||
clicking the left mouse button on a file name. The selected file will be
|
||||
opened. If the file is already opened in a window, the cursor will be moved
|
||||
to that window. Otherwise, the file is opened in the previous window. If the
|
||||
previous window has a modified buffer or is the preview window or is used by
|
||||
some other plugin, then the file is opened in a new window.
|
||||
|
||||
You can press the 'o' key to open the file name under the cursor in the
|
||||
MRU window in a new window. You can also press <Shift-Enter> instead of 'o'
|
||||
to open the file in a new window.
|
||||
|
||||
To open a file from the MRU window in read-only mode (view), press the 'v'
|
||||
key.
|
||||
|
||||
To open a file from the MRU window in a new tab, press the 't' key. If the
|
||||
file is already opened in a window in the current or in another tab, then
|
||||
the cursor is moved to that tab. Otherwise, a new tab is opened.
|
||||
|
||||
You can open multiple files from the MRU window by specifying a count before
|
||||
pressing '<Enter>' or 'v' or 'o' or 't'. You can also visually (using
|
||||
linewise visual mode) select multiple filenames and invoke the commands to
|
||||
open the files. Each selected file will be opened in a separate window or
|
||||
tab.
|
||||
|
||||
You can press the 'u' key in the MRU window to update the file list. This is
|
||||
useful if you keep the MRU window open always.
|
||||
|
||||
You can close the MRU window by pressing the 'q' key or the <Esc> key or
|
||||
using one of the Vim window commands.
|
||||
|
||||
To display only files matching a pattern from the MRU list in the MRU
|
||||
window, you can specify a pattern to the ":MRU" command. For example, to
|
||||
display only file names matching "vim" in them, you can use the following
|
||||
command ":MRU vim". When you specify a partial file name and only one
|
||||
matching filename is found, then the ":MRU" command will edit that file.
|
||||
|
||||
The ":MRU" command supports command-line completion of file names from
|
||||
the MRU list. You can enter a partial file name and then press <Tab>
|
||||
or <Ctrl-D> to complete or list all the matching file names. Note that
|
||||
after typing the ":MRU" command, you have to enter a space before completing
|
||||
the file names with <Tab>.
|
||||
|
||||
When a file supplied to the ":MRU" command is not present in the MRU list,
|
||||
but it is a readable file, then the file will be opened (even though it is
|
||||
not present in the MRU list). This is useful if you want to open a file
|
||||
present in the same directory as a file in the MRU list. You can use the
|
||||
command-line completion of the ":MRU" command to complete the full path of a
|
||||
file and then modify the path to open another file present in the same path.
|
||||
|
||||
Whenever the MRU list changes, the MRU file is updated with the latest MRU
|
||||
list. When you have multiple instances of Vim running at the same time, the
|
||||
latest MRU list will show up in all the instances of Vim.
|
||||
|
||||
The MRUFilename syntax group is used to highlight the file names in the MRU
|
||||
window. By default, this syntax group is linked to the Identifier highlight
|
||||
group. You can change the highlight group by adding the following line in
|
||||
your .vimrc:
|
||||
|
||||
highlight link MRUFileName LineNr
|
||||
|
||||
The MRU buffer uses the 'mru file type. You can use this file type to add
|
||||
custom auto commands, syntax highlighting, etc.
|
||||
|
||||
Configuration
|
||||
|
||||
By changing the following variables you can configure the behavior of this
|
||||
plugin. Set the following variables in your .vimrc file using the 'let'
|
||||
command.
|
||||
|
||||
The list of recently edited file names is stored in the file specified by the
|
||||
MRU_File variable. The default setting for this variable is
|
||||
$HOME/.vim_mru_files for Unix-like systems and $USERPROFILE/_vim_mru_files
|
||||
for MS-Windows systems. You can change this variable to point to a file by
|
||||
adding the following line to the .vimrc file:
|
||||
|
||||
let MRU_File = 'd:\myhome\_vim_mru_files'
|
||||
|
||||
By default, the plugin will remember the names of the last 100 used files.
|
||||
As you edit more files, old file names will be removed from the MRU list.
|
||||
You can set the 'MRU_Max_Entries' variable to remember more file names. For
|
||||
example, to remember 1000 most recently used file names, you can use
|
||||
|
||||
let MRU_Max_Entries = 1000
|
||||
|
||||
By default, all the edited file names will be added to the MRU list. If you
|
||||
want to exclude file names matching a list of patterns, you can set the
|
||||
MRU_Exclude_Files variable to a list of Vim regular expressions. By default,
|
||||
this variable is set to an empty string. For example, to not include files
|
||||
in the temporary (/tmp, /var/tmp and d:\temp) directories, you can set the
|
||||
MRU_Exclude_Files variable to
|
||||
|
||||
let MRU_Exclude_Files = '^/tmp/.*\|^/var/tmp/.*' " For Unix
|
||||
let MRU_Exclude_Files = '^c:\\temp\\.*' " For MS-Windows
|
||||
|
||||
The specified pattern should be a Vim regular expression pattern.
|
||||
|
||||
If you want to add only file names matching a set of patterns to the MRU
|
||||
list, then you can set the MRU_Include_Files variable. This variable should
|
||||
be set to a Vim regular expression pattern. For example, to add only .c and
|
||||
.h files to the MRU list, you can set this variable as below:
|
||||
|
||||
let MRU_Include_Files = '\.c$\|\.h$'
|
||||
|
||||
By default, MRU_Include_Files is set to an empty string and all the edited
|
||||
filenames are added to the MRU list.
|
||||
|
||||
The default height of the MRU window is 8. You can set the MRU_Window_Height
|
||||
variable to change the window height.
|
||||
|
||||
let MRU_Window_Height = 15
|
||||
|
||||
By default, when the :MRU command is invoked, the MRU list will be displayed
|
||||
in a new window. Instead, if you want the MRU plugin to reuse the current
|
||||
window, then you can set the 'MRU_Use_Current_Window' variable to one.
|
||||
|
||||
let MRU_Use_Current_Window = 1
|
||||
|
||||
The MRU plugin will reuse the current window. When a file name is selected,
|
||||
the file is also opened in the current window.
|
||||
|
||||
When you select a file from the MRU window, the MRU window will be
|
||||
automatically closed and the selected file will be opened in the previous
|
||||
window. You can set the 'MRU_Auto_Close' variable to zero to keep the MRU
|
||||
window open.
|
||||
|
||||
let MRU_Auto_Close = 0
|
||||
|
||||
If you don't use the "File->Recent Files" menu and want to disable it,
|
||||
then you can set the 'MRU_Add_Menu' variable to zero. By default, the
|
||||
menu is enabled.
|
||||
|
||||
let MRU_Add_Menu = 0
|
||||
|
||||
If too many file names are present in the MRU list, then updating the MRU
|
||||
menu to list all the file names makes Vim slow. To avoid this, the
|
||||
MRU_Max_Menu_Entries variable controls the number of file names to show in
|
||||
the MRU menu. By default, this is set to 10. You can change this to show
|
||||
more entries in the menu.
|
||||
|
||||
let MRU_Max_Menu_Entries = 20
|
||||
|
||||
If many file names are present in the MRU list, then the MRU menu is split
|
||||
into sub-menus. Each sub-menu contains MRU_Max_Submenu_Entries file names.
|
||||
The default setting for this is 10. You can change this to increase the
|
||||
number of file names displayed in a single sub-menu:
|
||||
|
||||
let MRU_Max_Submenu_Entries = 15
|
||||
|
||||
In the MRU window, the filenames are displayed in two parts. The first part
|
||||
contains the file name without the path and the second part contains the
|
||||
full path to the file in parenthesis. This format is controlled by the
|
||||
MRU_Filename_Format variable. If you prefer to change this to some other
|
||||
format, then you can modify the MRU_Filename_Format variable. For example,
|
||||
to display the full path without splitting it, you can set this variable
|
||||
as shown below:
|
||||
|
||||
let MRU_Filename_Format={'formatter':'v:val', 'parser':'.*'}
|
||||
|
||||
|
|
@ -0,0 +1,61 @@
|
|||
 
|
||||
|
||||
# Most Recently Used (MRU) Vim plugin
|
||||
|
||||
The Most Recently Used (MRU) plugin provides an easy access to a list of
|
||||
recently opened/edited files in Vim. This plugin automatically stores the
|
||||
file names as you open/edit them in Vim.
|
||||
|
||||
This plugin works with both Vim and Neovim and will work on all the platforms
|
||||
where Vim/Neovim are supported. This plugin will work in both console and GUI
|
||||
Vim. This version of the MRU plugin needs Vim 7.0 and above.
|
||||
|
||||
## Installation
|
||||
|
||||
You can install this plugin by downloading the .zip or the .tar.gz file for the latest MRU release from the following page:
|
||||
|
||||
https://github.com/yegappan/mru/releases/latest
|
||||
|
||||
For Vim 8.0 and above, you can expand the .zip file in the following directory (on Unix/Linux/MacOS systems):
|
||||
|
||||
$ mkdir -p $HOME/.vim/pack/downloads/start/mru
|
||||
$ cd $HOME/.vim/pack/downloads/start/mru
|
||||
$ unzip <downloaded_mru_file.zip>
|
||||
|
||||
For Vim 7.4 and before, you can use the following steps (on Unix/Linux/MacOS systems):
|
||||
|
||||
$ mkdir $HOME/.vim
|
||||
$ cd $HOME/.vim
|
||||
$ unzip <downloaded_mru_file.zip>
|
||||
|
||||
You can also install this plugin directly from github using the following steps (for Vim 8.0 and above):
|
||||
|
||||
$ mkdir -p $HOME/.vim/pack/downloads/start/mru
|
||||
$ cd $HOME/.vim/pack/downloads/start/mru
|
||||
$ git clone https://github.com/yegappan/mru
|
||||
|
||||
For NeoVim:
|
||||
|
||||
$ mkdir -p $HOME/.config/nvim/pack/downloads/start/mru
|
||||
$ cd $HOME/.config/nvim/pack/downloads/start/mru
|
||||
$ git clone https://github.com/yegappan/mru
|
||||
|
||||
or you can use any one of the Vim plugin managers ([vim-plug](https://github.com/junegunn/vim-plug), [dein.vim](https://github.com/Shougo/dein.vim), [pathogen](https://github.com/tpope/vim-pathogen), [minpac](https://github.com/k-takata/minpac), [vam](https://github.com/MarcWeber/vim-addon-manager), [volt](https://github.com/vim-volt/volt), [Vundle](https://github.com/VundleVim/Vundle.vim), etc.) to install and manage this plugin.
|
||||
|
||||
## Usage
|
||||
After the plugin is installed, it will automatically start to record the names of all the recently used files in the `$HOME/.vim_mru_files` text file.
|
||||
|
||||
To open a file from the recently used file list, enter the following command:
|
||||
|
||||
:MRU
|
||||
|
||||
This will open a temporary window with the list of file names in the MRU list where you can press `<Enter>` to open a file.
|
||||
|
||||
You can fuzzy search a text in the list of file names, by passing a search text to the `:MRU` command:
|
||||
|
||||
:MRU <search_text>
|
||||
|
||||
This will open the MRU window with only the file names fuzzy matching the supplied search string.
|
||||
|
||||
The user manual is available at:
|
||||
https://github.com/yegappan/mru/wiki/User-Manual
|
||||
|
|
@ -0,0 +1,450 @@
|
|||
*mru.txt* Plugin for accessing most recently used files
|
||||
|
||||
Author: Yegappan Lakshmanan (yegappan AT yahoo DOT com)
|
||||
For Vim version 7.0 and above
|
||||
Last change: January 13, 2022
|
||||
|
||||
==============================================================================
|
||||
*mru-license*
|
||||
License: MIT License
|
||||
Copyright (c) 2003-2021 Yegappan Lakshmanan
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to
|
||||
deal in the Software without restriction, including without limitation the
|
||||
rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
|
||||
sell copies of the Software, and to permit persons to whom the Software is
|
||||
furnished to do so, subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be included in
|
||||
all copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
|
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
|
||||
IN THE SOFTWARE.
|
||||
==============================================================================
|
||||
CONTENTS~
|
||||
|
||||
1. Overview |mru-overview|
|
||||
2. Installation |mru-installation|
|
||||
3. Usage |mru-usage|
|
||||
4. Configuration |mru-configuration|
|
||||
5. FZF Integration |mru-fzf|
|
||||
|
||||
==============================================================================
|
||||
1. Overview *mru-overview*
|
||||
|
||||
The Most Recently Used (MRU) plugin provides an easy access to a list of
|
||||
recently opened/edited files in Vim. This plugin automatically stores the
|
||||
file names as you open/edit them in Vim.
|
||||
|
||||
This plugin works with both Vim and Neovim and will work on all the platforms
|
||||
where Vim/Neovim are supported. This plugin will work in both console and GUI
|
||||
Vim. This version of the MRU plugin needs Vim 7.0 and above.
|
||||
|
||||
The recently used filenames are stored in a file specified by the Vim
|
||||
MRU_File variable.
|
||||
|
||||
The Github repository for the MRU plugin is available at:
|
||||
|
||||
https://github.com/yegappan/mru
|
||||
|
||||
==============================================================================
|
||||
2. Installation *mru-installation*
|
||||
|
||||
You can use any one of the Vim plugin managers (dein.vim, pathogen, vam,
|
||||
vim-plug, volt, Vundle, etc.) to install and manage this plugin.
|
||||
|
||||
Alternatively, you can also manually download and install the plugin
|
||||
using the following steps.
|
||||
|
||||
1. Download the mru.zip file from https://github.com/yegappan/mru/releases
|
||||
2. Unzip the mru.zip file into the $HOME/.vim directory for Linux/MacOS/Unix
|
||||
systems or the $HOMEPATH/vimfiles directory for MS-Windows. After this
|
||||
step, you should have the following files (the directory structure should
|
||||
be preserved):
|
||||
|
||||
plugin/mru.vim - MRU plugin
|
||||
doc/mru.txt - documentation (help) file
|
||||
|
||||
3. Start Vim and run the ":helptags ALL" command to process the help file.
|
||||
Without this step, you cannot jump to the MRU help topics.
|
||||
4. Restart Vim.
|
||||
5. You can use the |:MRU| command to list and edit the recently used files.
|
||||
In GUI Vim, you can use the 'File->Recent Files' menu to access the
|
||||
recently used files.
|
||||
|
||||
To uninstall the MRU plugin, either use the uninstall command provided by the
|
||||
plugin manager or manually remove the plugin/mru.vim, and doc/mru.txt
|
||||
files from either the $HOME/.vim or $HOME/vimfiles directory.
|
||||
|
||||
You can also install the latest version of the plugin directly from github
|
||||
using the following steps (in Vim 8.0 and above): >
|
||||
|
||||
$ mkdir -p $HOME/.vim/pack/downloads/start/mru
|
||||
$ cd $HOME/.vim/pack/downloads/start/mru
|
||||
$ git clone https://github.com/yegappan/mru.git
|
||||
<
|
||||
For Neovim: >
|
||||
|
||||
$ mkdir -p $HOME/.config/nvim/pack/downloads/start/mru
|
||||
$ cd $HOME/.config/nvim/pack/downloads/start/mru
|
||||
$ git clone https://github.com/yegappan/mru.git
|
||||
<
|
||||
==============================================================================
|
||||
3. Usage *mru-usage*
|
||||
|
||||
*:MRU*
|
||||
To list and edit files from the Most Recently Used (MRU) list, you can use the
|
||||
":MRU" command. The |:MRU| command displays the list of recently used files
|
||||
in a temporary Vim window. If the MRU window is already opened, then the MRU
|
||||
list currently displayed in the window is refreshed.
|
||||
|
||||
*:MRUToggle*
|
||||
Alternatively, you can use the ":MRUToggle" command to toggle (open or close)
|
||||
the MRU window. If the window is already opened, then running the ":MRUToggle"
|
||||
command will close the window.
|
||||
|
||||
If you are using GUI Vim, then the names of the recently edited files are
|
||||
added to the "File->Recent Files" menu. You can select the name of a file
|
||||
from this sub-menu to edit the file.
|
||||
|
||||
You can use the normal Vim commands to move around in the MRU window. You
|
||||
cannot make changes in the MRU window.
|
||||
|
||||
In the MRU window, the following keys can be used:
|
||||
|
||||
<Enter> - open the file under cursor
|
||||
o - open the file under cursor in a horizontally split window
|
||||
<S-Enter> - idem
|
||||
O - open the file under cursor in a vertically split window
|
||||
v - open the file under cursor in read-only mode
|
||||
t - open the file under cursor in a tab page
|
||||
p - open the file under cursor in the preview window
|
||||
u - update (refresh) the MRU list
|
||||
d - delete the file name under cursor from the MRU list
|
||||
q - close the MRU window
|
||||
<Esc> - idem
|
||||
|
||||
You can select a file name to edit by pressing the <Enter> key or by double
|
||||
clicking the left mouse button on a file name. The selected file will be
|
||||
opened. If the file is already opened in a window, the cursor will be moved
|
||||
to that window. Otherwise, the file is opened in the previous window. If the
|
||||
previous window has a modified buffer or is the preview window or is used by
|
||||
some other plugin, then the file is opened in a new window.
|
||||
|
||||
You can press the 'o' key to open the file name under the cursor in the
|
||||
MRU window in a new window. You can also press <Shift-Enter> instead of 'o'
|
||||
to open the file in a new window.
|
||||
|
||||
To open a file from the MRU window in read-only mode (view), press the 'v'
|
||||
key.
|
||||
|
||||
To open a file from the MRU window in a new tab, press the 't' key. If the
|
||||
file is already opened in a window in the current or in another tab, then
|
||||
the cursor is moved to that tab. Otherwise, a new tab is opened.
|
||||
|
||||
You can open multiple files from the MRU window by specifying a count before
|
||||
pressing '<Enter>' or 'v' or 'o' or 't'. You can also visually (using
|
||||
linewise visual mode) select multiple filenames and invoke the commands to
|
||||
open the files. Each selected file will be opened in a separate window or
|
||||
tab.
|
||||
|
||||
You can press the 'u' key in the MRU window to update/refresh the file list.
|
||||
This is useful if you keep the MRU window open always.
|
||||
|
||||
You can press the 'd' key to remove the entry under the cursor in the MRU
|
||||
window from the MRU list.
|
||||
|
||||
You can close the MRU window by pressing the 'q' key or the <Esc> key or
|
||||
using one of the Vim window commands.
|
||||
|
||||
By default, the MRU window is opened as the bottom-most window. If you are
|
||||
using Vim version 8.0 and above, then you can use command modifiers like
|
||||
|:topleft| or |:botright| or |:vertical| with the :MRU command to control
|
||||
where the window is opened. Example: >
|
||||
|
||||
:topleft MRU " horizontally split topmost window
|
||||
:botright MRU " horizontally split bottommost window
|
||||
:vertical topleft MRU " vertically split far-left window
|
||||
:vertical botright MRU " vertically split far-right window
|
||||
<
|
||||
By default, the height of the MRU window is 8 or the value specified by the
|
||||
g:MRU_Window_Height variable. You can pass a count to the :MRU command to use
|
||||
a different height. Example: >
|
||||
|
||||
:15MRU
|
||||
:vertical topleft 20MRU
|
||||
<
|
||||
To display only files matching a pattern from the MRU list in the MRU window,
|
||||
you can specify a pattern to the |:MRU| command. Example: >
|
||||
|
||||
:MRU mystr
|
||||
<
|
||||
The above command displays only the file names containing the string "mystr"
|
||||
in them. When you specify a partial file name and only one matching filename
|
||||
is found, then the |:MRU| command will edit that file.
|
||||
|
||||
The |:MRU| command supports command-line completion of file names from
|
||||
the MRU list. You can enter a partial file name and then press <Tab>
|
||||
or <Ctrl-D> to complete or list all the matching file names. Note that
|
||||
after typing the |:MRU| command, you have to enter a space before completing
|
||||
the file names with <Tab>.
|
||||
|
||||
When the search pattern supplied to the |:MRU| command matches only one file,
|
||||
then the file will be opened in the current window if it contains an
|
||||
unmodified buffer. Otherwise it will be opened in a new window. You can use
|
||||
command-line completion to select a file and directly open the file without
|
||||
opening the MRU window. If you are using Vim version 8.0 and above, you can
|
||||
use the command modifiers (|:leftabove|, |:rightbelow|, |:vertical|, |:tab|,
|
||||
etc.) to open the file in a horizontally or vertically split window or a tab
|
||||
page. Example: >
|
||||
|
||||
:topleft MRU myfile.py " horizontally split topmost window
|
||||
:botright MRU myfile.py " horizontally split bottommost window
|
||||
:vertical MRU myfile.py " vertically split window
|
||||
:vertical topleft MRU myfile.py " vertically split far-left window
|
||||
:vertical botright MRU myfile.py " vertically split far-right window
|
||||
:tab MRU myfile.py " new tab page
|
||||
<
|
||||
When a file supplied to the |:MRU| command is not present in the MRU list,
|
||||
but it is a readable file, then the file will be opened (even though it is
|
||||
not present in the MRU list). This is useful if you want to open a file
|
||||
present in the same directory as a file in the MRU list. You can use the
|
||||
command-line completion of the |:MRU| command to complete the full path of a
|
||||
file and then modify the path to open another file present in the same path.
|
||||
|
||||
Whenever the MRU list changes, the MRU file is updated with the latest MRU
|
||||
list. When you have multiple instances of Vim running at the same time, the
|
||||
latest MRU list will show up in all the instances of Vim.
|
||||
|
||||
The MRUFilename syntax group is used to highlight the file names in the MRU
|
||||
window. By default, this syntax group is linked to the Identifier highlight
|
||||
group. You can change the highlight group by adding the following line in
|
||||
your .vimrc:
|
||||
>
|
||||
highlight link MRUFileName LineNr
|
||||
<
|
||||
The MRU buffer uses the 'mru file type. You can use this file type to add
|
||||
custom auto commands, syntax highlighting, etc.
|
||||
|
||||
*:MruRefresh*
|
||||
After using the MRU plugin for a period of time, the MRU list may contain
|
||||
files which are no longer present in the system. The |:MruRefresh| command can
|
||||
be used to remove non-existing files from the MRU list.
|
||||
|
||||
*MruGetFiles()*
|
||||
The MruGetFiles() function can be used to get the current list of file names
|
||||
in the MRU list as a |List|. This can be used with Ex commands that accept one
|
||||
or more file names as argument. Some example uses for this function are below:
|
||||
>
|
||||
" search for 'my_text' in all the files in the MRU list
|
||||
:vimgrep my_text `=MruGetFiles()`
|
||||
" search for 'my_text' in the files ending in .java in the MRU list
|
||||
:vimgrep my_text `=MruGetFiles('.java')`
|
||||
" add all the .py files in the MRU list to the argument list
|
||||
:n `=MruGetFiles('.py')`
|
||||
" Add the files in MRU list to a quickfix list
|
||||
:call setqflist([], ' ', {'efm' : '%f', 'lines' : MruGetFiles()})
|
||||
<
|
||||
==============================================================================
|
||||
4. Configuration *mru-configuration*
|
||||
|
||||
The MRU plugin supports many configurable features. These can be enabled or
|
||||
disabled by setting one or more variables in your .vimrc file using the |:let|
|
||||
command. For Neovim, set these variables in the $HOME/.config/nvim/init.vim
|
||||
file. A summary of these variables is below:
|
||||
|
||||
|MRU_File| name of the file containing the MRU list
|
||||
|MRU_Max_Entries| size of the MRU list
|
||||
|MRU_Exclude_Files| pattern to exclude files from MRU list
|
||||
|MRU_Include_Files| pattern to include files in the MRU list
|
||||
|MRU_Window_Height| height of the MRU window
|
||||
|MRU_Use_Current_Window| use current window to display MRU list
|
||||
|MRU_Auto_Close| close the MRU window when a file is selected
|
||||
|MRU_Window_Open_Always| open the MRU window even for a single file
|
||||
|MRU_Open_File_Use_Tabs| open files in separate tab pages
|
||||
|MRU_FuzzyMatch| use fuzzy match for filtering file names
|
||||
|MRU_Add_Menu| add MRU files to the "Recent Files" menu
|
||||
|MRU_Max_Menu_Entries| maximum number of entries in the MRU menu
|
||||
|MRU_Max_Submenu_Entries| maximum number of entries in the MRU submenu
|
||||
|MRU_Set_Alternate_File| set the alternate file on plugin startup
|
||||
|MRU_Filename_Format| patterns to populate and parse file names in
|
||||
the MRU window
|
||||
|
||||
These variables are described in more detail below.
|
||||
|
||||
*MRU_File*
|
||||
The list of recently edited file names is stored in the file specified by the
|
||||
MRU_File variable. The default setting for this variable is
|
||||
$HOME/.vim_mru_files for Unix-like systems and $USERPROFILE/_vim_mru_files
|
||||
for MS-Windows systems. You can change this variable to point to a file by
|
||||
adding the following line to the .vimrc file:
|
||||
>
|
||||
let MRU_File = 'd:\myhome\_vim_mru_files'
|
||||
<
|
||||
*MRU_Max_Entries*
|
||||
By default, the plugin will remember the names of the last 100 used files.
|
||||
As you edit more files, old file names will be removed from the MRU list.
|
||||
You can set the 'MRU_Max_Entries' variable to remember more file names. For
|
||||
example, to remember 1000 most recently used file names, you can use
|
||||
>
|
||||
let MRU_Max_Entries = 1000
|
||||
<
|
||||
*MRU_Exclude_Files*
|
||||
By default, all the edited file names are added to the MRU list. If you want
|
||||
to exclude file names matching a pattern, then you can set the
|
||||
MRU_Exclude_Files variable to a Vim regular expression. If any part of a
|
||||
file name matches the regular expression, then it is not added to the MRU
|
||||
list. By default, this variable is set to an empty string. For example, to
|
||||
not include files in the temporary (/tmp, /var/tmp and D:\temp) directories,
|
||||
you can set the MRU_Exclude_Files variable to
|
||||
>
|
||||
let MRU_Exclude_Files = '^/tmp/.*\|^/var/tmp/.*' " For Unix
|
||||
let MRU_Exclude_Files = '^D:\\temp\\.*' " For MS-Windows
|
||||
<
|
||||
The specified pattern should be a Vim regular expression pattern. Note that
|
||||
you can specify multiple patterns using '\|'.
|
||||
|
||||
*MRU_Include_Files*
|
||||
If you want to add only file names matching a pattern to the MRU list, then
|
||||
you can set the MRU_Include_Files variable. This variable should be set to a
|
||||
Vim regular expression pattern. If the regular expression matches any part
|
||||
of a file name, then it is added to the MRU list. For example, to add only
|
||||
.c and .h files to the MRU list, you can set this variable as below:
|
||||
>
|
||||
let MRU_Include_Files = '\.c$\|\.h$'
|
||||
<
|
||||
By default, MRU_Include_Files is set to an empty string and all the edited
|
||||
filenames are added to the MRU list. Note that you can specify multiple
|
||||
patterns using '\|'.
|
||||
|
||||
*MRU_Window_Height*
|
||||
The default height of the MRU window is 8. You can set the MRU_Window_Height
|
||||
variable to change the window height. You can also set the height of the MRU
|
||||
window by passing a count to the :MRU command.
|
||||
>
|
||||
let MRU_Window_Height = 15
|
||||
<
|
||||
*MRU_Use_Current_Window*
|
||||
By default, when the |:MRU| command is invoked, the MRU list will be displayed
|
||||
in a new window. Instead, if you want the MRU plugin to reuse the current
|
||||
window, then you can set the 'MRU_Use_Current_Window' variable to one.
|
||||
>
|
||||
let MRU_Use_Current_Window = 1
|
||||
<
|
||||
The MRU plugin will reuse the current window. When a file name is selected,
|
||||
the file is also opened in the current window.
|
||||
|
||||
*MRU_Auto_Close*
|
||||
When you select a file from the MRU window, the MRU window will be
|
||||
automatically closed and the selected file will be opened in the previous
|
||||
window. You can set the 'MRU_Auto_Close' variable to zero to keep the MRU
|
||||
window open.
|
||||
>
|
||||
let MRU_Auto_Close = 0
|
||||
<
|
||||
*MRU_Window_Open_Always*
|
||||
When a search pattern is supplied to the :MRU command, the MRU window is
|
||||
opened if multiple files matching the pattern are found in the MRU list. If
|
||||
only one matching file is found, instead of opening the MRU window the file is
|
||||
directly opened. To force open the MRU window always, you can set the
|
||||
MRU_Window_Open_Always variable to 1. By default this variable is set to 0.
|
||||
>
|
||||
let MRU_Window_Open_Always = 1
|
||||
<
|
||||
*MRU_Open_File_Use_Tabs*
|
||||
When opening a file from the MRU list, the file is opened in the current
|
||||
tab. If the selected file has to be opened in a tab always, then set the
|
||||
following variable to 1. If the file is already opened in a tab, then the
|
||||
cursor will be moved to that tab.
|
||||
>
|
||||
let MRU_Open_File_Use_Tabs = 1
|
||||
<
|
||||
*MRU_FuzzyMatch*
|
||||
The :MRU command accepts a string that is used to filter the file names
|
||||
displayed in the MRU window. The MRU command also supports command-line
|
||||
completion using the supplied string. If Vim supports fuzzy matching
|
||||
(supported from Vim 8.2.1665), then the :MRU command will fuzzy match the
|
||||
supplied string against the file names. Otherwise it will use regular
|
||||
expression matching. To always use regular expression matching, you can set
|
||||
the MRU_FuzzyMatch variable to 0:
|
||||
>
|
||||
let MRU_FuzzyMatch = 0
|
||||
<
|
||||
*MRU_Add_Menu*
|
||||
If you don't use the "File->Recent Files" menu and want to disable it,
|
||||
then you can set the 'MRU_Add_Menu' variable to zero. By default, the
|
||||
menu is enabled.
|
||||
>
|
||||
let MRU_Add_Menu = 0
|
||||
<
|
||||
*MRU_Max_Menu_Entries*
|
||||
If too many file names are present in the MRU list, then updating the MRU
|
||||
menu to list all the file names makes Vim slow. To avoid this, the
|
||||
MRU_Max_Menu_Entries variable controls the number of file names to show in
|
||||
the MRU menu. By default, this is set to 10. You can change this to show
|
||||
more entries in the menu.
|
||||
>
|
||||
let MRU_Max_Menu_Entries = 20
|
||||
<
|
||||
*MRU_Max_Submenu_Entries*
|
||||
If many file names are present in the MRU list, then the MRU menu is split
|
||||
into sub-menus. Each sub-menu contains MRU_Max_Submenu_Entries file names.
|
||||
The default setting for this is 10. You can change this to increase the
|
||||
number of file names displayed in a single sub-menu:
|
||||
>
|
||||
let MRU_Max_Submenu_Entries = 15
|
||||
<
|
||||
*MRU_Set_Alternate_File*
|
||||
When the MRU plugin starts up, if the MRU_Set_Alternate_File variable is set
|
||||
to 1, then it sets the alternate file (|alternate-file|) to the first file in
|
||||
the MRU list. You can edit this file using the ":e #" command. By default this
|
||||
variable is set to 0. You can enable this behavior, by setting the
|
||||
MRU_Set_Alternate_File variable to 1:
|
||||
>
|
||||
let MRU_Set_Alternate_File = 1
|
||||
<
|
||||
*MRU_Filename_Format*
|
||||
In the MRU window, the filenames are displayed in two parts. The first part
|
||||
contains the file name without the path and the second part contains the
|
||||
full path to the file in parenthesis. This format is controlled by the
|
||||
MRU_Filename_Format variable. If you prefer to change this to some other
|
||||
format, then you can modify the MRU_Filename_Format variable.
|
||||
|
||||
The MRU_Filename_Format variable contains a |Dict| with the following keys:
|
||||
formatter: a string value containing an expression that specifies how to
|
||||
split/format the filename. In the expression v:val refers to the
|
||||
complete path to a file in the MRU list.
|
||||
parser : a string value containing an regular expression that specifies
|
||||
how to read the filename back from a line in the MRU window.
|
||||
syntax : a string value with a regular expression that matches the part to
|
||||
be highlighted in the MRU window.
|
||||
|
||||
For example, to display the full path of the files without splitting it, you
|
||||
can set this variable as shown below:
|
||||
>
|
||||
let MRU_Filename_Format = {
|
||||
\ 'formatter':'v:val',
|
||||
\ 'parser':'.*',
|
||||
\ 'syntax': '[^/\\]\+$'}
|
||||
<
|
||||
==============================================================================
|
||||
5. FZF Integration *mru-fzf*
|
||||
|
||||
You can use the MRU plugin with FZF (command-line fuzzy finder). You can
|
||||
download and install FZF from https://github.com/junegunn/fzf.
|
||||
|
||||
To select a file from the MRU file list using FZF, run the following command:
|
||||
>
|
||||
:FZFMru
|
||||
<
|
||||
This will invoke FZF to select a file from the MRU list.
|
||||
|
||||
==============================================================================
|
||||
|
||||
vim:tw=78:ts=8:noet:ft=help:
|
||||
File diff suppressed because it is too large
Load Diff
|
|
@ -0,0 +1,3 @@
|
|||
[run]
|
||||
plugins = covimerage
|
||||
data_file = .coverage_covimerage
|
||||
|
|
@ -0,0 +1,18 @@
|
|||
@echo off
|
||||
|
||||
REM Script to run the unit-tests for the MRU Vim plugin on MS-Windows
|
||||
|
||||
SETLOCAL
|
||||
SET VIMPRG="vim.exe"
|
||||
REM SET VIMPRG="C:\Program Files (x86)\vim\vim82\vim.exe"
|
||||
REM SET VIMPRG="C:\Program Files (x86)\vim\vim73\vim.exe"
|
||||
SET VIM_CMD=%VIMPRG% -N -u NONE -U NONE -i NONE --not-a-term
|
||||
|
||||
%VIM_CMD% -S unit_tests.vim
|
||||
|
||||
echo MRU unit test results
|
||||
type results.txt
|
||||
|
||||
findstr /I FAIL results.txt > nul 2>&1
|
||||
if %ERRORLEVEL% EQU 0 echo ERROR: Some test failed.
|
||||
if %ERRORLEVEL% NEQ 0 echo SUCCESS: All the tests passed.
|
||||
|
|
@ -0,0 +1,30 @@
|
|||
#!/bin/bash
|
||||
|
||||
# Script to run the unit-tests for the MRU Vim plugin
|
||||
|
||||
VIMPRG=${VIMPRG:=/usr/bin/vim}
|
||||
VIM_CMD="$VIMPRG -N -u NONE -U NONE -i NONE"
|
||||
|
||||
$VIM_CMD -S unit_tests.vim
|
||||
|
||||
echo "MRU unit test results"
|
||||
echo
|
||||
|
||||
if [ ! -f results.txt ]
|
||||
then
|
||||
echo "ERROR: Test results file 'results.txt' is not found"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
cat results.txt
|
||||
|
||||
echo
|
||||
grep FAIL results.txt > /dev/null 2>&1
|
||||
if [ $? -eq 0 ]
|
||||
then
|
||||
echo "ERROR: Some test(s) failed."
|
||||
exit 1
|
||||
fi
|
||||
|
||||
echo "SUCCESS: All the tests passed."
|
||||
exit 0
|
||||
File diff suppressed because it is too large
Load Diff
Loading…
Reference in New Issue