go-pagerduty

go-pagerduty

PagerDuty API client in Go, primarily used by the PagerDuty provider in Terraform.

This project is a fork of heimweh/go-pagerduty.

Installation

go get github.com/nordcloud/go-pagerduty/pagerduty

Example usage

1. Add something like the following to a go project:

package main

import (
	"fmt"
	"os"

	"github.com/nordcloud/go-pagerduty/pagerduty"
)

func main() {
	client, err := pagerduty.NewClient(&pagerduty.Config{Token: os.Getenv("PAGERDUTY_TOKEN")})
	if err != nil {
		panic(err)
	}

	resp, raw, err := client.Users.List(&pagerduty.ListUsersOptions{})
	if err != nil {
		panic(err)
	}

	for _, user := range resp.Users {
		fmt.Println(user.Name)
	}

	// All calls returns the raw *http.Response for further inspection.
	fmt.Println(raw.Response.StatusCode)
}

1. run:

$ PAGERDUTY_TOKEN=<SECRET> go run <PATH/TO/PROJECT/WITH/ABOVE/CODE>/main.go

Caching support

Since some of the APIs implemented into this library doesn't offer a query mechanism for querying specific resources by their attributes, each time an implementation on the side of the Terraform Provider relies on that kind of logic, what it is done is to list all the resources of an specific entity and the lookup is executed in memory. Therefore, this leads to an inefficient use of the APIs, on top of that for use cases with a big amount of resources this repetitive API calls for lists of resources definitions start to pile up with the form of time consumption performance penalties that are nowadays causing uncomfortable experience for the Terraform Provider users.

APIs Currently supporting caching on go-pagerduty library

• Abilities
• Contact Methods
• Notification Rules
• Team Members
• Users

Caching mechanisms available

• In memory.
• MongoDB.

To activate caching support

Contributing

1. Fork it (https://github.com/nordcloud/go-pagerduty/fork)
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request

Testing

Run all unit tests with make test

Run a specific subset of unit test by name using make test TESTARGS="-v -run TestTeams" which will run all test functions with "TestTeams" in their name while -v enables verbose output.

Environment Variables to test specific feature sets