Description
This release overhauls how pagination is performed in Subgrounds.
BREAKING CHANGES
* The `auto_paginate` argument of toplevel querying functions has been replaced by the `pagination_strategy` argument (setting the latter to `None` disables pagination).
Feature
* Subgrounds users can now define and use their own pagination strategy (see Custom pagination strategy for more details).
* Users select the pagination strategies to use when calling toplevel querying functions:
py
df = sg.query_df(field_paths, pagination_strategy=MyPaginationStrategy)
* Subgrounds provides two pagination strategies out of the box:
* `LegacyStrategy` (the strategy used prior to this update)
* `ShallowStrategy`, which is much faster than `LegacyStrategy` in some cases, but does not support pagination on nested fields (see Available pagination strategies for more details).
Fix
* Fix bug that would cause a crash when calling one of the toplevel querying functions with only one `FieldPath` object (e.g.: `sg.query_df(pairs.id)`).