the core Hilbish API
The Hilbish module includes the core API, containing interfaces and functions which directly relate to shell functionality.
alias(cmd, orig) | Sets an alias, with a name of cmd to another command. |
appendPath(dir) | Appends the provided dir to the command path ($PATH ) |
complete(scope, cb) | Registers a completion handler for scope . |
cwd() -> string | Returns the current directory of the shell |
exec(cmd) | Replaces running hilbish with cmd |
goro(fn) | Puts fn in a goroutine |
highlighter(line) | Line highlighter handler. This is mainly for syntax highlighting, but in |
hinter(line, pos) | The command line hint handler. It gets called on every key insert to |
inputMode(mode) | Sets the input mode for Hilbish’s line reader. Accepts either emacs or vim |
interval(cb, time) -> @Timer | Runs the cb function every time milliseconds. |
multiprompt(str) | Changes the continued line prompt to str |
prependPath(dir) | Prepends dir to $PATH |
prompt(str, typ) | Changes the shell prompt to str |
read(prompt) -> input (string) | Read input from the user, using Hilbish’s line editor/input reader. |
run(cmd, returnOut) -> exitCode (number), stdout (string), stderr (string) | Runs cmd in Hilbish’s sh interpreter. |
runnerMode(mode) | Sets the execution/runner mode for interactive Hilbish. This determines whether |
timeout(cb, time) -> @Timer | Runs the cb function after time in milliseconds. |
which(name) -> string | Checks if name is a valid command. |
ver | The version of Hilbish |
goVersion | The version of Go that Hilbish was compiled with |
user | Username of the user |
host | Hostname of the machine |
dataDir | Directory for Hilbish data files, including the docs and default modules |
interactive | Is Hilbish in an interactive shell? |
login | Is Hilbish the login shell? |
vimMode | Current Vim input mode of Hilbish (will be nil if not in Vim input mode) |
exitCode | Exit code of the last executed command |
Sets an alias, with a name of cmd
to another command.
string
cmd
Name of the alias
string
orig
Command that will be aliased
1-- With this, "ga file" will turn into "git add file"
2hilbish.alias('ga', 'git add')
3
4-- Numbered substitutions are supported here!
5hilbish.alias('dircount', 'ls %1 | wc -l')
6-- "dircount ~" would count how many files are in ~ (home directory).
Appends the provided dir to the command path ($PATH
)
string|table
dir
Directory (or directories) to append to path
1hilbish.appendPath '~/go/bin'
2-- Will add ~/go/bin to the command path.
3
4-- Or do multiple:
5hilbush.appendPath {
6 '~/go/bin',
7 '~/.local/bin'
8}
Registers a completion handler for scope
.
A scope
is currently only expected to be command.<cmd>
,
replacing command.git
).cb
must be a function that returns a table of “completion groups.”
Check doc completions
for more information.
This function has no parameters.
Returns the current directory of the shell
This function has no parameters.
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.
Note that to set a highlighter, one has to override this function.
Example:
1function hilbish.highlighter(line)
2 return line:gsub('"%w+"', function(c) return lunacolors.green(c) end)
3end
This code will highlight all double quoted strings in green.
This function has no parameters.
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.
This function has no parameters.
Sets the input mode for Hilbish’s line reader. Accepts either emacs or vim
This function has no parameters.
Runs the cb
function every time
milliseconds.
This creates a timer that starts immediately.
This function has no parameters.
Changes the continued line prompt to str
This function has no parameters.
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
This function has no parameters.
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)
This function has no parameters.
Runs cmd
in Hilbish’s sh interpreter.
If returnOut is true, the outputs of cmd
will be returned as the 2nd and
3rd values instead of being outputted to the terminal.
This function has no parameters.
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.
This function has no parameters.
Runs the cb
function after time
in milliseconds.
This creates a timer that starts immediately.
This function has no parameters.
Checks if name
is a valid command.
Will return the path of the binary, or a basename if it’s a commander.
This function has no parameters.
A sink is a structure that has input and/or output to/from a desination.
Sets/toggles the option of automatically flushing output. A call with no argument will toggle the value.
Flush writes all buffered input to the sink.
Reads a liine of input from the sink.
Reads all input from the sink.
Writes data to a sink.
Writes data to a sink with a newline at the end.
Want to help improve this page? Create an issue.