# Import grouping and ordering constraints

rules:
  - name: grouping
    rule: "Group imports in three sections separated by a single blank line: stdlib, third-party, local."
    examples:
      - good: |
          import json
          import logging

          import requests
          import duckdb

          from .pipeline import text_pipeline
      - bad: |
          import duckdb
          import json
          from pipeline import text_pipeline

  - name: from_imports
    rule: "Prefer 'from x import y' only when it improves clarity or avoids circular import; otherwise import module and reference attributes."

enforcement_examples:
  - "Run isort or ruff- import sorting in pre-commit or CI to enforce ordering."