Support :ScratchBufferOpenFile

Author: aiya000

autoload/scratch_buffer.vim

@@ -9,7 +9,15 @@ scriptversion 3
 " - (second argument) {'sp' | 'vsp' | undefined} (Optional) An open method. How to open the new buffer
 " - (third argument) {number | undefined} (Optional) A positive number to `:resize buffer_size`
 function! scratch_buffer#open(...) abort
-  const file_ext = get(a:000, 0, '--no-file-ext')
+  return s:open_buffer(v:true, a:000)
+endfunction
+
+function! scratch_buffer#open_file(...) abort
+  return s:open_buffer(v:false, a:000)
+endfunction
+
+function! s:open_buffer(temp_buffer, args) abort
+  const file_ext = get(a:args, 0, '--no-file-ext')
   const file_pattern = (file_ext ==# '--no-file-ext' || file_ext ==# '')
     \ ? $'{g:scratch_buffer_tmp_file_pattern}'
     \ : $'{g:scratch_buffer_tmp_file_pattern}.{file_ext}'
@@ -19,13 +27,16 @@ function! scratch_buffer#open(...) abort
     throw 'No fresh scratch file found.'
   endif
 
-  const open_method = get(a:000, 1, 'vsp')
-  const buffer_size = get(a:000, 2, v:null)
+  const open_method = get(a:args, 1, 'vsp')
+  const buffer_size = get(a:args, 2, v:null)
 
   execute 'silent' open_method file_name
-  setlocal noswapfile
-  setlocal buftype=nofile
-  setlocal bufhidden=hide
+
+  if a:temp_buffer
+    setlocal noswapfile
+    setlocal buftype=nofile
+    setlocal bufhidden=hide
+  endif
 
   if buffer_size !=# v:null
     execute (open_method ==# 'vsp' ? 'vertical' : '') 'resize' buffer_size
@@ -47,16 +58,14 @@ endfunction
 " Clean up all scratch buffers and files
 function! scratch_buffer#clean() abort
   const all_buffer_names = scratch_buffer#helper#get_all_buffer_names()
-
   const base_pattern = printf(g:scratch_buffer_tmp_file_pattern, '*')
   const files = glob(base_pattern .. '*', 0, 1)
+
   for scratch in files
-    " Delete file if exists
     if filereadable(scratch)
       call delete(scratch)
     endif
 
-    " Delete buffer if exists
     if all_buffer_names->scratch_buffer#helper#contains(scratch)
       execute ':bwipe' bufnr(scratch)
     endif

doc/vim-scratch-buffer.txt

@@ -84,17 +84,17 @@ COMMANDS					*scratch-buffer-commands*
 
 						*:ScratchBufferOpen*
 :ScratchBufferOpen [file-extension | --no-file-ext] [open-method] [buffer-size]
-	Open a scratch buffer with a random file name.
-	
+	Open a temporary scratch buffer with a random file name.
+
 	This opens buffers by the rule
 	described in `g:scratch_buffer_tmp_file_pattern`.
-	
+
 	[file-extension] is an optional argument:
 	  - When omitted or --no-file-ext is specified:
 	    Creates a buffer without file extension and filetype
 	  - Otherwise:
 	    Uses the specified extension (e.g., 'md', 'ts') as filetype
-	
+
 	The buffer is opened as a temporary buffer.
 	The following properties:
 >
@@ -116,6 +116,14 @@ COMMANDS					*scratch-buffer-commands*
 	or doesn't resize if this is omitted.
 
 
+						*:ScratchBufferOpenFile*
+:ScratchBufferOpenFile [file-extension | --no-file-ext] [open-method] [buffer-size]
+	Similar to `:ScratchBufferOpen` but creates a normal buffer instead of
+	a temporary one. The buffer can be written and saved normally.
+
+	Uses the same arguments as `:ScratchBufferOpen`.
+
+
 						*:ScratchBufferClean*
 :ScratchBufferClean
 	Delete all scratch files and buffers that
@@ -126,17 +134,22 @@ COMMANDS					*scratch-buffer-commands*
 FUNCTIONS					*scratch-buffer-functions*
 
 						*scratch_buffer#open()*
-scratch_buffer#open([file-extension | --no-filetype][, open-method][, buffer-size])
+scratch_buffer#open([file-extension | --no-file-ext][, open-method][, buffer-size])
 	Same as `:ScratchBufferOpen`. Creates a buffer with or without
 	filetype based on the first argument:
 	  - When an empty string or`'--no-file-ext'`is specified:
 	    Creates a buffer without file extension and filetype
 	  - Otherwise:
 	    Uses the specified extension as filetype
 
+						*scratch_buffer#open_file()*
+scratch_buffer#open_file([file-extension | --no-file-ext][, open-method][, buffer-size])
+	Same as `:ScratchBufferOpenFile`. Creates a normal buffer with the same naming
+	convention as `:ScratchBufferOpen`, but without temporary buffer properties.
+
 						*scratch_buffer#clean()*
-						scratch_buffer#clean()
-						Same as `:ScratchBufferClean`.
+scratch_buffer#clean()
+	Same as `:ScratchBufferClean`.
 
 
 ==============================================================================

plugin/scratch_buffer.vim

@@ -7,12 +7,17 @@ let g:loaded_scratch_buffer = v:true
 
 " Example:
 " `:ScratchBufferOpen`
-" `:ScratchBufferOpen --no-filetype`
+" `:ScratchBufferOpen --no-file-ext`
 " `:ScratchBufferOpen sh`
 " `:ScratchBufferOpen ts vsp`
 " `:ScratchBufferOpen md sp 5`
 command! -bar -nargs=* ScratchBufferOpen call scratch_buffer#open(<f-args>)
 
-command! -bar -nargs=0 ScratchBufferClean call scratch_buffer#clean()
+" Example:
+" `:ScratchBufferOpenFile md`
+" `:ScratchBufferOpenFile ts vsp`
+command! -bar -nargs=* ScratchBufferOpenFile call scratch_buffer#open_file(<f-args>)
+
+command! -bar ScratchBufferClean call scratch_buffer#clean()
 
 let g:scratch_buffer_tmp_file_pattern = '/tmp/vim-scratch-buffer-%d'