From ecfe504b60b03a18f8448f2407c8dd09ea07afcd Mon Sep 17 00:00:00 2001
From: Adam Rothman <rothman.adam@gmail.com>
Date: Sun, 14 Jul 2024 18:48:09 -0700
Subject: [PATCH] docs: Add an example demonstrating correct usage of
 GetUsersPaginated (#1201)

* Add an example demonstrating correct usage of GetUsersPaginated

* Requeue GitHub Actions

---------

Co-authored-by: Lorenzo Aiello <lorenzo.aiello@slack-corp.com>
---
 examples/pagination/pagination.go | 59 +++++++++++++++++++++++++++++++
 1 file changed, 59 insertions(+)
 create mode 100644 examples/pagination/pagination.go

diff --git a/examples/pagination/pagination.go b/examples/pagination/pagination.go
new file mode 100644
index 000000000..265910137
--- /dev/null
+++ b/examples/pagination/pagination.go
@@ -0,0 +1,59 @@
+package main
+
+import (
+	"context"
+	"errors"
+	"fmt"
+	"time"
+
+	"github.com/slack-go/slack"
+)
+
+func getAllUserUIDs(ctx context.Context, client *slack.Client, pageSize int) ([]string, error) {
+	var uids []string
+	var err error
+
+	pages := 0
+	pager := client.GetUsersPaginated(slack.GetUsersOptionLimit(pageSize))
+	for {
+		// Note reassignment of pager to the value returned by Next()
+		pager, err = pager.Next(ctx)
+		if failedErr := pager.Failure(err); failedErr != nil {
+			var rateLimited *slack.RateLimitedError
+			if errors.As(failedErr, &rateLimited) && rateLimited.Retryable() {
+				fmt.Println("Rate limited by Slack API; sleeping", rateLimited.RetryAfter)
+				select {
+				case <-ctx.Done():
+					return uids, ctx.Err()
+				case <-time.After(rateLimited.RetryAfter):
+					continue
+				}
+			}
+			return uids, fmt.Errorf("paginating users: %w", failedErr)
+		}
+		if pager.Done(err) {
+			break
+		}
+
+		for _, user := range pager.Users {
+			uids = append(uids, user.ID)
+		}
+
+		pages++
+	}
+
+	fmt.Printf("Pagination complete after %d pages\n", pages)
+
+	return uids, nil
+}
+
+func main() {
+	client := slack.New("YOUR_TOKEN_HERE")
+
+	uids, err := getAllUserUIDs(context.Background(), client, 1000)
+	if err != nil {
+		panic(err)
+	}
+
+	fmt.Printf("Collected %d UIDs\n", len(uids))
+}