terraform/vendor/github.com/digitalocean/godo
Paul Hinze 8209b40526 vendor: Recapture deps w/ latest godep
The original contents of `vendor` were inadvertently captured with an
older version of `godep`. Here, we recapture dependencies by running the
following:

```
godep restore -v
cat Godeps/Godeps.json | jq -r '.Deps[].ImportPath' | xargs godep update -v
```

The newer godep makes the following changes as it captures dependencies:

 * Skips test files
 * Copies `LICENSE` / `PATENTS` files

There is also an additional diff in `golang.org/x/sys/unix` that looks
very similar to the diff between `master..c65f27f` in that repo, so I'm
guessing that dependency was accidentally captured from master instead
of the commit saved to `Godeps.json`.

All in all, these changes should all be "more correct" and result in
smaller diffs for any future updates made to dependencies.
2016-02-10 10:45:16 -06:00
..
util vendor: Recapture deps w/ latest godep 2016-02-10 10:45:16 -06:00
.travis.yml Vendor all dependencies w/ Godep 2016-01-29 15:08:48 -06:00
CONTRIBUTING.md Vendor all dependencies w/ Godep 2016-01-29 15:08:48 -06:00
LICENSE.txt Vendor all dependencies w/ Godep 2016-01-29 15:08:48 -06:00
README.md Vendor all dependencies w/ Godep 2016-01-29 15:08:48 -06:00
account.go Vendor all dependencies w/ Godep 2016-01-29 15:08:48 -06:00
action.go Vendor all dependencies w/ Godep 2016-01-29 15:08:48 -06:00
doc.go Vendor all dependencies w/ Godep 2016-01-29 15:08:48 -06:00
domains.go Vendor all dependencies w/ Godep 2016-01-29 15:08:48 -06:00
droplet_actions.go Vendor all dependencies w/ Godep 2016-01-29 15:08:48 -06:00
droplets.go Vendor all dependencies w/ Godep 2016-01-29 15:08:48 -06:00
errors.go Vendor all dependencies w/ Godep 2016-01-29 15:08:48 -06:00
floating_ips.go Vendor all dependencies w/ Godep 2016-01-29 15:08:48 -06:00
floating_ips_actions.go Vendor all dependencies w/ Godep 2016-01-29 15:08:48 -06:00
godo.go Vendor all dependencies w/ Godep 2016-01-29 15:08:48 -06:00
image_actions.go Vendor all dependencies w/ Godep 2016-01-29 15:08:48 -06:00
images.go Vendor all dependencies w/ Godep 2016-01-29 15:08:48 -06:00
keys.go Vendor all dependencies w/ Godep 2016-01-29 15:08:48 -06:00
links.go Vendor all dependencies w/ Godep 2016-01-29 15:08:48 -06:00
regions.go Vendor all dependencies w/ Godep 2016-01-29 15:08:48 -06:00
sizes.go Vendor all dependencies w/ Godep 2016-01-29 15:08:48 -06:00
strings.go Vendor all dependencies w/ Godep 2016-01-29 15:08:48 -06:00
timestamp.go Vendor all dependencies w/ Godep 2016-01-29 15:08:48 -06:00

README.md

Build Status

Godo

Godo is a Go client library for accessing the DigitalOcean V2 API.

You can view the client API docs here: http://godoc.org/github.com/digitalocean/godo

You can view DigitalOcean API docs here: https://developers.digitalocean.com/documentation/v2/

Usage

import "github.com/digitalocean/godo"

Create a new DigitalOcean client, then use the exposed services to access different parts of the DigitalOcean API.

Authentication

Currently, Personal Access Token (PAT) is the only method of authenticating with the API. You can manage your tokens at the DigitalOcean Control Panel Applications Page.

You can then use your token to create a new client:

import "golang.org/x/oauth2"

pat := "mytoken"
type TokenSource struct {
    AccessToken string
}

func (t *TokenSource) Token() (*oauth2.Token, error) {
    token := &oauth2.Token{
        AccessToken: t.AccessToken,
    }
    return token, nil
}

tokenSource := &TokenSource{
    AccessToken: pat,
}
oauthClient := oauth2.NewClient(oauth2.NoContext, tokenSource)
client := godo.NewClient(oauthClient)

Examples

To create a new Droplet:

dropletName := "super-cool-droplet"

createRequest := &godo.DropletCreateRequest{
    Name:   dropletName,
    Region: "nyc3",
    Size:   "512mb",
    Image: godo.DropletCreateImage{
        Slug: "ubuntu-14-04-x64",
    },
}

newDroplet, _, err := client.Droplets.Create(createRequest)

if err != nil {
    fmt.Printf("Something bad happened: %s\n\n", err)
    return err
}

Pagination

If a list of items is paginated by the API, you must request pages individually. For example, to fetch all Droplets:

func DropletList(client *godo.Client) ([]godo.Droplet, error) {
    // create a list to hold our droplets
    list := []godo.Droplet{}

    // create options. initially, these will be blank
    opt := &godo.ListOptions{}
    for {
        droplets, resp, err := client.Droplets.List(opt)
        if err != nil {
            return nil, err
        }

        // append the current page's droplets to our list
        for _, d := range droplets {
            list = append(list, d)
        }

        // if we are at the last page, break out the for loop
        if resp.Links == nil || resp.Links.IsLastPage() {
            break
        }

        page, err := resp.Links.CurrentPage()
        if err != nil {
            return nil, err
        }

        // set the page we want for the next request
        opt.Page = page + 1
    }

    return list, nil
}

Versioning

Each version of the client is tagged and the version is updated accordingly.

Since Go does not have a built-in versioning, a package management tool is recommended - a good one that works with git tags is gopkg.in.

To see the list of past versions, run git tag.

Documentation

For a comprehensive list of examples, check out the API documentation.

For details on all the functionality in this library, see the GoDoc documentation.

Contributing

We love pull requests! Please see the contribution guidelines.