This repository has been archived by the owner. It is now read-only.
Go library for accessing the Librato API
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
librato
.travis.yml
CONTRIBUTING.markdown
LICENSE
README.markdown

README.markdown

THIS PROJECT IS NO LONGER MAINTAINED

go-librato

go-librato is a Go client library for accessing the Librato API.

Documentation: GoDoc
Build Status: Build Status

go-travis requires Go version 1.5 or later. It may work with earlier versions, but this is not supported and new functionality that breaks this will not be considered a breaking change.

Usage

import "github.com/henrikhodne/go-librato"

Construct a new Librato client, then use the various services on the client to access different parts of the Librato API. For example, to list all spaces:

client := librato.NewClient("me@example.com", "your-librato-token")
spaces, _, err := client.Spaces.List(nil)

Some API methods have optional parameters that can be passed. For example, to list spaces with names that match "foobar":

client := librato.NewClient("me@example.com", "your-librato-token")
opt := &librato.SpaceListOptions{Name: "foobar"}
spaces, _, err := client.Spaces.List(opt)

Authentication

You need to get an API token for the account you want to access Librato as before using the API. You can generate API tokens in your account settings. You then pass the email address of your account and the API token into the NewClient function:

client := librato.NewClient("your-email", "your-librato-token")

Roadmap

API methods will likely be implemented as they are needed, but the plan is to eventually have full coverage of the API, so contributions are always welcome.

License

This library is distributes under the MIT license found in the LICENSE file.