the event emitter
the event emitter
Bait is the event emitter for Hilbish. Much like Node.js and
its events system, many actions in Hilbish emit events.
Unlike Node.js, Hilbish events are global. So make sure to
diff --git a/versions/doc-improvements/docs/api/commander/index.html b/versions/doc-improvements/docs/api/commander/index.html
index e11ebd0..174ef4a 100644
--- a/versions/doc-improvements/docs/api/commander/index.html
+++ b/versions/doc-improvements/docs/api/commander/index.html
@@ -1,7 +1,7 @@
library for custom commands
library for custom commands
Commander is the library which handles Hilbish commands. This makes the user able to add Lua-written commands to their shell without making a separate script in a bin folder. Instead, you may simply use the Commander diff --git a/versions/doc-improvements/docs/api/fs/index.html b/versions/doc-improvements/docs/api/fs/index.html index 1077634..ce95774 100644 --- a/versions/doc-improvements/docs/api/fs/index.html +++ b/versions/doc-improvements/docs/api/fs/index.html @@ -1,7 +1,7 @@
filesystem interaction and functionality library
filesystem interaction and functionality library
The fs module provides filesystem functions to Hilbish. While Lua’s standard
library has some I/O functions, they’re missing a lot of the basics. The fs
library offers more functions and will work on any operating system Hilbish does.
command aliasing
command aliasing
The alias interface deals with all command aliases in Hilbish.
| add(alias, cmd) | This is an alias (ha) for the hilbish.alias function. |
| delete(name) | Removes an alias. |
| list() -> table<string, string> | Get a table of all aliases, with string keys as the alias and the value as the command. |
| resolve(alias) -> command (string) | Tries to resolve an alias to its command. |
This is an alias (ha) for the hilbish.alias function.
tab completions
tab completions
The completions interface deals with tab completions.
| call(name, query, ctx, fields) -> completionGroups (table), prefix (string) | Calls a completer function. This is mainly used to call |
| handler(line, pos) | The handler function is the callback for tab completion in Hilbish. |
| bins(query, ctx, fields) -> entries (table), prefix (string) | Returns binary/executale completion candidates based on the provided query. |
| files(query, ctx, fields) -> entries (table), prefix (string) | Returns file completion candidates based on the provided query. |
Calls a completer function. This is mainly used to call
a command completer, which will have a name in the form
of command.name, example: command.git.
You can check doc completions for info on the completionGroups return value.
interactions for Hilbish's line reader
interactions for Hilbish's line reader
The hilbish.editor interface provides functions to directly interact with the line editor in use.
| getLine() -> string | Returns the current input line. |
| getVimRegister(register) -> string | Returns the text that is at the register. |
| insert(text) | Inserts text into the line. |
| getChar() -> string | Reads a keystroke from the user. This is in a format |
| setVimRegister(register, text) | Sets the vim register at register to hold the passed text. |
command history
command history
The history interface deals with command history. This includes the ability to override functions to change the main method of saving history.
background job management
background job management
Manage interactive jobs in Hilbish via Lua.
Jobs are the name of background tasks/commands. A job can be started via interactive usage or with the functions defined below for use in external runners.
| add(cmdstr, args, execPath) | Adds a new job to the job table. Note that this does not immediately run it. |
| all() -> table<@Job> | Returns a table of all job objects. |
| disown(id) | Disowns a job. This deletes it from the job table. |
| get(id) -> @Job | Get a job object via its ID. |
| last() -> @Job | Returns the last added job from the table. |
native module loading
native module loading
The hilbish.module interface provides a function to load Hilbish plugins/modules. Hilbish modules are Go-written plugins (see https://pkg.go.dev/plugin diff --git a/versions/doc-improvements/docs/api/hilbish/hilbish.os/index.html b/versions/doc-improvements/docs/api/hilbish/hilbish.os/index.html index 73b1bdb..86f6a60 100644 --- a/versions/doc-improvements/docs/api/hilbish/hilbish.os/index.html +++ b/versions/doc-improvements/docs/api/hilbish/hilbish.os/index.html @@ -1,7 +1,7 @@
OS Info
OS Info
The os interface provides simple text information properties about
the current OS on the systen. This mainly includes the name and
version.
interactive command runner customization
interactive command runner customization
The runner interface contains functions that allow the user to change how Hilbish interprets interactive input. Users can add and change the default runner for interactive input to any diff --git a/versions/doc-improvements/docs/api/hilbish/hilbish.timers/index.html b/versions/doc-improvements/docs/api/hilbish/hilbish.timers/index.html index eccdd5c..e995ddc 100644 --- a/versions/doc-improvements/docs/api/hilbish/hilbish.timers/index.html +++ b/versions/doc-improvements/docs/api/hilbish/hilbish.timers/index.html @@ -1,7 +1,7 @@
timeout and interval API
timeout and interval API
If you ever want to run a piece of code on a timed interval, or want to wait a few seconds, you don’t have to rely on timing tricks, as Hilbish has a timer API to set intervals and timeouts.
These are the simple functions hilbish.interval and hilbish.timeout (doc
diff --git a/versions/doc-improvements/docs/api/hilbish/hilbish.userdir/index.html b/versions/doc-improvements/docs/api/hilbish/hilbish.userdir/index.html
index a9c0858..35c6d1d 100644
--- a/versions/doc-improvements/docs/api/hilbish/hilbish.userdir/index.html
+++ b/versions/doc-improvements/docs/api/hilbish/hilbish.userdir/index.html
@@ -1,7 +1,7 @@
user-related directories
user-related directories
This interface just contains properties to know about certain user directories. It is equivalent to XDG on Linux and gets the user’s preferred directories for configs and data.
the core Hilbish API
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 of cmd to orig |
| appendPath(dir) | Appends dir to $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. |
| 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
Welcome to the API documentation for Hilbish. This documents Lua functions +
Welcome to the API documentation for Hilbish. This documents Lua functions provided by Hilbish.
low level terminal library
low level terminal library
The terminal library is a simple and lower level library for certain terminal interactions.
| restoreState() | Restores the last saved state of the terminal |
| saveState() | Saves the current state of the terminal |
| setRaw() | Puts the terminal in raw mode |
| size() | Gets the dimensions of the terminal. Returns a table with width and height |
Restores the last saved state of the terminal