feat(repl): add Ex commands

CHANGELOG.md

@@ -8,7 +8,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
 ### Added
 - Health: Check for conflicting `lspconfig.hls` configuration.
-- New commands: `:HlsEvalAll`
+- New commands: `HlsEvalAll`, `HtReplToggle`, `HtReplQuit`, `HtReplLoad`, `HtReplReload`
 
 ### Fixed
 - Builtin repl: Broken toggle

README.md

@@ -456,6 +456,13 @@ ht.hoogle.hoogle_signature()
 
 #### Repl
 
+| Command         | Description                         | Arguments           |
+| --------------- | ----------------------------------- | ------------------- |
+| `:HtReplToggle` | Toggle a GHCi repl                  | filepath (optional) |
+| `:HtReplQuit`   | Quit the current repl               |                     |
+| `:HtReplLoad`   | Load a file into the current repl   | filepath (required) |
+| `:HtReplReoad`  | Reload the current repl             |                     |
+
 ```lua
 local ht = require('haskell-tools')
 --- Toggle a GHCi repl for the current project

doc/haskell-tools.txt

@@ -216,6 +216,7 @@ haskell-language-server LSP client tools                     *haskell-tools.lsp*
  * `:HlsStart` - Start the LSP client.
  * `:HlsStop` - Stop the LSP client.
  * `:HlsRestart` - Restart the LSP client.
+ * `:HlsEvalAll` - Evaluate all code snippets in comments.
 
 LoadHlsSettingsOpts                                        *LoadHlsSettingsOpts*
 
@@ -326,6 +327,13 @@ HoogleTools.hoogle_signature({options})           *HoogleTools.hoogle_signature*
 ==============================================================================
 haskell-tools GHCi REPL module                              *haskell-tools.repl*
 
+ The following commands are available:
+
+ * `:HtReplToggle` - Toggle a GHCi repl.
+ * `:HtReplQuit` - Quit the current repl.
+ * `:HtReplLoad` - Load a Haskell file into the repl.
+ * `:HtReplReload` - Reload the current repl.
+
 HsReplTools                                                        *HsReplTools*
 
 

lua/haskell-tools/lsp.lua

@@ -13,6 +13,7 @@ local uv = vim.uv
 --- * `:HlsStart` - Start the LSP client.
 --- * `:HlsStop` - Stop the LSP client.
 --- * `:HlsRestart` - Restart the LSP client.
+--- * `:HlsEvalAll` - Evaluate all code snippets in comments.
 ---@brief ]]
 
 ---To minimise the risk of this occurring, we attempt to shut down hls cleanly before exiting neovim.

lua/haskell-tools/repl.lua

@@ -4,6 +4,15 @@
 ---Tools for interaction with a GHCi REPL
 ---@bruief ]]
 
+---@brief [[
+--- The following commands are available:
+---
+--- * `:HtReplToggle` - Toggle a GHCi repl.
+--- * `:HtReplQuit` - Quit the current repl.
+--- * `:HtReplLoad` - Load a Haskell file into the repl.
+--- * `:HtReplReload` - Reload the current repl.
+---@brief ]]
+
 local log = require('haskell-tools.log.internal')
 local Types = require('haskell-tools.types.internal')
 
@@ -237,4 +246,45 @@ end
 
 vim.keymap.set('n', 'ghc', HsReplTools.operator, { noremap = true })
 
+local commands = {
+  {
+    'HtReplToggle',
+    ---@param tbl table
+    function(tbl)
+      local filepath = tbl.args ~= '' and vim.fn.expand(tbl.args)
+      ---@cast filepath string
+      HsReplTools.toggle(filepath)
+    end,
+    { nargs = '?' },
+  },
+  {
+    'HtReplLoad',
+    ---@param tbl table
+    function(tbl)
+      local filepath = vim.fn.expand(tbl.args)
+      ---@cast filepath string
+      HsReplTools.load_file(filepath)
+    end,
+    { nargs = 1 },
+  },
+  {
+    'HtReplQuit',
+    function()
+      HsReplTools.quit()
+    end,
+    {},
+  },
+  {
+    'HtReplReload',
+    function()
+      HsReplTools.reload()
+    end,
+    {},
+  },
+}
+
+for _, command in ipairs(commands) do
+  vim.api.nvim_create_user_command(unpack(command))
+end
+
 return HsReplTools