Skip to content

Hold Sphinx <9 Until sphinx-doc/sphinx#14159 is fixed #56

Description

@akkornel

While testing #44, I found that Sphinx 9 returns a confusing warning:

<unknown>:1: WARNING: py:class reference target not found: collections.abc.MutableMapping[str [ref.class]

MutableMapping is referenced in two places:

  • src/stanford/mais/account/__init__.py, in AccountClient
  • src/stanford/mais/workgroup/__init__.py, in WorkgroupClient

This appears to me to be an issue with Sphinx, so I opened sphinx-doc/sphinx#14547 to report the problem. The problem appears to be introduced in Sphinx 9.0.0, and persists through to today's master commit (sphinx-doc/sphinx@c1b618c).

In order to keep from moving to a later Sphinx version, I need to make a note in pyproject.toml, and also tell Dependabot not to attempt upgrading Sphinx.

Once the problem is fixed upstream, then pyproject.toml can be updated, and Dependabot released.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

bugSomething isn't workingupstreamSomething which needs a fix upstream

Type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions