Update README

Author: Prem Ramanathan

README.md

@@ -1,11 +1,31 @@
-# Kill Bill go client library
+# Kill Bill go client library and kill bill command line
+This repository contains killbill go client library (kbclient)
+and killbill command line tool (kbcmd)
 
-This is a basic implementation of a client library written in go to interract with Kill Bill.
+## Kill bill go client library
+Kill bill go client library is a go package that can be used to connect to
+kill bill.
 
-The http layer has been adapated from the existing [napping](https://github.com/jmcvetta/napping) go repository (which was itself inspired by Python's excellent [Requests](http://docs.python-requests.org/en/latest/) library.
+### Install
+```bash
+go get -u src/github.com/killbill/kbcli/kbclient
+```
 
-# Status
+### Creating new client
+```go
+    trp := httptransport.New("127.0.0.1:8080", "", nil)
+    // Add text/xml producer which is not handled by openapi runtime.
+    trp.Producers["text/xml"] = runtime.TextProducer()
+    // Set this to true to dump http messages
+    trp.Debug = false
+    authWriter := httptransport.BasicAuth("admin"/*username*/, "password" /**password*/)
+    client := kbclient.New(trp, strfmt.Default, authWriter, kbclient.KillbillDefaults{})
 
-Only a few APIs have been implemented so far, mostly around payments call. There is an [example](https://github.com/sbrossie/kbcli/blob/master/examples/payments.go) which using go concurrency feature to throw some load at an existing running Kill Bill instance.
+```
 
+Look at the [complete example here](examples/listaccounts/main.go).
+For more examples, look at [kbcmd tool](kbcmd/README.md).
 
+## Kill bill command line tool (kbcmd)
+kbcmd is a command line tool that uses the go client library. This tool can do many of the
+kill bill operations. More details are [available here in README](kbcmd/README.md).

examples/listaccounts/main.go

@@ -0,0 +1,50 @@
+package main
+
+import (
+	"context"
+	"fmt"
+
+	"github.com/go-openapi/runtime"
+	httptransport "github.com/go-openapi/runtime/client"
+	"github.com/go-openapi/strfmt"
+	"github.com/killbill/kbcli/kbclient"
+	"github.com/killbill/kbcli/kbclient/account"
+)
+
+// NewClient creates new kill bill client
+func NewClient() *kbclient.KillBill {
+	trp := httptransport.New("127.0.0.1:8080", "", nil)
+	// Add text/xml producer which is not handled by openapi runtime.
+	trp.Producers["text/xml"] = runtime.TextProducer()
+	// Set this to true to dump http messages
+	trp.Debug = false
+	authWriter := httptransport.BasicAuth("admin" /*username*/, "password" /**password*/)
+	client := kbclient.New(trp, strfmt.Default, authWriter, kbclient.KillbillDefaults{})
+
+	// Set defaults. You can override them in each API call.
+	apiKey := "bob"
+	apiSecret := "lazar"
+	createdBy := "John Doe"
+	comment := "Created by John Doe"
+	reason := ""
+
+	client.SetDefaults(kbclient.KillbillDefaults{
+		APIKey:    &apiKey,
+		APISecret: &apiSecret,
+		CreatedBy: &createdBy,
+		Comment:   &comment,
+		Reason:    &reason,
+	})
+	return client
+}
+
+func main() {
+	c := NewClient()
+	resp, err := c.Account.GetAccounts(context.Background(), &account.GetAccountsParams{})
+	if err != nil {
+		panic(err)
+	}
+	for _, acc := range resp.Payload {
+		fmt.Printf("%s %s %s\n", acc.AccountID, acc.ExternalKey, acc.Email)
+	}
+}

kbcmd/README.md

@@ -5,15 +5,14 @@ to talk to killbill.
 
 ## Installing
 ```bash
-cd $GOPATH
 go get -u src/github.com/killbill/kbcli/kbcmd
 go install src/github.com/killbill/kbcli/kbcmd
 
 # For bash completion
 source src/github.com/killbill/kbcli/kbcmd/bash-autocomplete
 
 # If you haven't added Go bin path to PATH
-export PATH=$PWD/bin:$PATH
+export PATH=$GOPATH/bin:$PATH
 ```
 
 ## Running the command