Created commands (#18)

* Created `Runner` command

* Remove unnesessary temp variable

* Created `AutoRunner` command

`AutoRunner` command executes the `Runner` command every time a file is saved.

* Updated formatting

* Fix descriptions

* Created `AutoRunnerStop` command

`AutoRunnerStop` - stops `AutoRunner` and closes its window

* Automatic formatting

* Added command description to readme

* Update table

Added lua command column to "Commands" table.

* Update function description

Specified that `autorun` can accept buffer number as an argument.

* Fix `autorun` function

When saving a file, now function now checks if `_terminal_windows` exists and call the last shell command, otherwise it calls the vim command.

* Moved `user_commands`

`user_commands` now are created when `setup()` is called.

* Fix README

Removed the line stating that the `setup()` function in optional.

lua/runner/handlers/utils.lua

@@ -5,6 +5,7 @@ local config = require('runner.config')
 M._terminal_buffer = nil
 M._terminal_window = nil
 M._last_command = nil
+M._last_handler = nil
 
 M.create_buffer = function()
   if M._terminal_buffer then

lua/runner/init.lua

@@ -9,6 +9,18 @@ M._handlers = handlers
 
 M.setup = function(options)
   config.setup(options)
+
+  vim.api.nvim_create_user_command('Runner', function()
+    require('runner').run()
+  end, { desc = 'Run code inside the editor' })
+
+  vim.api.nvim_create_user_command('AutoRunner', function()
+    require('runner').autorun()
+  end, { desc = 'Execute `Runner` on a file save' })
+
+  vim.api.nvim_create_user_command('AutoRunnerStop', function()
+    require('runner').autorun_stop()
+  end, { desc = 'Stop `AutoRunner`' })
 end
 
 --- **Overrides** the handler for the specified filetype
@@ -28,29 +40,49 @@ M.set_handler = function(filetype, handler)
   M._handlers[filetype] = handler
 end
 
+--- @param bufnr integer?
 M.run = function(bufnr)
-  local buffer
   if bufnr == nil or bufnr == 0 then
-    buffer = vim.api.nvim_get_current_buf()
-  else
-    buffer = bufnr
+    bufnr = vim.api.nvim_get_current_buf()
   end
 
-  if buffer == utils._terminal_buffer then
+  if bufnr == utils._terminal_buffer then
     helpers.shell_handler(utils._last_command, false)()
     return
   end
 
-  local filetype = vim.filetype.match { buf = buffer }
+  local filetype = vim.filetype.match { buf = bufnr }
 
   local handler = M._handlers[filetype]
 
   if not handler then
-    print(string.format("No handler defined for filetype '%s'", filetype))
+    print('No handler defined for filetype ' .. filetype)
     return
   end
 
-  handler(buffer)
+  utils._last_handler = handler
+  handler(bufnr)
+end
+
+--- @param bufnr integer?
+M.autorun = function(bufnr)
+  M.run(bufnr)
+  vim.api.nvim_create_autocmd('BufWritePost', {
+    group = vim.api.nvim_create_augroup('AutoRunner', { clear = true }),
+    pattern = '*',
+    callback = function()
+      if utils._terminal_window then
+        helpers.shell_handler(utils._last_command, false)()
+      else
+        utils._last_handler(bufnr)
+      end
+    end,
+  })
+end
+
+M.autorun_stop = function()
+  vim.api.nvim_del_augroup_by_name('AutoRunner')
+  vim.api.nvim_win_close(utils._terminal_window, true)
 end
 
 return M