Introduce manual mypy checking on the docs/ dir (#1412)

Author: sirosen

pyproject.toml

@@ -181,6 +181,12 @@ sqlite_cache = true
 warn_unreachable = true
 warn_no_return = true
 
+[[tool.mypy.overrides]]
+module = "docs.*"
+allow_untyped_calls = true
+allow_untyped_defs = true
+ignore_missing_imports = true
+
 [tool.pylint]
 load-plugins = ["pylint.extensions.docparams"]
 accept-no-param-doc = "false"

tox.ini

@@ -61,6 +61,12 @@ commands = mypy src/ {posargs}
 base = mypy
 commands = mypy --show-error-codes --warn-unused-ignores tests/non-pytest/mypy-ignore-tests/
 
+[testenv:mypy-docs]
+base = mypy
+# docs isn't really a package, so avoid errors related to it being improperly
+# treated like one (this doesn't work via config)
+commands = mypy --explicit-package-bases {posargs:docs/}
+
 [testenv:test-lazy-imports]
 deps = -r requirements/py{py_dot_ver}/test.txt
 commands =