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]

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