Version 0.3

  vim-buffr plugin version 0.3 required
  * position and buffer name arguments were added to command
  * allow range
  * buffr#open_or_create arguments were changed to dictionary
  * command VExtract was renamed to Extr
  * g:extract_position option was removed

Author: lucerion

autoload/extract.vim

@@ -2,39 +2,47 @@
 " Description:  Extract selection to a new buffer
 " Author:       Alexander Skachko <alexander.skachko@gmail.com>
 " Homepage:     https://github.com/lucerion/vim-extract
-" Version:      0.2
+" Version:      0.3
 " Licence:      MIT
 " ==============================================================
 
-func! extract#extract(start_line, end_line)
+func! extract#extract(start_line, end_line, count, buffer_options)
+  let s:buffer_options = a:buffer_options
+
   if exists('g:loaded_buffr')
-    call s:extract(a:start_line, a:end_line)
+    call s:extract(a:start_line, a:end_line, a:count)
   else
     call s:show_error('Please, install vim-buffr')
     return
   endif
 endfunc
 
-func! s:extract(start_line, end_line)
+func! s:extract(start_line, end_line, count)
   let l:selection = getline(a:start_line, a:end_line)
-  let l:in_visual_mode = s:in_visual_mode()
 
-  if l:in_visual_mode && len(l:selection)
+  if a:count
     call s:delete_lines(a:start_line, a:end_line)
   endif
   call s:open_buffer()
-  if l:in_visual_mode && len(l:selection)
+  if a:count
     call s:clear_buffer()
     call s:insert_selection(l:selection)
   endif
 endfunc
 
 func! s:open_buffer()
-  let l:buffer_name = substitute(g:extract_name, '{filename}', expand('%:t'), 'g')
-  call buffr#open_or_create_buffer(l:buffer_name, g:extract_position)
+  call buffr#open_or_create_buffer(s:buffer_options())
   call s:set_buffer_defaults()
 endfunc
 
+func! s:buffer_options()
+  let l:default_buffer_options = {
+  \  'name': substitute(g:extract_name, '{filename}', expand('%:t'), 'g'),
+  \ }
+
+  return extend(l:default_buffer_options, s:buffer_options)
+endfunc
+
 func! s:clear_buffer()
   if !g:extract_append
     silent exec 'normal! ggVGd'
@@ -63,10 +71,6 @@ func! s:set_buffer_defaults()
   setlocal noswapfile
 endfunc
 
-func! s:in_visual_mode()
-  return visualmode(1) =~? '.*v'
-endfunc
-
 func! s:show_error(message)
   echohl ErrorMsg | echomsg a:message | echohl None
 endfunc

doc/vim-extract.txt

@@ -2,8 +2,8 @@
 
 Author:      Alexander Skachko <alexander.skachko@gmail.com>
 Homepage:    https://github.com/lucerion/vim-extract
-Version:     0.2
-Licence:     MIT
+Version:     0.3
+Licence:     MIT (see LICENSE)
 
 ===============================================================================
 CONTENTS                                                          *vim-extract*
@@ -17,25 +17,26 @@ License                                                   |vim-extract-license|
 ===============================================================================
 INSTALL                                                   *vim-extract-install*
 
