Support --no-file-ext for :ScratchBufferOpen

Closes #5

Author: aiya000

README.md

@@ -11,13 +11,20 @@
 ## :wrench: Quick Start
 
 ```vim
-" Open a random file with Markdown filetype
+" Open a new scratch buffer without file extension and filetype
+:ScratchBufferOpen
+:ScratchBufferOpen --no-file-ext
+```
+
+```vim
+" Open a new scratch buffer with Markdown filetype
 :ScratchBufferOpen md
 ```
 
 ```vim
 " Open a small buffer at the top for quick notes
 :ScratchBufferOpen md sp 5
+:ScratchBufferOpen --no-file-ext sp 5
 ```
 
 Of course, you can open other file types too!

autoload/scratch_buffer.vim

@@ -2,17 +2,25 @@ scriptencoding utf-8
 scriptversion 3
 
 " Params:
-" - file_ext {string} a file extension without '.', e.g., 'md', 'ts', or 'sh'
-" - (second argument) {'sp' | 'vsp' | undefined} An open method. How to open the new buffer
-" - (third argument) {number} A positive number to `:resize buffer_size`
-function! scratch_buffer#open(file_ext, ...) abort
-  const file_name = s:find_fresh_tmp_file($'{g:scratch_buffer_tmp_file_pattern}.{a:file_ext}')
+" - (first argument) {string | undefined} (Optional)
+"     - File extension without '.', e.g., 'md', 'ts', or 'sh'
+"     - Or '--no-file-ext' to create a buffer without file extension
+"     - If omitted, creates a buffer without file extension
+" - (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')
+  const file_pattern = (file_ext ==# '--no-file-ext' || file_ext ==# '')
+    \ ? $'{g:scratch_buffer_tmp_file_pattern}'
+    \ : $'{g:scratch_buffer_tmp_file_pattern}.{file_ext}'
+
+  const file_name = s:find_fresh_tmp_file(file_pattern)
   if file_name is v:null
     throw 'No fresh scratch file found.'
   endif
 
-  const open_method = get(a:000, 0, 'vsp')
-  const buffer_size = get(a:000, 1, v:null)
+  const open_method = get(a:000, 1, 'vsp')
+  const buffer_size = get(a:000, 2, v:null)
 
   execute 'silent' open_method file_name
   setlocal noswapfile

doc/vim-scratch-buffer.txt

@@ -29,6 +29,7 @@ to execute code instantly!
 	:ScratchBufferOpen ts
 
 	" Write TypeScript code
+	" ...
 
 	" ...and run it immediately!
 	:QuickRun
@@ -42,13 +43,17 @@ https://github.com/aiya000/vim-scratch-buffer
 ==============================================================================
 USAGE						*scratch-buffer-usage*
 
-Open a scratch buffer. Please specify a file extension you want:
+Open a scratch buffer with or without a file extension:
 >
+	" Open a new scratch buffer without file extension and filetype
+	:ScratchBufferOpen
+	:ScratchBufferOpen --no-file-ext
+
 	" Open a markdown buffer
 	:ScratchBufferOpen md
 
-	" Open a markdown buffer with :sp
-	:ScratchBufferOpen md sp
+	" Open a buffer without file extension and filetype with :sp and 3 lines
+	:ScratchBufferOpen --no-file-ext sp 3
 
 	" Open a markdown buffer with :sp and 3 lines
 	:ScratchBufferOpen md sp 3
@@ -78,12 +83,18 @@ VARIABLES						*scratch-buffer-variables*
 COMMANDS					*scratch-buffer-commands*
 
 						*:ScratchBufferOpen*
-:ScratchBufferOpen {file-extension} [open-method] [buffer-size]
+:ScratchBufferOpen [file-extension | --no-file-ext] [open-method] [buffer-size]
 	Open a 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:
 >
@@ -115,8 +126,13 @@ COMMANDS					*scratch-buffer-commands*
 FUNCTIONS					*scratch-buffer-functions*
 
 						*scratch_buffer#open()*
-scratch_buffer#open({file-extension}[, open-method][, buffer-size])
-	Same as `:ScratchBufferOpen`.
+scratch_buffer#open([file-extension | --no-filetype][, 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#clean_all_of()*
 scratch_buffer#clean_all_of({file-extension})

plugin/scratch_buffer.vim

@@ -6,10 +6,12 @@ endif
 let g:loaded_scratch_buffer = v:true
 
 " Example:
+" `:ScratchBufferOpen`
+" `:ScratchBufferOpen --no-filetype`
 " `:ScratchBufferOpen sh`
 " `:ScratchBufferOpen ts vsp`
 " `:ScratchBufferOpen md sp 5`
-command! -bar -nargs=+ ScratchBufferOpen call scratch_buffer#open(<f-args>)
+command! -bar -nargs=* ScratchBufferOpen call scratch_buffer#open(<f-args>)
 
 " Example:
 " `:ScratchBufferCleanAllOf md`