Switch to using toggleterm

Makefile

@@ -8,7 +8,7 @@ test:
 		--headless \
 		--noplugin \
 		-u ${TESTS_INIT} \
-		-c "PlenaryBustedFile tests/devcontainer_cli/unit_tests.lua"
+		-c "PlenaryBustedFile tests/devcontainer-cli/unit_tests.lua"
 
 test_all:
 	@nvim \

README.md

@@ -76,6 +76,7 @@ make assumptions about how you work.
 
 - [docker](https://docs.docker.com/get-docker/)
 - [devcontainer-cli](https://github.com/devcontainers/cli#npm-install)
+- [toggleterm](https://github.com/akinsho/toggleterm.nvim)
 
 ## 🔧 Installation
 
@@ -84,6 +85,7 @@ make assumptions about how you work.
 ```lua
 {
   "erichlf/devcontainer-cli.nvim",
+  dependencies = { 'akinsho/toggleterm.nvim' },
   opts = {
     -- whather to verify that the final devcontainer should be run
     interactive = false,
@@ -107,29 +109,34 @@ make assumptions about how you work.
     -- stylua: ignore
     {
       "<leader>Du",
-      ":DevcontainerUp<cr>",
+      ":DevcontainerUp<CR>",
       desc = "Bring up the DevContainer",
     },
     {
       "<leader>Dc",
-      ":DevcontainerConnect<cr>",
+      ":DevcontainerConnect<CR>",
       desc = "Connect to DevContainer",
     },
     {
       "<leader>De",
-      ":DevcontainerExec<cr>",
+      ":DevcontainerExec<CR>",
       desc = "Execute a command in DevContainer",
     },
     {
       "<leader>Db",
-      ":DevcontainerExec cd build && make<cr>",
+      ":DevcontainerExec cd build && make<CR>",
       desc = "Execute build command in DevContainer",
     },
     {
       "<leader>Dt",
-      ":DevcontainerExec cd build && make test<cr>",
+      ":DevcontainerExec cd build && make test<CR>",
       desc = "Execute test command in DevContainer",
     },
+    {
+      "<leader>DT",
+      "<CMD>DevContainerToggle<CR>",
+      desc = "Toggle the current DevContainer Terminal"
+    },
   }
 },
 ```
@@ -160,6 +167,14 @@ There are 3 main commands: `:DevcontainerUp`, `:DevcontainerExec`, and `:Devcont
    continue working in your current session and run commands in the
    devcontainer via `DevcontainerExec`.
 
+During execution using `DevcontainerUp` or `DevcontainerExec` it is possible
+to toggle the terminal via `t` while in normal mode and then to bring it back
+you can run `:DevContainerToggle`. Additionally you could bring it back through
+`:TermSelect`.
+
+During the execution of a Devcontainer process you can also type `q` or `<esc>`
+to kill the process and exit the terminal window.
+
 ## Tests
 
 Tests are executed automatically on each PR using Github Actions.

doc/devcontainer-cli.nvim.txt

@@ -19,6 +19,11 @@ DevcontainerUp                                                  *DevcontainerUp*
 DevcontainerExec                                              *DevcontainerExec*
     Runs a given command in the projects devcontainer.
 
+DevcontainerToggle                                          *DevcontainerToggle*
+    Toggles the current devcontainer window. It is expected that only one 
+    devcontainer window is open at a time and so this will only toggle the last
+    devcontainer window.
+
 DevcontainerConnect                                        *DevcontainerConnect*
     Closes the nvim sessions (all sessions fromt the terminal) and opens a new
     terminal which is connected in the docker container, ready to execute the

lua/devcontainer-cli/devcontainer_cli.lua

@@ -1,5 +1,5 @@
 local config = require("devcontainer-cli.config")
-local devcontainer_utils = require("devcontainer-cli.devcontainer_utils")
+local utils = require("devcontainer-cli.devcontainer_utils")
 
 local M = {}
 
@@ -11,28 +11,50 @@ local function define_autocommands()
       -- It connects with the Devcontainer just after quiting neovim.
       -- TODO: checks that the devcontainer is not already connected
       -- TODO: checks that there is a devcontainer running
-      vim.schedule(function()
-        local command = config.nvim_plugin_folder .. "/bin/connect_to_devcontainer.sh"
-        vim.fn.jobstart(command, { detach = true })
-      end)
+      vim.schedule(
+        function()
+          local command = config.nvim_plugin_folder .. "/bin/connect_to_devcontainer.sh"
+          vim.fn.jobstart(command, { detach = true })
+        end
+      )
     end,
   })
 end
 
 -- executes a given command in the devcontainer of the current project directory
 ---@param opts (table) options for executing the command
 function M.exec(opts)
-  vim.validate({ args = { opts.args, "string" } })
-  if opts.args == nil or opts.args == "" then
-    devcontainer_utils.exec()
-  else
-    devcontainer_utils.exec_cmd(opts.args)
+  local args = opts.args
+  vim.validate({ args = { args, "string", true } })
+
+  local parsed = {
+    cmd = nil,
+    direction = nil,
+  }
+
+  if args ~= nil then
+    parsed = utils.parse(args)
+
+    vim.validate({
+      cmd = { parsed.cmd, "string", true },
+      direction = { parsed.direction, "string", true },
+    })
+    if parsed.cmd == nil and parsed.direction == nil then
+      parsed.cmd = args
+    end
   end
+
+  utils.exec(parsed.cmd, parsed.direction)
+end
+
+-- toggle the current devcontainer window
+function M.toggle()
+  utils.toggle()
 end
 
 -- bring up the devcontainer in the current project directory
 function M.up()
-  devcontainer_utils.bringup(vim.loop.cwd())
+  utils.bringup()
 end
 
 -- Thanks to the autocommand executed after leaving the UI, after closing the