From a6cbe5346d32436f1631d4602ce0070d9f80d544 Mon Sep 17 00:00:00 2001
From: G-Glitch404 <awysf1238@gmail.com>
Date: Thu, 1 Oct 2026 20:33:00 +0300
Subject: [PATCH] docs: publish Sphinx object inventory

---
 .github/workflows/check-docs.yml   |  8 +++++++-
 .github/workflows/publish-docs.yml | 10 ++++++++--
 docs/objects.md                    | 17 +++++++++++++++++
 mkdocs.yaml                        |  9 ++++++++-
 noxfile.py                         | 11 ++++++++++-
 5 files changed, 50 insertions(+), 5 deletions(-)
 create mode 100644 docs/objects.md

diff --git a/.github/workflows/check-docs.yml b/.github/workflows/check-docs.yml
index c31ad8c..de9e9d9 100644
--- a/.github/workflows/check-docs.yml
+++ b/.github/workflows/check-docs.yml
@@ -4,6 +4,12 @@ on:
   pull_request:
     paths:
       - 'docs/**'
+      - 'mkdocs.yaml'
+      - 'noxfile.py'
+      - 'setup.py'
+      - 'respx/__init__.py'
+      - 'respx/router.py'
+      - 'scripts/check_docs_inventory.py'
       - '.github/workflows/check-docs.yml'
 
 jobs:
@@ -17,4 +23,4 @@ jobs:
           python-version: "3.10"
       - run: pip install nox
       - name: Build
-        run: nox -N -s docs
+        run: nox -N -s docs_test
diff --git a/.github/workflows/publish-docs.yml b/.github/workflows/publish-docs.yml
index be8d4ac..e2f7611 100644
--- a/.github/workflows/publish-docs.yml
+++ b/.github/workflows/publish-docs.yml
@@ -6,7 +6,13 @@ on:
       - master
     paths:
       - 'docs/**'
-      - '.github/workflows/docs.yml'
+      - 'mkdocs.yaml'
+      - 'noxfile.py'
+      - 'setup.py'
+      - 'respx/__init__.py'
+      - 'respx/router.py'
+      - 'scripts/check_docs_inventory.py'
+      - '.github/workflows/publish-docs.yml'
 
 jobs:
   build:
@@ -19,7 +25,7 @@ jobs:
         python-version: "3.10"
     - run: pip install nox
     - name: Build
-      run: nox -N -s docs
+      run: nox -N -s docs_test
     - name: Publish
       if: github.repository_owner == 'lundberg'
       run: |
diff --git a/docs/objects.md b/docs/objects.md
new file mode 100644
index 0000000..73a0b79
--- /dev/null
+++ b/docs/objects.md
@@ -0,0 +1,17 @@
+# API Objects
+
+::: respx.Router
+    options:
+      members: false
+      show_if_no_docstring: true
+      show_root_full_path: false
+      show_root_heading: true
+      show_source: false
+
+::: respx.MockRouter
+    options:
+      members: false
+      show_if_no_docstring: true
+      show_root_full_path: false
+      show_root_heading: true
+      show_source: false
diff --git a/mkdocs.yaml b/mkdocs.yaml
index f34a042..756ed0a 100644
--- a/mkdocs.yaml
+++ b/mkdocs.yaml
@@ -41,8 +41,15 @@ nav:
       - Mock HTTPX: "versions/0.14.0/mocking.md"
       - Developer Interface: "versions/0.14.0/api.md"
 
+not_in_nav: |
+  /objects.md
+
+plugins:
+  - search
+  - mkdocstrings:
+      enable_inventory: true
+
 markdown_extensions:
   - admonition
   - codehilite:
       css_class: highlight
-  - mkautodoc
diff --git a/noxfile.py b/noxfile.py
index 262ef14..49f8db6 100644
--- a/noxfile.py
+++ b/noxfile.py
@@ -26,8 +26,17 @@ def mypy(session):
 
 @nox.session(python="3.10")
 def docs(session):
-    deps = ["mkdocs", "mkdocs-material", "mkautodoc>=0.1.0"]
+    deps = [
+        "mkdocs",
+        "mkdocs-material",
+        "mkdocstrings[python]>=1.0",
+    ]
     session.install("--upgrade", *deps)
     session.install("-e", ".")
     args = session.posargs if session.posargs else ["build"]
     session.run("mkdocs", *args)
+
+
+@nox.session(python="3.10", requires=["docs"])
+def docs_test(session):
+    session.run("python", "scripts/check_docs_inventory.py")