[MCC-1496700] Python get_datasets() pagination support

[butsyk-mdsol]

feature/bug/enhance/refactor/tech_debt/hotfix

• Python get_datasets() pagination support.
• MCC-1496700

Checklist

• Review the pull request to fix typos and ensure variable/function names are intuitive, etc.
• Make sure the pull request does not have excessive number of unnecessary commits. Utilize the git commit --amend --no-edit command to reduce commit messages when making small file changes (like changing linespacing).
• Make sure you have added unit tests for the code changes. Tests should be added in the tests/ folder.
• Modify docs, if required. Add any new documentation in the doc/ folder.
• Rebase on latest active development branch (develop/main).

Changes Summary

AC-06: Pagination Input Parameters
The function accepts optional page (default: 1) and page_size (default: TBD) parameters to control result pagination.

AC-07: Result Set Metadata
The response object includes full pagination context
response = {
"total_records": int, # Total count of available datasets
"pagination":

{ "page": int, # Current page (user-provided or default) "page_size": int, # Page size (user-provided or default) "total_pages": int# Calculated: ceil(total_records / page_size) },
"items": [] # List of Dataset objects
}

Deployment Notes

In addition to IAC/code, add any notes for reviewer should know.

[Copilot]

Pull request overview

Adds pagination support to the Python SDK’s get_datasets() call by returning a structured paginated response (items + pagination metadata) instead of a plain list, and updates the public API exports and README example accordingly.

Changes:

• Change get_datasets() return type to PaginatedResponse[Dataset] across the service interface, default implementation, and client façade.
• Build and return pagination metadata (total_records, page, page_size, total_pages) from the transport results in the default service.
• Update README quick-start usage and export PaginatedResponse/Pagination from the package root.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
README.md	Updates quick-start example to use the paginated response (.items).
dataconnect/service/default.py	Implements PaginatedResponse construction and pagination metadata for get_datasets().
dataconnect/service/base.py	Updates service interface return type for get_datasets() to PaginatedResponse[Dataset].
dataconnect/client.py	Updates public client get_datasets() signature/return type to PaginatedResponse[Dataset].
dataconnect/init.py	Exposes PaginatedResponse and Pagination in the public package API.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.