Hilbish/emmyLuaDocs/hilbish.lua

302 lines
9.7 KiB
Lua
Raw Normal View History

2022-02-25 22:00:39 +00:00
--- @meta
local hilbish = {}
--- This is an alias (ha) for the `hilbish.alias` function.
--- @param alias string
--- @param cmd string
function hilbish.aliases.add(alias, cmd) end
--- This is the same as the `hilbish.runnerMode` function. It takes a callback,
--- which will be used to execute all interactive input.
--- In normal cases, neither callbacks should be overrided by the user,
--- as the higher level functions listed below this will handle it.
2022-12-21 01:00:31 +00:00
--- @param cb function
function hilbish.runner.setMode(cb) end
--- Calls a completer function. This is mainly used to call
--- a command completer, which will have a `name` in the form
2023-02-07 22:19:24 +00:00
--- of `command.name`, example: `command.git`.
--- You can check `doc completions` for info on the `completionGroups` return value.
2022-12-21 01:00:31 +00:00
--- @param name string
--- @param query string
--- @param ctx string
--- @param fields table
function hilbish.completions.call(name, query, ctx, fields) end
--- The handler function is the callback for tab completion in Hilbish.
--- You can check the completions doc for more info.
2022-12-21 01:00:31 +00:00
--- @param line string
--- @param pos string
function hilbish.completions.handler(line, pos) end
--- Returns the current input line.
function hilbish.editor.getLine() end
--- Returns the text that is at the register.
2022-12-21 01:00:31 +00:00
--- @param register string
function hilbish.editor.getVimRegister(register) end
--- Inserts text into the line.
function hilbish.editor.insert(text) end
2023-07-09 20:49:25 +00:00
--- Reads a keystroke from the user. This is in a format
2023-07-10 03:41:25 +00:00
--- of something like Ctrl-L..
2023-07-09 20:49:25 +00:00
function hilbish.editor.getChar() end
--- Sets the vim register at `register` to hold the passed text.
2022-12-21 01:00:31 +00:00
--- @param register string
--- @param text string
function hilbish.editor.setVimRegister(register, text) end
2022-03-20 21:54:55 +00:00
--- Sets an alias of `cmd` to `orig`
2022-02-26 15:37:02 +00:00
--- @param cmd string
--- @param orig string
function hilbish.alias(cmd, orig) end
2022-02-25 22:00:39 +00:00
--- Appends `dir` to $PATH
2022-02-26 15:37:02 +00:00
--- @param dir string|table
function hilbish.appendPath(dir) end
2022-02-25 22:00:39 +00:00
--- Registers a completion handler for `scope`.
--- A `scope` is currently only expected to be `command.<cmd>`,
--- replacing <cmd> with the name of the command (for example `command.git`).
2022-03-05 20:13:15 +00:00
--- `cb` must be a function that returns a table of "completion groups."
2022-04-23 01:26:03 +00:00
--- Check `doc completions` for more information.
2022-03-02 02:16:12 +00:00
--- @param scope string
--- @param cb function
function hilbish.complete(scope, cb) end
2022-02-25 22:00:39 +00:00
--- Returns the current directory of the shell
2023-01-18 10:39:26 +00:00
--- @returns string
2022-02-25 22:00:39 +00:00
function hilbish.cwd() end
--- Replaces running hilbish with `cmd`
2022-02-26 15:37:02 +00:00
--- @param cmd string
function hilbish.exec(cmd) end
2022-02-25 22:00:39 +00:00
--- Puts `fn` in a goroutine
2022-02-26 15:37:02 +00:00
--- @param fn function
2022-03-04 18:41:22 +00:00
function hilbish.goro(fn) end
2022-02-25 22:00:39 +00:00
2022-04-22 02:22:20 +00:00
--- Line highlighter handler. This is mainly for syntax highlighting, but in
--- reality could set the input of the prompt to *display* anything. The
--- callback is passed the current line and is expected to return a line that
--- will be used as the input display.
2023-04-15 14:36:56 +00:00
--- Note that to set a highlighter, one has to override this function.
--- Example:
--- ```
--- function hilbish.highlighter(line)
--- return line:gsub('"%w+"', function(c) return lunacolors.green(c) end)
--- end
--- ```
--- This code will highlight all double quoted strings in green.
2022-04-22 02:22:20 +00:00
--- @param line string
function hilbish.highlighter(line) end
--- The command line hint handler. It gets called on every key insert to
--- determine what text to use as an inline hint. It is passed the current
--- line and cursor position. It is expected to return a string which is used
--- as the text for the hint. This is by default a shim. To set hints,
--- override this function with your custom handler.
--- @param line string
2022-12-21 01:00:31 +00:00
--- @param pos number
2022-04-22 02:22:20 +00:00
function hilbish.hinter(line, pos) end
2022-03-26 21:34:42 +00:00
2022-04-21 16:19:31 +00:00
--- Sets the input mode for Hilbish's line reader. Accepts either emacs or vim
2022-03-02 02:16:12 +00:00
--- @param mode string
function hilbish.inputMode(mode) end
2022-03-02 02:01:22 +00:00
2022-04-12 23:37:39 +00:00
--- Runs the `cb` function every `time` milliseconds.
2023-01-18 10:39:26 +00:00
--- This creates a timer that starts immediately.
2022-02-26 15:37:02 +00:00
--- @param cb function
--- @param time number
2023-01-18 10:39:26 +00:00
--- @return Timer
2022-02-26 15:37:02 +00:00
function hilbish.interval(cb, time) end
2022-02-25 22:00:39 +00:00
--- Changes the continued line prompt to `str`
2022-02-26 15:37:02 +00:00
--- @param str string
2022-04-04 10:40:25 +00:00
function hilbish.multiprompt(str) end
2022-02-25 22:00:39 +00:00
--- Prepends `dir` to $PATH
2022-03-02 02:16:12 +00:00
--- @param dir string
function hilbish.prependPath(dir) end
2022-02-25 22:00:39 +00:00
--- Changes the shell prompt to `str`
--- There are a few verbs that can be used in the prompt text.
--- These will be formatted and replaced with the appropriate values.
--- `%d` - Current working directory
--- `%u` - Name of current user
--- `%h` - Hostname of device
2022-02-26 15:37:02 +00:00
--- @param str string
2022-12-21 01:00:31 +00:00
--- @param typ? string Type of prompt, being left or right. Left by default.
2022-04-13 14:14:06 +00:00
function hilbish.prompt(str, typ) end
2022-02-25 22:00:39 +00:00
--- Read input from the user, using Hilbish's line editor/input reader.
--- This is a separate instance from the one Hilbish actually uses.
--- Returns `input`, will be nil if ctrl + d is pressed, or an error occurs (which shouldn't happen)
2022-12-21 01:00:31 +00:00
--- @param prompt? string
--- @returns string|nil
2022-02-26 15:37:02 +00:00
function hilbish.read(prompt) end
2022-02-25 22:00:39 +00:00
--- Runs `cmd` in Hilbish's sh interpreter.
2022-04-04 10:40:25 +00:00
--- If returnOut is true, the outputs of `cmd` will be returned as the 2nd and
--- 3rd values instead of being outputted to the terminal.
2022-02-26 15:37:02 +00:00
--- @param cmd string
2022-12-21 01:00:31 +00:00
--- @param returnOut boolean
--- @returns number, string, string
function hilbish.run(cmd, returnOut) end
2022-02-25 22:00:39 +00:00
2022-03-20 19:16:13 +00:00
--- Sets the execution/runner mode for interactive Hilbish. This determines whether
--- Hilbish wll try to run input as Lua and/or sh or only do one of either.
--- Accepted values for mode are hybrid (the default), hybridRev (sh first then Lua),
--- sh, and lua. It also accepts a function, to which if it is passed one
--- will call it to execute user input instead.
2022-03-22 22:33:52 +00:00
--- @param mode string|function
function hilbish.runnerMode(mode) end
2022-03-20 19:16:13 +00:00
2023-01-18 10:39:26 +00:00
--- Runs the `cb` function after `time` in milliseconds.
--- This creates a timer that starts immediately.
2022-02-26 15:37:02 +00:00
--- @param cb function
--- @param time number
2023-01-18 10:39:26 +00:00
--- @returns Timer
2022-02-26 15:37:02 +00:00
function hilbish.timeout(cb, time) end
2022-02-25 22:00:39 +00:00
2023-01-18 10:39:26 +00:00
--- Checks if `name` is a valid command.
--- Will return the path of the binary, or a basename if it's a commander.
2022-12-21 01:00:31 +00:00
--- @param name string
2023-01-18 10:39:26 +00:00
--- @returns string
function hilbish.which(name) end
--- Puts a job in the background. This acts the same as initially running a job.
function hilbish.jobs:background() end
--- Returns binary/executale completion candidates based on the provided query.
2022-12-21 01:00:31 +00:00
--- @param query string
--- @param ctx string
--- @param fields table
function hilbish.completions.bins(query, ctx, fields) end
--- Returns file completion candidates based on the provided query.
2022-12-21 01:00:31 +00:00
--- @param query string
--- @param ctx string
--- @param fields table
function hilbish.completions.files(query, ctx, fields) end
--- Puts a job in the foreground. This will cause it to run like it was
--- executed normally and wait for it to complete.
function hilbish.jobs:foreground() end
--- Evaluates `cmd` as Lua input. This is the same as using `dofile`
--- or `load`, but is appropriated for the runner interface.
2022-12-21 01:00:31 +00:00
--- @param cmd string
function hilbish.runner.lua(cmd) end
2023-03-25 21:42:46 +00:00
--- Sets/toggles the option of automatically flushing output.
--- A call with no argument will toggle the value.
--- @param auto boolean|nil
function hilbish:autoFlush(auto) end
--- Flush writes all buffered input to the sink.
function hilbish:flush() end
2023-07-09 20:49:25 +00:00
--- Reads a liine of input from the sink.
2023-03-25 21:42:46 +00:00
--- @returns string
function hilbish:read() end
2023-07-09 20:49:25 +00:00
--- Reads all input from the sink.
--- @returns string
function hilbish:readAll() end
--- Writes data to a sink.
function hilbish:write(str) end
--- Writes data to a sink with a newline at the end.
function hilbish:writeln(str) end
--- Starts running the job.
function hilbish.jobs:start() end
--- Stops the job from running.
2023-01-18 10:59:10 +00:00
function hilbish.jobs:stop() end
--- Runs a command in Hilbish's shell script interpreter.
--- This is the equivalent of using `source`.
2022-12-21 01:00:31 +00:00
--- @param cmd string
function hilbish.runner.sh(cmd) end
--- Starts a timer.
function hilbish.timers:start() end
--- Stops a timer.
function hilbish.timers:stop() end
--- Removes an alias.
--- @param name string
function hilbish.aliases.delete(name) end
2022-12-21 01:00:31 +00:00
--- Get a table of all aliases, with string keys as the alias and the value as the command.
--- @returns table<string, string>
function hilbish.aliases.list() end
--- Tries to resolve an alias to its command.
--- @param alias string
2022-12-21 01:00:31 +00:00
--- @returns string
function hilbish.aliases.resolve(alias) end
--- Adds a new job to the job table. Note that this does not immediately run it.
2022-12-21 01:00:31 +00:00
--- @param cmdstr string
--- @param args table
--- @param execPath string
function hilbish.jobs.add(cmdstr, args, execPath) end
--- Returns a table of all job objects.
2022-12-21 01:00:31 +00:00
--- @returns table<Job>
function hilbish.jobs.all() end
--- Disowns a job. This deletes it from the job table.
2022-12-21 01:03:09 +00:00
--- @param id number
function hilbish.jobs.disown(id) end
--- Get a job object via its ID.
2022-12-21 01:00:31 +00:00
--- @param id number
--- @returns Job
function hilbish.jobs.get(id) end
--- Returns the last added job from the table.
2022-12-21 01:00:31 +00:00
--- @returns Job
function hilbish.jobs.last() end
--- Adds a command to the history.
--- @param cmd string
function hilbish.history.add(cmd) end
2023-02-07 22:19:24 +00:00
--- Retrieves all history.
--- @returns table
function hilbish.history.all() end
--- Deletes all commands from the history.
function hilbish.history.clear() end
--- Retrieves a command from the history based on the `idx`.
--- @param idx number
function hilbish.history.get(idx) end
--- Returns the amount of commands in the history.
--- @returns number
function hilbish.history.size() end
--- Creates a timer that runs based on the specified `time` in milliseconds.
2022-12-21 01:00:31 +00:00
--- The `type` can either be `hilbish.timers.INTERVAL` or `hilbish.timers.TIMEOUT`
--- @param type number
--- @param time number
--- @param callback function
function hilbish.timers.create(type, time, callback) end
--- Retrieves a timer via its ID.
2022-12-21 01:00:31 +00:00
--- @param id number
--- @returns Timer
function hilbish.timers.get(id) end
2022-03-01 23:00:20 +00:00
2022-02-25 22:00:39 +00:00
return hilbish