Polish: fix style nit, add param docstrings, walkthrough to_dataframe

Author: Abel Milash

examples/advanced/walkthrough.py

@@ -347,6 +347,24 @@ def _run_walkthrough(client):
         print(f"  Page {combined_page_count}: {len(page)} records - {titles}")
     print(f"[OK] Combined query: {combined_record_count} records across {combined_page_count} page(s)")
 
+    # to_dataframe: get results as a pandas DataFrame
+    log_call(f"client.query.builder('{table_name}').select(...).filter_eq(...).to_dataframe()")
+    print("Querying completed records as a pandas DataFrame (to_dataframe)...")
+    df = backoff(
+        lambda: (
+            client.query.builder(table_name)
+            .select("new_title", "new_quantity")
+            .filter_eq("new_completed", True)
+            .to_dataframe()
+        )
+    )
+    print(f"[OK] to_dataframe() returned {len(df)} rows, columns: {list(df.columns)}")
+    if not df.empty:
+        print(f"  First row: new_title='{df.iloc[0].get('new_title')}', new_quantity={df.iloc[0].get('new_quantity')}")
+        print(f"  Sum of new_quantity: {df['new_quantity'].sum()}")
+    else:
+        print("  (empty DataFrame)")
+
     # ============================================================================
     # 8. EXPAND (NAVIGATION PROPERTIES)
     # ============================================================================
@@ -510,7 +528,7 @@ def _run_walkthrough(client):
     print("  [OK] Reading records by ID and with filters")
     print("  [OK] Single and multiple record updates")
     print("  [OK] Paging through large result sets")
-    print("  [OK] QueryBuilder fluent queries (filter_eq, filter_in, filter_between, where)")
+    print("  [OK] QueryBuilder fluent queries (filter_eq, filter_in, filter_between, where, to_dataframe)")
     print("  [OK] Expand navigation properties (simple + nested ExpandOption)")
     print("  [OK] SQL queries")
     print("  [OK] Picklist label-to-value conversion")

src/PowerPlatform/Dataverse/data/_odata.py

@@ -761,6 +761,10 @@ def _get_multiple(
         :type expand: ``list[str]`` | ``None``
         :param page_size: Per-page size hint via ``Prefer: odata.maxpagesize``.
         :type page_size: ``int`` | ``None``
+        :param count: If ``True``, adds ``$count=true`` to include a total record count in the response.
+        :type count: ``bool``
+        :param include_annotations: OData annotation pattern for the ``Prefer: odata.include-annotations`` header (e.g. ``"*"`` or ``"OData.Community.Display.V1.FormattedValue"``), or ``None``.
+        :type include_annotations: ``str`` | ``None``
 
         :return: Iterator yielding pages (each page is a ``list`` of record dicts).
         :rtype: ``Iterable[list[dict[str, Any]]]``

src/PowerPlatform/Dataverse/models/filters.py

@@ -249,7 +249,7 @@ def __init__(self, column: str, values: Collection[Any]) -> None:
 
     def to_odata(self) -> str:
         # Same Collection(Edm.String) rules as _InFilter.
-        parts = [f'"{ _format_value(v).strip("'") }"' for v in self.values]
+        parts = [f'"{_format_value(v).strip("'")}"' for v in self.values]
         formatted = ",".join(parts)
         return (
             f"Microsoft.Dynamics.CRM.NotIn"

src/PowerPlatform/Dataverse/operations/dataframe.py

@@ -88,6 +88,13 @@ def get(
         :type expand: :class:`list` of :class:`str` or None
         :param page_size: Optional number of records per page for pagination.
         :type page_size: :class:`int` or None
+        :param count: If ``True``, adds ``$count=true`` to include a total
+            record count in the response.
+        :type count: :class:`bool`
+        :param include_annotations: OData annotation pattern for the
+            ``Prefer: odata.include-annotations`` header (e.g. ``"*"`` or
+            ``"OData.Community.Display.V1.FormattedValue"``), or ``None``.
+        :type include_annotations: :class:`str` or None
 
         :return: DataFrame containing all matching records. Returns an empty DataFrame
             when no records match.

src/PowerPlatform/Dataverse/operations/records.py

@@ -302,6 +302,13 @@ def get(
         :param page_size: Optional per-page size hint sent via
             ``Prefer: odata.maxpagesize``.
         :type page_size: :class:`int` or None
+        :param count: If ``True``, adds ``$count=true`` to include a total
+            record count in the response.
+        :type count: :class:`bool`
+        :param include_annotations: OData annotation pattern for the
+            ``Prefer: odata.include-annotations`` header (e.g. ``"*"`` or
+            ``"OData.Community.Display.V1.FormattedValue"``), or ``None``.
+        :type include_annotations: :class:`str` or None
 
         :return: Generator yielding pages, where each page is a list of
             :class:`~PowerPlatform.Dataverse.models.record.Record` objects.
@@ -380,6 +387,14 @@ def get(
         :param page_size: Optional per-page size hint sent via
             ``Prefer: odata.maxpagesize``. Only used for multi-record queries.
         :type page_size: :class:`int` or None
+        :param count: If ``True``, adds ``$count=true`` to include a total
+            record count in the response. Only used for multi-record queries.
+        :type count: :class:`bool`
+        :param include_annotations: OData annotation pattern for the
+            ``Prefer: odata.include-annotations`` header (e.g. ``"*"`` or
+            ``"OData.Community.Display.V1.FormattedValue"``), or ``None``.
+            Only used for multi-record queries.
+        :type include_annotations: :class:`str` or None
 
         :return: A single record dict when ``record_id`` is provided, or a
             generator yielding pages (lists of record dicts) when fetching