Clients
The following table lists Boomack API clients ordered by platform or programming language respectively.
| Platform / Language | Client |
|---|---|
| Shell | Boomack Client CLI (boom) |
| Shell | Boomack Fast Client CLI (bo) |
| Visual Studio Code | Boomack VS Code Extension |
| NodeJS, JavaScript | BoomackJS |
| .NET, C# | NBoomackClient |
| Rust | Boomack Library for Rust |
The Boomack API can be used directly, e. g. with cURL or with an HTTP client library in the programming language of your choice. But, using one of the client tools or libraries listed here makes your life much easier.
For starters, the Client CLI (boom) is certainly a good choice, to get familiar with the system. It can be used in a shell or command line, and therefore, in shell scripts. If the NodeJS-based client is too slow for your usecase, try the Fast Client CLI (bo). But it might not implement all features, the NodeJS-based CLI provides.
If you like to interact with a Boomack Server from your programming language, you need to check if a library for your language is already listed here. If not, you can still use the API Reference to use a generic HTTP client library in you language to make the desired requests — only with a little less comfort.
Boomack Client CLI (boom)
The Boomack Client CLI (boom command) is implemented in JavaScript for NodeJS,
and is based on the BoomackJS library.
It precedes the faster Rust version and serves as a reference implementation.
New features for the client CLI are first implemented and evaluated in the NodeJS version,
before they get eventually ported to the faster Rust version.
Take a look at the documentation for a description of the CLI with its sub-commands and options.
npm install --global boomack-cli
You can find the documentation here: https://boomack.com/docs/boomack-client-cli.html
Boomack Fast Client CLI (bo)
The Boomack Fast Client CLI (bo command) is implemented in Rust.
Take a look at the documentation for a description of the CLI with its sub-commands and options.
To install it under Linux, run the following one-liner.
It will download the compressed binary, verify the checksum,
extract the archive, and install the binary into /usr/local/bin.
wget -q -O - https://download.boomack.com/fast-client-cli/install.sh | sh
Additionally, you can manually download the compressed binary from the download page.
If you have a Rust development environment, you can also install it from source:
cargo install boomack-cli
The Rust version might miss some features the NodeJS based Boomack Client CLI provides. But in general the command line arguments are kept compatible. Therefore, in most cases it can serve as a faster drop-in replacement. Its main purpose is to allow performant shell scripted interactions with the Boomack Server.
You can find the documentation here: https://boomack.com/docs/boomack-client-cli.html
Boomack VS Code Extension
The Boomack VS Code Extension allows interacting with a Boomack Server from within the Visual Studio Code IDE. It also includes the Boomack Server, so that a local server can be run from within the IDE as well.
The extension ID is mastersign.boomack-vscode.
The extension can be installed from within VS code by simply searching for Boomack in the extension panel.
BoomackJS
A JavaScript library for NodeJS.
npm install --save boomack-js
You can find the documentation here: https://docs.boomack.com/client/boomack-js
NBoomackClient
A OS independent .NET library for .NET Standard 2.0 and therefore, usable in .NET Framework ≥ 4.6.1, .NET Core ≥ 2.0, .NET ≥ 5.0, Mono, and Xamarin.
dotnet add package NBoomackClient
You can find the documentation here: https://docs.boomack.com/client/NBoomackClient
Boomack Library for Rust
A Rust library, based on ureq and serde, making it easy to communicate with a Boomack Server.
Add the following line(s) to your Cargo.toml:
[dependencies]
boomack = 0.3
Or, call cargo add:
cargo add boomack
You can find the documentation here: https://docs.rs/boomack/