Add QueryBuilder with fluent API and composable filter expressions

[tpellissier-msft]

Summary

Implements the QueryBuilder feature from the SDK redesign design doc (ADO PR 1504429):

• Fluent query builder via client.query.builder("table") with 20 chainable methods including select, filter_eq/ne/gt/ge/lt/le, filter_contains/startswith/endswith, filter_in, filter_between, filter_null/not_null, filter_raw, where, order_by, top, page_size, expand, and execute
• Composable filter expression tree (models/filters.py) with Python operator overloads (&, |, ~) for AND, OR, NOT composition
• Value auto-formatting for str, int, float, bool, None, datetime, date, uuid.UUID
• 126 new unit tests (57 filters + 69 query builder), 309 total passing

Usage examples

# Fluent builder
for page in (client.query.builder("account")
             .select("name", "revenue")
             .filter_eq("statecode", 0)
             .filter_gt("revenue", 1000000)
             .order_by("revenue", descending=True)
             .top(100)
             .page_size(50)
             .execute()):
    for record in page:
        print(record["name"])

# Composable expression tree with where()
from PowerPlatform.Dataverse.models.filters import eq, gt, filter_in

for page in (client.query.builder("account")
             .where((eq("statecode", 0) | eq("statecode", 1))
                    & gt("revenue", 100000))
             .execute()):
    for record in page:
        print(record["name"])

Design decisions

• Regular class, not dataclass — prevents leaking internal state as constructor params
• Unified _filter_parts list — preserves call order when mixing filter_*() and where()
• execute() calls build() internally — single source of truth for filter compilation
• No public get() on QueryOperations — only builder() added; paginated queries remain on records.get()
• Parenthesized filter_between — (col ge low and col le high) for correct precedence

Files changed

File	Description
src/.../models/filters.py	NEW — Composable expression tree
src/.../models/query_builder.py	NEW — Fluent QueryBuilder class
src/.../operations/query.py	Add builder() to QueryOperations
src/.../models/__init__.py	Updated docstring
tests/.../models/test_filters.py	NEW — 57 filter tests
tests/.../models/test_query_builder.py	NEW — 69 builder tests
tests/.../test_query_operations.py	6 new integration tests

Merge conflict note

operations/query.py may conflict with PR #115 (typed return models) — resolution is straightforward since we only add a builder() method.

Test plan

• pytest tests/unit/models/test_filters.py — 57 passed
• pytest tests/unit/models/test_query_builder.py — 69 passed
• pytest tests/unit/test_query_operations.py — 9 passed
• pytest tests/ — 309 passed, 0 failed

🤖 Generated with Claude Code

[Copilot]

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

[Copilot]

Pull request overview

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

---

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

[Copilot]

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

[Copilot]

Pull request overview

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

---

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

[Copilot]

Pull request overview

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

---

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

[Copilot]

Pull request overview

Copilot reviewed 9 out of 9 changed files in this pull request and generated 3 comments.

---

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

[Copilot]

Pull request overview

Copilot reviewed 9 out of 9 changed files in this pull request and generated no new comments.

---

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

[saurabhrb]

@abelmilash-msft -- 5 commits were added on top of your work (4e37cee..b08639d). Here's a summary for your review:

New features added (closing OData Web API parity gaps identified in issue #147 and OData docs audit):

1. ExpandOption class (query_builder.py L59-148) -- Structured nested with, , , ``. expand() still accepts plain strings for backward compat.

2. count() (query_builder.py L483) -- Adds =true to requests.

3. include_formatted_values() / include_annotations() (query_builder.py L502-555) -- Requests OData annotations (choice labels, currency symbols, lookup display names).

4. to_dataframe() (query_builder.py L701) -- Addresses Add QueryBuilder.to_dataframe() for fluent DataFrame queries #147. Delegates to client.dataframe.get().

5. HTTP layer (_odata.py L745-806) -- _get_multiple() now accepts count and include_annotations. Prefer header supports multiple comma-separated values.

6. Typing fixes (Copilot review responses) -- Sequence[Any] -> Collection[Any] for filter_in/not_in; execute() return type -> Record.

All 601 tests pass. No existing commits were removed or modified. Python 3.10-3.14 compatible.

[saurabhrb]

Review of 5 commits added (4e37cee..b08639d) -- see inline comments for details on each change area.