ci,docs: build+test dsrs-dspy against DSPy; exclude dspy-py from miri

miri cannot interpret an embedded CPython, so the PyO3 crate is excluded
there; it is covered by the build, test, clippy, and new python-adapter
jobs instead.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: darinkishore

.github/workflows/qol.yaml

@@ -35,7 +35,23 @@ jobs:
           toolchain: nightly-2026-01-25
           components: miri
       - run: cargo miri setup
-      - run: cargo miri test --all-features
+      # dspy-py is a PyO3 extension; its tests embed CPython, which miri cannot interpret.
+      - run: cargo miri test --all-features --workspace --exclude dspy-py
+
+  python-adapter:
+    name: Python Adapter (dsrs-dspy)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          toolchain: 1.90.0
+      - uses: astral-sh/setup-uv@v5
+      - name: Build wheel and run adapter tests against DSPy
+        run: |
+          uv venv .venv
+          VIRTUAL_ENV=$PWD/.venv uv pip install ./crates/dspy-py dspy pytest
+          .venv/bin/pytest crates/dspy-py/tests/python/ -q
 
   clippy:
     name: Clippy Lint

README.md

@@ -353,6 +353,26 @@ println!("Sentiment: {}", analysis.sentiment);
 println!("Summary: {}", summary.summary);
 ```
 
+## 🐍 Using DSRs from Python (DSPy)
+
+DSRs's BAML-style schema rendering and JSONish parsing are available to
+[DSPy](https://github.com/stanfordnlp/dspy) as a drop-in adapter, via the
+`dsrs-dspy` PyO3 package in [`crates/dspy-py`](crates/dspy-py):
+
+```bash
+uv add "dsrs-dspy @ git+https://github.com/krypticmouse/DSRs@main#subdirectory=crates/dspy-py"
+```
+
+```python
+import dspy
+from dsrs_dspy import DSRSBAMLAdapter
+
+dspy.configure(lm=dspy.LM("openai/gpt-5.2"), adapter=DSRSBAMLAdapter())
+```
+
+Building from git requires a Rust toolchain. See
+[`crates/dspy-py/README.md`](crates/dspy-py/README.md) for details.
+
 ## 🧪 Testing
 
 Run the test suite: