Skip to content

Publish objects.inv for Sphinx/mkdocstrings intersphinx #305

@adamtheturtle

Description

@adamtheturtle

Context

Projects that depend on respx (e.g. openapi-mock) document respx types like MockRouter and Router in their API docs. Without an objects.inv file, we can't create proper cross-references—we have to add nitpick_ignore entries and lose the ability to link to respx's documentation.

Request

Please publish an objects.inv file alongside the documentation at https://lundberg.github.io/respx/. This would allow dependent projects to use intersphinx and link to respx types.

Related

  • httpx has an open discussion for the same: objects.inv - available? encode/httpx#3091
  • If respx uses mkdocstrings for API docs, it can generate objects.inv automatically
  • Sphinx projects use intersphinx_mapping to consume it; mkdocstrings has similar support

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions