Pagination support for all resources

[crazytonyli]

It'd be nice to have a single pagination implementation for all resources. What do you all think?

let users = wordPressApi.paginate(User.self, orderBy: \.name)
let firstPage: [User] = try await users.nextPage()
let secondPage: [User] = try await users.nextPage()

// Same syntax can be used on Post
let posts = wordPressApi.paginate(Post.self, orderBy: \.modifiedDate)
let firstPage: [User] = try await posts.nextPage()
let secondPage: [User] = try await posts.nextPage()

[jkmassel]

This is a really neat idea, though it'd need to be able to accept an arbitrary query as input – for instance, I might want to do something like:

let query = PostQuery(
  type: .custom("event"),
  context: .edit,
  modifiedAfter: Date().subtractingYears(1),
  orderBy: .modified,
  perPage: 100
)

let iterator = wordPressApi.paginate(User.self, using: query)

I also wonder if in this case the developer cares less about which page they're on, and more about knowing that they've retrieved all records? For instance, being able to iterate over all users instead of over pages of users?

WDYT?

[crazytonyli]

I also wonder if in this case the developer cares less about which page they're on, and more about knowing that they've retrieved all records?

Probably not which page they're on. But I think they'll need the capability to load records page by page. For example, infinite scrolling posts list.

[crazytonyli]

One thing I'm not sure of is, do we want (or is it feasible) to implement this shared pagination in rust, given we now mainly use WPApiHelper to build requests and parse responses?