Files
jpdebug/runners/shell.lua

57 lines
1.3 KiB
Lua

local core = require "core"
local process = require "process"
---@class M
local M = {
name = "shell"
}
-- Run a shell command
---@param cmd table|string List of command pieces or in full
---@param opts table Options to run the command. Should contain env (table), cwd (string), stdout and stdin
---@param name string Name of the target to run
---@return process|nil
function M:run(cmd, opts, name)
core.log("[jpdebug] Running shell command")
if cmd then
local proc = process.start(cmd, opts)
return proc
else
core.error("[jpdebug] command not specified for target %s", name)
end
end
-- Wait untill it ends, possibly with timeout
---@param proc process Process object
---@param time any Time field, process.WAIT_INFINITE
function M:wait(proc, time)
return proc:wait(time)
end
-- Read the stdout, returns nil if process has stopped
---@param proc process Process object
function M:read_stdout(proc)
return proc:read_stdout()
end
-- Read the stderr
---@param proc process Process object
function M:read_stderr(proc)
return proc:read_stderr()
end
-- Kill the process
---@param proc process Process object
function M:kill(proc)
proc:kill()
end
-- Terminate the process
---@param proc process Process object
function M:terminate(proc)
proc:terminate()
end
return M