GleamyShell
GleamyShell is a cross-platform Gleam library for executing shell commands that supports multiple targets (Erlang, Deno, and Node.js).
When to use GleamyShell?
GleamyShell provides the ability to execute shell commands on multiple targets. While this might sound amazing, supporting targets with fundamentally different concurrency models and APIs shrinks the common ground significantly.
In order to keep the public API homogenous across different targets, GleamyShell only provides synchronous bindings and a minimal API with common functionalities supported by those targets.
You should use GleamyShell if
- you need or want to support multiple targets and/or
- synchronous shell command execution is not a concern and most importantly
- you don’t have special use cases that GleamyShell’s API cannot serve*.
* Feel free to open an issue on GitHub to discuss your feature request. GleamyShell only implements features that can provide the same behavior on all supported targets. Yours might be one of them.
Usage
Getting the current username
let result = gleamyshell.execute("whoami", [])
case result {
Ok(username) ->
io.println("Hello there, " <> string.trim(username) <> "!")
Error(Failure(output, exit_code)) ->
io.println(
"Whoops!\nError ("
<> int.to_string(exit_code)
<> "): "
<> string.trim(output),
)
Error(Abort(_)) -> io.println("Something went terribly wrong.")
}
Getting the current working directory
case gleamyshell.cwd() {
Some(working_directory) ->
io.println("Current working directory: " <> working_directory)
None ->
io.println("Couldn't detect the current working directory.")
}
Choosing what to do depending operating system
case gleamyshell.os() {
Windows -> io.println("Doing stuff on Windows.")
Unix(Darwin) -> io.println("Doing stuff on macOS.")
Unix(_) -> io.println("Doing stuff on a Unix(-like) system.")
}
Changelog
Take a look at the changelog to get an overview of each release and its changes.
Contribution Guidelines
More information can be found here.
License
GleamyShell is licensed under the MIT license.