-vim-extract dependending on vim-buffr plugin
+This plugin depends on vim-buffr (https://github.com/lucerion/vim-buffr)
+plugin
 
-Vundle                                  https://github.com/VundleVim/Vundle.vim
+Vundle                                https://github.com/VundleVim/Vundle.vim
 >
     Plugin 'lucerion/vim-extract'
     Plugin 'lucerion/vim-buffr'
 <
-Pathogen                                  https://github.com/tpope/vim-pathogen
+Pathogen                                https://github.com/tpope/vim-pathogen
 >
     cd ~/.vim/bundle
     git clone https://github.com/lucerion/vim-extract
     git clone https://github.com/lucerion/vim-buffr
 <
-NeoBundle                               https://github.com/Shougo/neobundle.vim
+NeoBundle                             https://github.com/Shougo/neobundle.vim
 >
     NeoBundle 'lucerion/vim-extract'
     NeoBundle 'lucerion/vim-buffr'
 <
-vim-plug                                   https://github.com/junegunn/vim-plug
+vim-plug                                 https://github.com/junegunn/vim-plug
 >
     Plug 'lucerion/vim-extract'
     Plug 'lucerion/vim-buffr'
@@ -50,41 +51,53 @@ Manual
 ===============================================================================
 COMMANDS                                                 *vim-extract-commands*
 
-                                                                    *:VExtract*
-:VExtract                   In Visual mode - extract selection to a buffer,
-                            in Normal mode - open the extract buffer.
+                                                                        *:Extr*
+:[range]Extr {name} {position} or :[range]Extr {position} {name}
+
+  In Visual mode - extract selection to a buffer, in Normal mode - open
+  the extract buffer. Buffer will be opened with {name} at {position}
+  'name' and 'position' arguments are optional
+  Without 'position' argument buffer will open with last opened position or
+  will be opened with default position
+  Possible {position} values: -top, -bottom, -left, -right, -tab
+  Default {position} value: -top
 
 ===============================================================================
 OPTIONS                                                   *vim-extract-options*
 
                                                                *g:extract_name*
 
-The name of the extract buffer. {filename} pattern will be replaced with
-the current file name.
+Pattern of the extract buffer name. {filename} will be replaced with current
+file name. Will be used if :Extr command was called without 'name' argument
 
 Default: '_{filename}'
 
-                                                           *g:extract_position*
-
-The extract buffer position.
-
-Possible values: 'top', 'bottom', 'left', 'right', 'tab'
-Default: 'top'
-
                                                              *g:extract_append*
 
-Append selected text to the end of the extract buffer or clear the extract
-buffer before insert.
+Append selected text to the end of the extract buffer (1) or clear the extract
+buffer and insert selection (0)
 
 Default: 1
 
 ===============================================================================
 CHANGELOG                                               *vim-extract-changelog*
 
+0.3.0 (2016-03-27)~
+  vim-buffr plugin version 0.3 required
+
+  Features
+    * position and buffer name arguments were added to command
+    * allow range
+  Fixes
+    * buffr#open_or_create arguments were changed to dictionary
+    * command VExtract was renamed to Extr
+    * g:extract_position option was removed
+
 0.2.0 (2016-02-05)~
   Fixes
-    Change buffr#open to buffr#open_or_create
-    Rename Extract to VExtract command (vim-rails plugin conflict)
+    * buffr#open to buffr#open_or_create was changed
+    * command Extract was renamed to VExtract (vim-rails plugin conflict)
+
 0.1.0 (2015-12-06)~
   First release
 

plugin/extract.vim

@@ -2,7 +2,7 @@
 " Description:  Extract selection to a new buffer
 " Author:       Alexander Skachko <alexander.skachko@gmail.com>
 " Homepage:     https://github.com/lucerion/vim-extract
-" Version:      0.2
+" Version:      0.3
 " Licence:      MIT
 " ==============================================================
 
@@ -14,14 +14,35 @@ if !exists('g:extract_name')
   let g:extract_name = '_{filename}'
 endif
 
-if !exists('g:extract_position')
-  let g:extract_position = 'top'
-endif
-
 if !exists('g:extract_append')
   let g:extract_append = 1
 endif
 
-comm! -nargs=0 -range=0 VExtract call extract#extract(<line1>, <line2>)
+let s:allowed_args = ['-top', '-bottom', '-left', '-right', '-tab']
+
+func! s:autocompletion(A, L, C)
+  return s:allowed_args
+endfunc
+
+func! s:extract(start_line, end_line, count, ...)
+  let l:name_args_filter = 'index(s:allowed_args, v:val) < 0'
+  let l:position_args_filter = 'index(s:allowed_args, v:val) >= 0'
+  let l:name_args = filter(copy(a:000), l:name_args_filter)
+  let l:position_args = filter(copy(a:000), l:position_args_filter)
+
+  let l:buffer_options = {}
+  if len(l:name_args)
+    let l:buffer_options['name'] = join(l:name_args)
+  endif
+  if len(l:position_args)
+    let l:position_arg = get(l:position_args, -1)
+    let l:buffer_options['position'] = substitute(l:position_arg, '-', '', 'g')
+  endif
+
+  call extract#extract(a:start_line, a:end_line, a:count, l:buffer_options)
+endfunc
+
+comm! -nargs=* -range=0 -complete=customlist,s:autocompletion Extr
+  \ call s:extract(<line1>, <line2>, <count>, <f-args>)
 
 let g:loaded_extract = 1