Skip to content

Latest commit

 

History

History
34 lines (21 loc) · 1.64 KB

README.md

File metadata and controls

34 lines (21 loc) · 1.64 KB

listpages

The listpages generator creates paginated variants of AWS Go SDK functions that return collections of objects where the SDK does not define them. It should typically be called using go generate.

For example, the EC2 API defines both DescribeInstancesPages and DescribeInstances, whereas the CloudWatch Events API defines only ListEventBuses.

The listpages executable is called as follows:

$ go run main.go -ListOps <function-name>[,<function-name>]
  • <function-name>: Name of a function to wrap

Optional Flags:

  • -Paginator: Name of the pagination token field (default NextToken)
  • -Export: Whether to export the generated functions

To use with go generate, add the following directive to a Go file

//go:generate go run <relative-path-to-generators>/generate/listpages/main.go -ListOps=<comma-separated-list-of-functions>

For example, in the file internal/service/cloudwatchevents/generate.go

//go:generate go run -tags generate ../../generate/listpages/main.go -ListOps=ListEventBuses,ListRules,ListTargetsByRule

package cloudwatchevents

generates the file internal/service/cloudwatchevents/list_pages_gen.go with the functions listEventBusesPages, listRulesPages, and listTargetsByRulePages as well as their ...WithContext equivalents.