Add support for locally determining whether a PagedResult represents the last page of results.

Author: tintoy

compute/paging.go

@@ -1,6 +1,8 @@
 package compute
 
-import "fmt"
+import (
+	"fmt"
+)
 
 // PagedResult represents the common fields for all paged results from the compute API.
 type PagedResult struct {
@@ -30,6 +32,17 @@ func (page *PagedResult) NextPage() *Paging {
 	}
 }
 
+// IsLastPage determines whether the page represents the last page of results.
+func (page *PagedResult) IsLastPage() bool {
+	if page.IsEmpty() {
+		return true
+	}
+
+	itemCountUpToCurrentPage := ((page.PageNumber - 1) * page.PageSize) + page.PageCount
+
+	return itemCountUpToCurrentPage >= page.TotalCount // i.e. Are there any more records?
+}
+
 // Paging contains the paging configuration for a compute API operation.
 type Paging struct {
 	PageNumber int

compute/paging_test.go

@@ -0,0 +1,53 @@
+package compute
+
+import (
+	"testing"
+)
+
+// Verify that a PagedResult correctly determines that a page is not the last page.
+func TestPagedResult_IsLastPage_PageSize_2_FirstPage_2of6Records(test *testing.T) {
+	expect := expect(test)
+
+	result := &PagedResult{
+		PageNumber: 1,
+		PageSize:   2,
+		PageCount:  2,
+		TotalCount: 6,
+	}
+
+	expect.IsFalse("PagedResult.IsLastPage",
+		result.IsLastPage(),
+	)
+}
+
+// Verify that a PagedResult correctly determines that a page is not the last page.
+func TestPagedResult_IsLastPage_PageSize_2_SecondLastPage_3of6Records(test *testing.T) {
+	expect := expect(test)
+
+	result := &PagedResult{
+		PageNumber: 2,
+		PageSize:   2,
+		PageCount:  1,
+		TotalCount: 6,
+	}
+
+	expect.IsFalse("PagedResult.IsLastPage",
+		result.IsLastPage(),
+	)
+}
+
+// Verify that a PagedResult correctly determines that a page is the last page.
+func TestPagedResult_IsLastPage_PageSize_2_LastPage_6of6Records(test *testing.T) {
+	expect := expect(test)
+
+	result := &PagedResult{
+		PageNumber: 3,
+		PageSize:   2,
+		PageCount:  2,
+		TotalCount: 6,
+	}
+
+	expect.IsTrue("PagedResult.IsLastPage",
+		result.IsLastPage(),
+	)
+}