From cb3fd4526a2eb65a649c604c90eb547c06d9b280 Mon Sep 17 00:00:00 2001
From: Kenneth Reitz <me@kennethreitz.org>
Date: Sun, 22 Mar 2026 05:52:50 -0400
Subject: [PATCH] Fix docs build: mock sounddevice for environments without
 PortAudio

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 docs/conf.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/conf.py b/docs/conf.py
index 579e3f0..157a63c 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -1,8 +1,12 @@
 import os
 import sys
+from unittest.mock import MagicMock
 
 sys.path.insert(0, os.path.abspath(".."))
 
+# Mock sounddevice so Sphinx can import pytheory.play without PortAudio
+sys.modules["sounddevice"] = MagicMock()
+
 project = "PyTheory"
 copyright = "2024, Kenneth Reitz"
 author = "Kenneth Reitz"