open-consul/vendor/github.com/packethost/packngo
Jeff Mitchell b43800125c
Update vendoring from go mod. (#5566)
2019-03-26 17:50:42 -04:00
..
.drone.yml Update vendoring from go mod. (#5566) 2019-03-26 17:50:42 -04:00
.gitignore Update vendoring from go mod. (#5566) 2019-03-26 17:50:42 -04:00
CHANGELOG.md Vendoring update for go-discover. (#4412) 2018-07-25 16:21:04 -07:00
LICENSE.txt Vendoring update for go-discover. (#4412) 2018-07-25 16:21:04 -07:00
README.md Vendoring update for go-discover. (#4412) 2018-07-25 16:21:04 -07:00
billing_address.go Vendoring update for go-discover. (#4412) 2018-07-25 16:21:04 -07:00
devices.go Vendoring update for go-discover. (#4412) 2018-07-25 16:21:04 -07:00
email.go Vendoring update for go-discover. (#4412) 2018-07-25 16:21:04 -07:00
facilities.go Vendoring update for go-discover. (#4412) 2018-07-25 16:21:04 -07:00
ip.go Vendoring update for go-discover. (#4412) 2018-07-25 16:21:04 -07:00
operatingsystems.go Vendoring update for go-discover. (#4412) 2018-07-25 16:21:04 -07:00
organizations.go Vendoring update for go-discover. (#4412) 2018-07-25 16:21:04 -07:00
packngo.go Vendoring update for go-discover. (#4412) 2018-07-25 16:21:04 -07:00
payment_methods.go Vendoring update for go-discover. (#4412) 2018-07-25 16:21:04 -07:00
plans.go Vendoring update for go-discover. (#4412) 2018-07-25 16:21:04 -07:00
ports.go Vendoring update for go-discover. (#4412) 2018-07-25 16:21:04 -07:00
projects.go Update vendoring from go mod. (#5566) 2019-03-26 17:50:42 -04:00
rate.go Vendoring update for go-discover. (#4412) 2018-07-25 16:21:04 -07:00
spotmarket.go Vendoring update for go-discover. (#4412) 2018-07-25 16:21:04 -07:00
sshkeys.go Vendoring update for go-discover. (#4412) 2018-07-25 16:21:04 -07:00
timestamp.go Vendoring update for go-discover. (#4412) 2018-07-25 16:21:04 -07:00
user.go Vendoring update for go-discover. (#4412) 2018-07-25 16:21:04 -07:00
utils.go Vendoring update for go-discover. (#4412) 2018-07-25 16:21:04 -07:00
virtualnetworks.go Vendoring update for go-discover. (#4412) 2018-07-25 16:21:04 -07:00
volumes.go Vendoring update for go-discover. (#4412) 2018-07-25 16:21:04 -07:00

README.md

packngo

Packet Go Api Client

Installation

go get github.com/packethost/packngo

Usage

To authenticate to the Packet API, you must have your API token exported in env var PACKET_API_TOKEN.

This code snippet initializes Packet API client, and lists your Projects:

package main

import (
	"log"

	"github.com/packethost/packngo"
)

func main() {
	c, err := packngo.NewClient()
	if err != nil {
		log.Fatal(err)
	}

	ps, _, err := c.Projects.List(nil)
	if err != nil {
		log.Fatal(err)
	}
	for _, p := range ps {
		log.Println(p.ID, p.Name)
	}
}

This lib is used by the official terraform-provider-packet.

You can also learn a lot from the *_test.go sources. Almost all out tests touch the Packet API, so you can see how auth, querying and POSTing works. For example devices_test.go.

Acceptance Tests

If you want to run tests against the actual Packet API, you must set envvar PACKET_TEST_ACTUAL_API to non-empty string for the go test. The device tests wait for the device creation, so it's best to run a few in parallel.

To run a particular test, you can do

$ PACKNGO_TEST_ACTUAL_API=1 go test -v -run=TestAccDeviceBasic

If you want to see HTTP requests, set the PACKNGO_DEBUG env var to non-empty string, for example:

$ PACKNGO_DEBUG=1 PACKNGO_TEST_ACTUAL_API=1 go test -v -run=TestAccVolumeUpdate

Committing

Before committing, it's a good idea to run gofmt -w *.go. (gofmt)