kbcmd

README

kbcmd - Kill bill command line

kbcmd is a command line client for killbill. kbcmd uses go client library to talk to killbill.

Prerequisites

For users new to go, you need to have go compiler installed. If not,

1. Install go from here
2. Follow the instructions here to setup your environment.
3. Tests your installation and verify everything works.

Installing kbcmd

go get -u github.com/killbill/kbcli
export GOPATH=~/go
cd $GOPATH/src/github.com/killbill/kbcli/kbcmd
go build

Install the kbcmd binary somewhere in the PATH.

For bash completion

source $GOPATH/src/github.com/killbill/kbcli/kbcmd/bash-autocomplete

On Linux the autocomplete file can be copied to /etc/bash_completion.d/kbcmd

Running kbcmd

export KB_API_KEY=bob
export KB_API_SECRET=lazar
export KB_API_CREATED_BY=$(whoami)
export KB_HOST=127.0.0.1:8080

kbcmd -h
# (or)
kbcmd <command> -h

Walkthrough: Create subscription and invoices

The following walkthrough will walk you through the steps to create new account and subscription and then generate invoice for it.

kbcmd walkthrough

Development

For development, clone the repository to your git workspace under $GOPATH/src/github.com/killbill/kbcli and then run go get -t ./... to install the dependencies. Visual Studio Code is recommmended IDE, but others work as well. Make sure to run the tests before submitting PR.