Add get() raises docs, fix isort, replace non-ASCII chars in SKILL.md and example

Author: Saurabh Badenkal

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

@@ -132,7 +132,7 @@ client.records.update("account", [id1, id2, id3], {"industry": "Technology"})
 ```
 
 #### Upsert Records
-Creates or updates records identified by alternate keys. Single item → PATCH; multiple items → `UpsertMultiple` bulk action.
+Creates or updates records identified by alternate keys. Single item -> PATCH; multiple items -> `UpsertMultiple` bulk action.
 > **Prerequisite**: The table must have an alternate key configured in Dataverse for the columns used in `alternate_key`. Without it, Dataverse will reject the request with a 400 error.
 ```python
 from PowerPlatform.Dataverse.models.upsert import UpsertItem
@@ -181,7 +181,7 @@ The SDK provides DataFrame wrappers for all CRUD operations via the `client.data
 ```python
 import pandas as pd
 
-# Query records — returns a single DataFrame
+# Query records -- returns a single DataFrame
 df = client.dataframe.get("account", filter="statecode eq 0", select=["name"])
 print(f"Got {len(df)} rows")
 

examples/advanced/dataframe_operations.py

@@ -21,7 +21,7 @@
 
 
 def main():
-    # ── Setup & Authentication ────────────────────────────────────
+    # -- Setup & Authentication ------------------------------------
     base_url = input("Enter Dataverse org URL (e.g. https://yourorg.crm.dynamics.com): ").strip()
     if not base_url:
         print("[ERR] No URL entered; exiting.")
@@ -46,7 +46,7 @@ def _run_walkthrough(client):
 
     select_cols = ["name", "telephone1", "websiteurl", "lastonholdtime"]
 
-    # ── 1. Create records from a DataFrame ────────────────────────
+    # -- 1. Create records from a DataFrame ------------------------
     print("\n" + "-" * 60)
     print("1. Create records from a DataFrame")
     print("-" * 60)
@@ -75,7 +75,7 @@ def _run_walkthrough(client):
     print(f"[OK] Created {len(new_accounts)} records")
     print(f"  IDs: {new_accounts['accountid'].tolist()}")
 
-    # ── 2. Query records as a DataFrame ─────────────────────────
+    # -- 2. Query records as a DataFrame -------------------------
     print("\n" + "-" * 60)
     print("2. Query records as a DataFrame")
     print("-" * 60)
@@ -85,7 +85,7 @@ def _run_walkthrough(client):
     print(f"  Columns: {list(df_all.columns)}")
     print(f"{df_all.to_string(index=False)}")
 
-    # ── 3. Limit results with top ──────────────────────────────
+    # -- 3. Limit results with top ------------------------------
     print("\n" + "-" * 60)
     print("3. Limit results with top")
     print("-" * 60)
@@ -94,7 +94,7 @@ def _run_walkthrough(client):
     print(f"[OK] Got {len(df_top2)} records with top=2")
     print(f"{df_top2.to_string(index=False)}")
 
-    # ── 4. Fetch a single record by ID ────────────────────────────
+    # -- 4. Fetch a single record by ID ----------------------------
     print("\n" + "-" * 60)
     print("4. Fetch a single record by ID")
     print("-" * 60)
@@ -104,7 +104,7 @@ def _run_walkthrough(client):
     single = client.dataframe.get(table, record_id=first_id, select=select_cols)
     print(f"[OK] Single record DataFrame:\n{single.to_string(index=False)}")
 
-    # ── 5. Update records from a DataFrame ────────────────────────
+    # -- 5. Update records from a DataFrame ------------------------
     print("\n" + "-" * 60)
     print("5. Update records with different values per row")
     print("-" * 60)
@@ -118,7 +118,7 @@ def _run_walkthrough(client):
     verified = client.dataframe.get(table, select=select_cols, filter=test_filter)
     print(f"  Verified:\n{verified.to_string(index=False)}")
 
-    # ── 6. Broadcast update (same value to all records) ───────────
+    # -- 6. Broadcast update (same value to all records) -----------
     print("\n" + "-" * 60)
     print("6. Broadcast update (same value to all records)")
     print("-" * 60)
@@ -151,7 +151,7 @@ def _run_walkthrough(client):
     verified = client.dataframe.get(table, select=select_cols, filter=test_filter)
     print(f"  Verified (Contoso websiteurl should be empty):\n{verified.to_string(index=False)}")
 
-    # ── 7. Delete records by passing a Series of GUIDs ────────────
+    # -- 7. Delete records by passing a Series of GUIDs ------------
     print("\n" + "-" * 60)
     print("7. Delete records by passing a Series of GUIDs")
     print("-" * 60)

src/PowerPlatform/Dataverse/claude_skill/dataverse-sdk-use/SKILL.md

@@ -132,7 +132,7 @@ client.records.update("account", [id1, id2, id3], {"industry": "Technology"})
 ```
 
 #### Upsert Records
-Creates or updates records identified by alternate keys. Single item → PATCH; multiple items → `UpsertMultiple` bulk action.
+Creates or updates records identified by alternate keys. Single item -> PATCH; multiple items -> `UpsertMultiple` bulk action.
 > **Prerequisite**: The table must have an alternate key configured in Dataverse for the columns used in `alternate_key`. Without it, Dataverse will reject the request with a 400 error.
 ```python
 from PowerPlatform.Dataverse.models.upsert import UpsertItem
@@ -181,7 +181,7 @@ The SDK provides DataFrame wrappers for all CRUD operations via the `client.data
 ```python
 import pandas as pd
 
-# Query records — returns a single DataFrame
+# Query records -- returns a single DataFrame
 df = client.dataframe.get("account", filter="statecode eq 0", select=["name"])
 print(f"Got {len(df)} rows")
 

src/PowerPlatform/Dataverse/operations/dataframe.py

@@ -5,7 +5,7 @@
 
 from __future__ import annotations
 
-from typing import Any, Dict, List, Optional, TYPE_CHECKING
+from typing import TYPE_CHECKING, Any, Dict, List, Optional
 
 import pandas as pd
 
@@ -91,6 +91,10 @@ def get(
             when no records match.
         :rtype: ~pandas.DataFrame
 
+        :raises ValueError: If ``record_id`` is not a non-empty string, or if
+            query parameters (``filter``, ``orderby``, ``top``, ``expand``,
+            ``page_size``) are provided alongside ``record_id``.
+
         .. tip::
             For large tables, use ``top`` or ``filter`` to limit the result set.
 
@@ -312,7 +316,9 @@ def delete(
         :raises ValueError: If ``ids`` contains invalid (non-string, empty, or
             whitespace-only) values.
 
-        :return: BulkDelete job ID when deleting multiple records via BulkDelete; otherwise ``None``.
+        :return: BulkDelete job ID when deleting multiple records via BulkDelete;
+            ``None`` when deleting a single record, using sequential deletion, or
+            when ``ids`` is empty.
         :rtype: :class:`str` or None
 
         Example: