sbanken-cli

A fast terminal client written in rust to use with sbanken's open APIs.

The client currently supports all the APIs available to date.

Link to Sbanken's swagger documentation:

• Sbanken Bank API
• Sbanken Customers API

Feedback and PRs are welcomed.

Requirements

Requires Rust 1.26 or newer.

To build from source and installing, you can head over to rustup to get started.

How to build from source and installing

$ cargo build --release
$ mv ./target/release/sbanken-cli /usr/local/bin

Environment variables

SBANKEN_CLIENT_ID, SBANKEN_SECRET and SBANKEN_CUSTOMER_ID are required environment-variables.

SBANKEN_CLIENT_ID and SBANKEN_SECRET are provided through the developer-pages on https://sbanken.no/. Navigate through Mine instillinger > Sbanken Beta > Utviklerportalen. SBANKEN_CUSTOMER_ID is your social security number.

Set SBANKEN_COLOR=1 if you want colored output.

Auto-complete scripts

Auto-complete scripts can be generated through the cli.

Bash:

$ sbanken-cli generate-bash-completions >> ~/.bashrc

Fish:

$ sbanken-cli generate-fish-completions > ~/.config/fish/completions/sbanken-cli.fish

Use envchain to manage your secrets for additional security (optional)

An optional opinionated way to store your credentials could be using envchain for added security. How you store your secrets are entirely up to you. Storing your credentials i.e. .bashrc is a-okey.

Once installed you have installed envchain, do the following:

$ envchain --set sbanken SBANKEN_CLIENT_ID SBANKEN_SECRET SBANKEN_CUSTOMER_ID SBANKEN_COLOR

Using sbanken-cli with envchain will then become:

$ envchain sbanken sbanken-cli transactions -a <account> -f 2017-10-15 -t 2017-10-20 -l 30

Using envchain, will be prompted for your credentials based on your configuration and preference.

If that's a little tedious for your taste, you can always make it convenient:

Bash example

sbanken-cli() {
    envchain sbanken sbanken-cli "@"
}

Fish example

function sbanken-cli
    envchain sbanken sbanken-cli $argv
end

Interactive mode

For the time being sbanken-cli have interactive mode for two sub-commands.

$ sbanken-cli transfer -i
$ sbanken-cli account -i

The interactive mode spawns a sub-process of a fuzzy-matcher and lets you select your choice of the ones available.

Currently, hard-dependency of fzf (fuzzy-matching), but it can be done with any fuzzy-matcher that takes in options in form of lines on stdin and outputs the selected option/line on stdout.

For instructions to install fzf click here.

Make a PR if you would like anything other than fzf supported.