build(type): add types-docutils to type dependency group

gaborbernat · gaborbernat · commit 08b5824dbe97 · 2026-05-02T07:04:27.000+01:00
ty reads docutils source when stubs are absent and infers option_spec
as an instance variable, causing invalid-attribute-override errors.
The types-docutils stubs correctly declare it as ClassVar.
diff --git a/docs/changelog/3932.bugfix.rst b/docs/changelog/3932.bugfix.rst
@@ -1,5 +1,5 @@
-Correct type annotations for `ArgumentParser.parse_args` and `parse_known_args` overrides following
-`typeshed PR #15613 <https://github.com/python/typeshed/pull/15613>`\_, which widened the `args` parameter from
-`Sequence[str]` to `Iterable[str]`. The narrower type in tox's overrides violated the Liskov substitution principle and
-caused `invalid-method-override` errors with `ty` 0.0.33. Also correct the `option_spec` annotation in
-`docs/tox_conf.py` to use `ClassVar[dict[str, Callable[[str], Any]]]` matching the docutils stubs type.
+Correct type annotations for ``ArgumentParser.parse_args`` and ``parse_known_args`` overrides following `typeshed PR
+#15613 <https://github.com/python/typeshed/pull/15613>`_, which widened the ``args`` parameter from ``Sequence[str]`` to
+``Iterable[str]``. The narrower type in tox's overrides violated the Liskov substitution principle and caused
+``invalid-method-override`` errors with ``ty`` 0.0.33. Also correct the ``option_spec`` annotation in
+``docs/tox_conf.py`` to ``ClassVar[dict[str, Callable[[str], Any]]]`` matching the docutils stubs type.
diff --git a/pyproject.toml b/pyproject.toml
@@ -104,6 +104,7 @@ test = [
 ]
 type = [
   "ty>=0.0.19",
+  "types-docutils>=0.21",
   { include-group = "docs" },
   { include-group = "release" },
   { include-group = "test" },

Original file line number	Diff line number	Diff line change
`@@ -104,6 +104,7 @@ test = [`
`104`	`104`	`]`
`105`	`105`	`type = [`
`106`	`106`	`"ty>=0.0.19",`
	`107`	`+ "types-docutils>=0.21",`
`107`	`108`	`{ include-group = "docs" },`
`108`	`109`	`{ include-group = "release" },`
`109`	`110`	`{ include-group = "test" },`