Adds progress=True parameter to DSL query execution for debugging and monitoring query execution flow.

Changes

• Executor (py3plex/dsl/executor.py)

  • Added progress parameter to execute_ast(), _execute_select(), and _execute_windowed_query()
  • Log execution steps: parameter binding, layer filtering, WHERE conditions, measure computation (with individual progress), ordering, limiting, and result creation
  • Include item counts at each filtering stage

• Builder API (py3plex/dsl/builder.py)

  • Added progress parameter to QueryBuilder.execute() method

• Tests (tests/test_dsl_progress_logging.py)

  • 8 tests covering default behavior, explicit enable/disable, multi-step queries, and edge queries

• Example (examples/network_analysis/example_dsl_progress_logging.py)

  • Demonstrates usage and execution order visibility

• Documentation (py3plex/dsl/__init__.py)

  • Updated module docstring with progress logging example

Usage

from py3plex.dsl import Q, L

# Default: no progress logging
result = Q.nodes().from_layers(L["social"]).execute(network)

# Enable progress logging
result = Q.nodes().from_layers(L["social"]).compute("degree").execute(network, progress=True)
# Output:
# 2025-12-29 17:06:45 - py3plex.dsl.executor - INFO - Starting DSL query execution
# 2025-12-29 17:06:45 - py3plex.dsl.executor - INFO - Step 1: Binding parameters
# 2025-12-29 17:06:45 - py3plex.dsl.executor - INFO - Step 3.1: Getting initial nodes
# 2025-12-29 17:06:45 - py3plex.dsl.executor - INFO - Found 5 initial nodes
# 2025-12-29 17:06:45 - py3plex.dsl.executor - INFO - Step 3.2: Applying layer filter
# 2025-12-29 17:06:45 - py3plex.dsl.executor - INFO - Filtered to 3 nodes in 1 layers
# 2025-12-29 17:06:45 - py3plex.dsl.executor - INFO - Step 3.4: Computing 1 measure(s)
# 2025-12-29 17:06:45 - py3plex.dsl.executor - INFO -   Computing degree (1/1)
# ...

Progress messages use Python's standard logging at INFO level. Sub-query progress is suppressed in windowed queries to reduce clutter.

• Fixes progress for dsl steps #963

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.