Add unit tests for records.list_pages() and migration script for v0 to v1

- Implemented unit tests for the `list_pages` method in `TestListPages` class, covering various scenarios including iterator return, page content validation, and parameter passing.
- Added checks for deprecation warnings to ensure no warnings are raised during the usage of `list_pages`.
- Introduced a new migration script `migrate_v0_to_v1.py` to automate the transition from beta (v0) to GA (v1) API calls, including method renaming and argument adjustments.
- Created a new `tools` directory to house the migration script.

Author: Samson Gebre

.claude/skills/dataverse-sdk-use/SKILL.md

@@ -32,7 +32,7 @@ The SDK supports Dataverse's native bulk operations: Pass lists to `create()`, `
 - Use `top` parameter to limit total records returned
 
 ### DataFrame Support
-- DataFrame operations are accessed via the `client.dataframe` namespace: `client.dataframe.get()`, `client.dataframe.create()`, `client.dataframe.update()`, `client.dataframe.delete()`
+- DataFrame operations are accessed via the `client.dataframe` namespace: `client.dataframe.create()`, `client.dataframe.update()`, `client.dataframe.delete()` — `client.dataframe.get()` is deprecated; use `client.query.builder(table).where(...).execute().to_dataframe()` instead
 
 ## Common Operations
 
@@ -85,28 +85,40 @@ contact_ids = client.records.create("contact", contacts)
 #### Read Records
 ```python
 # Get single record by ID
-account = client.records.get("account", account_id, select=["name", "telephone1"])
+account = client.records.retrieve("account", account_id, select=["name", "telephone1"])
 
-# Query with filter (paginated)
-for page in client.records.get(
+# Query with filter — follows @odata.nextLink automatically (multiple HTTP requests if needed),
+# loads all matching records into memory, returns a single QueryResult.
+# Page size is Dataverse's default (~5000/page); use top to bound total records and round-trips.
+# For very large sets where memory is a concern, use query.builder().execute(by_page=True) instead.
+result = client.records.list(
     "account",
     select=["accountid", "name"],      # select is case-insensitive (automatically lowercased)
     filter="statecode eq 0",           # filter must use lowercase logical names (not transformed)
-    top=100,
-):
+    top=100,                           # bounds both total records returned and HTTP round-trips
+)
+for record in result:
+    print(record["name"])
+
+# For large result sets that must be streamed page-by-page (caller controls memory, one page at a time)
+for page in (client.query.builder("account")
+             .select("accountid", "name")
+             .where(col("statecode") == 0)
+             .page_size(500)           # optional: override Dataverse default page size
+             .execute(by_page=True)):
     for record in page:
         print(record["name"])
 
-# Query with navigation property expansion (case-sensitive!)
-for page in client.records.get(
-    "account",
-    select=["name"],
-    expand=["primarycontactid"],  # Navigation properties are case-sensitive!
-    filter="statecode eq 0",      # Column names must be lowercase logical names
-):
-    for account in page:
-        contact = account.get("primarycontactid", {})
-        print(f"{account['name']} - {contact.get('fullname', 'N/A')}")
+# Query with navigation property expansion — use the query builder (records.list() has no expand)
+from PowerPlatform.Dataverse.models.query_builder import ExpandOption
+from PowerPlatform.Dataverse.models.filters import col
+for record in (client.query.builder("account")
+               .select("name")
+               .expand(ExpandOption("primarycontactid").select("fullname"))
+               .where(col("statecode") == 0)
+               .execute()):
+    contact = record.get("primarycontactid", {})
+    print(f"{record['name']} - {contact.get('fullname', 'N/A')}")
 ```
 
 #### Create Records with Lookup Bindings (@odata.bind)
@@ -179,18 +191,20 @@ client.records.delete("account", [id1, id2, id3], use_bulk_delete=True)
 
 The SDK provides DataFrame wrappers for all CRUD operations via the `client.dataframe` namespace, using pandas DataFrames and Series as input/output.
 
+> **Note:** `client.dataframe.get()` is deprecated. Use `client.query.builder(table).select(...).filter(...).to_dataframe()` instead.
+
 ```python
 import pandas as pd
 
-# Query records -- returns a single DataFrame
-df = client.dataframe.get("account", filter="statecode eq 0", select=["name"])
+# Query records -- returns a single DataFrame (GA builder pattern)
+df = client.query.builder("account").filter("statecode eq 0").select("name").to_dataframe()
 print(f"Got {len(df)} rows")
 
-# Limit results with top for large tables
-df = client.dataframe.get("account", select=["name"], top=100)
+# Limit results with top
+df = client.query.builder("account").select("name").top(100).to_dataframe()
 
 # Fetch single record as one-row DataFrame
-df = client.dataframe.get("account", record_id=account_id, select=["name"])
+df = client.records.retrieve("account", account_id, select=["name"]).to_dataframe()
 
 # Create records from a DataFrame (returns a Series of GUIDs)
 new_accounts = pd.DataFrame([
@@ -380,7 +394,8 @@ Use `client.batch` to send multiple operations in one HTTP request. All batch me
 batch = client.batch.new()
 batch.records.create("account", {"name": "Contoso"})
 batch.records.update("account", account_id, {"telephone1": "555-0100"})
-batch.records.get("account", account_id, select=["name"])
+batch.records.retrieve("account", account_id, select=["name"])     # single record (GA)
+batch.records.list("account", filter="statecode eq 0", top=50)     # multi-record, single page
 batch.query.sql("SELECT TOP 5 name FROM account")
 
 result = batch.execute()
@@ -412,7 +427,8 @@ print(f"Succeeded: {len(result.succeeded)}, Failed: {len(result.failed)}")
 
 **Batch limitations:**
 - Maximum 1000 operations per batch
-- Paginated `records.get()` (without `record_id`) is not supported in batch
+- `batch.records.get()` is deprecated; use `batch.records.retrieve()` for single records
+- `batch.records.list()` returns a single page (no pagination); use `top` to bound results
 - `flush_cache()` is not supported in batch
 
 ## Error Handling
@@ -430,7 +446,7 @@ from PowerPlatform.Dataverse.core.errors import (
 from PowerPlatform.Dataverse.client import DataverseClient
 
 try:
-    client.records.get("account", "invalid-id")
+    client.records.retrieve("account", "invalid-id")
 except HttpError as e:
     print(f"HTTP {e.status_code}: {e.message}")
     print(f"Error code: {e.code}")