mirror of
https://github.com/Hilbis/Hilbish
synced 2025-03-13 18:00:41 +00:00
sammyette
e5eefb1d2d
changes the actual file format of docs to markup since that's basically what we have been using in the first place. the docgen command has been modified to write markdown headings with the function name and yaml metadata for easy consumption by hugo for the website. all other docs have been moved to markdown as well this is the main reason this is a "breaking" change users will have to reinstall hilbish (task uninstall and task install) to remove the old plaintext docs
108 lines
2.4 KiB
Lua
108 lines
2.4 KiB
Lua
--- hilbish.runner
|
|
local currentRunner = 'hybrid'
|
|
local runners = {}
|
|
|
|
-- lsp shut up
|
|
hilbish = hilbish
|
|
|
|
--- Get a runner by name.
|
|
--- @param name string
|
|
--- @return table
|
|
function hilbish.runner.get(name)
|
|
local r = runners[name]
|
|
|
|
if not r then
|
|
error(string.format('runner %s does not exist', name))
|
|
end
|
|
|
|
return r
|
|
end
|
|
|
|
--- Adds a runner to the table of available runners. If runner is a table,
|
|
--- it must have the run function in it.
|
|
--- @param name string
|
|
--- @param runner function | table
|
|
function hilbish.runner.add(name, runner)
|
|
if type(name) ~= 'string' then
|
|
error 'expected runner name to be a table'
|
|
end
|
|
|
|
if type(runner) == 'function' then
|
|
runner = {run = runner} -- this probably looks confusing
|
|
end
|
|
|
|
if type(runner) ~= 'table' then
|
|
error 'expected runner to be a table or function'
|
|
end
|
|
|
|
if runners[name] then
|
|
error(string.format('runner %s already exists', name))
|
|
end
|
|
|
|
hilbish.runner.set(name, runner)
|
|
end
|
|
|
|
--- Sets a runner by name. The runner table must have the run function in it.
|
|
--- @param name string
|
|
--- @param runner table
|
|
function hilbish.runner.set(name, runner)
|
|
if not runner.run or type(runner.run) ~= 'function' then
|
|
error 'run function in runner missing'
|
|
end
|
|
|
|
runners[name] = runner
|
|
end
|
|
|
|
--- Executes cmd with a runner. If runnerName isn't passed, it uses
|
|
--- the user's current runner.
|
|
--- @param cmd string
|
|
--- @param runnerName string?
|
|
--- @return string, number, string
|
|
function hilbish.runner.exec(cmd, runnerName)
|
|
if not runnerName then runnerName = currentRunner end
|
|
|
|
local r = hilbish.runner.get(runnerName)
|
|
|
|
return r.run(cmd)
|
|
end
|
|
|
|
--- Sets the current interactive/command line runner mode.
|
|
--- @param name string
|
|
function hilbish.runner.setCurrent(name)
|
|
local r = hilbish.runner.get(name)
|
|
currentRunner = name
|
|
|
|
hilbish.runner.setMode(r.run)
|
|
end
|
|
|
|
hilbish.runner.add('hybrid', function(input)
|
|
local cmdStr = hilbish.aliases.resolve(input)
|
|
|
|
local res = hilbish.runner.lua(cmdStr)
|
|
if not res.err then
|
|
return res
|
|
end
|
|
|
|
return hilbish.runner.sh(input)
|
|
end)
|
|
|
|
hilbish.runner.add('hybridRev', function(input)
|
|
local res = hilbish.runner.sh(input)
|
|
if not res.err then
|
|
return res
|
|
end
|
|
|
|
local cmdStr = hilbish.aliases.resolve(input)
|
|
return hilbish.runner.lua(cmdStr)
|
|
end)
|
|
|
|
hilbish.runner.add('lua', function(input)
|
|
local cmdStr = hilbish.aliases.resolve(input)
|
|
return hilbish.runner.lua(cmdStr)
|
|
end)
|
|
|
|
hilbish.runner.add('sh', function(input)
|
|
return hilbish.runner.sh(input)
|
|
end)
|
|
|