How to use a pageable API?

[pll]

Hi all,

I built a client for an internal API, and the generated code I get back looks like this:

def sync_detailed(*, client: Client, pageable: 'Pageable') -> Response[Any]:

Since "pageable" is a DTO object of type Pageable, which seems to support the following:

"Pageable": {
  "type": "object",
  "properties": {
    "offset": {
      "type": "integer",
      "format": "int64"
    },
    "pageSize": {
      "type": "integer",
      "format": "int32"
    },
    "pageNumber": {
      "type": "integer",
      "format": "int32"
    }
...

In the "pageable.py" model generated by openapi-python-client, those seem to be translated to:

def to_dict(self) -> Dict[str, Any]:
    offset = self.offset
    sort: Union[Unset, Dict[str, Any]] = UNSET
    if not isinstance(self.sort, Unset):
        sort = self.sort.to_dict()

    page_number = self.page_number
    page_size = self.page_size

I assumed then, that I need to set those params in the DTO itself like this:

dto['page_number'] = 0
dto['page_size'] = 100

But that didn't work. Then I noticed when actually connecting to the web UI which implements an Angular-based client for browsers that it passes page and size. So I change the above to be"

dto['page'] = 0
dto['size'] = 100

and that works. I can now iterate dto['page'] until I don't get any more results. My big question now is, WHY when the spec says PageSize and PageNumber and the generated client code uses page_size and page_number, do I have to actually use page and size ?

Thanks.

Paul