docs: add docs for mypy plugin

.github/workflows/pythonbuild.yml

@@ -205,9 +205,9 @@ jobs:
             tox-env: py312-azureblob
 
 
-          - python-version: 3.9
+          - python-version: "3.10"
             tox-env: flake8
-          - python-version: 3.9
+          - python-version: "3.10"
             tox-env: docs
 
     steps:

doc/conf.py

@@ -338,6 +338,8 @@ def _warn_node(self, msg, node, *args, **kwargs):
 # If true, do not generate a @detailmenu in the "Top" node's menu.
 #texinfo_no_detailmenu = False
 
+autodoc_mock_imports = ["mypy"]
+
 # Some regression introduced
 # https://github.com/sphinx-doc/sphinx/issues/2330
 # https://github.com/spotify/luigi/pull/1555

doc/index.rst

@@ -22,6 +22,7 @@ Table of Contents
    configuration.rst
    logging.rst
    design_and_limitations.rst
+   mypy.rst
 
 API Reference
 -------------

doc/mypy.rst

@@ -0,0 +1,42 @@
+Mypy plugin
+--------------
+
+Mypy plugin provides type checking for ``luigi.Task`` using Mypy.
+
+Require Python 3.8 or later.
+
+How to use
+~~~~~~~~~~
+
+Configure Mypy to use this plugin by adding the following to your ``mypy.ini`` file:
+
+.. code:: ini
+
+    [mypy]
+    plugins = luigi.mypy
+
+or by adding the following to your ``pyproject.toml`` file:
+
+.. code:: toml
+
+    [tool.mypy]
+    plugins = ["luigi.mypy"]
+
+Then, run Mypy as usual.
+
+Examples
+~~~~~~~~
+
+For example the following code linted by Mypy:
+
+.. code:: python
+
+    import luigi
+
+
+    class MyTask(luigi.Task):
+        foo: int = luigi.IntParameter()
+        bar: str = luigi.Parameter()
+
+    MyTask(foo=1, bar='2')   # OK
+    MyTask(foo='1', bar='2')  # Error: Argument 1 to "Foo" has incompatible type "str"; expected "int"

tox.ini

@@ -139,12 +139,11 @@ deps =
     sqlalchemy
     boto3
     jinja2==3.0.3
-    Sphinx>=1.4.4,<1.5
+    Sphinx>=1.4.4,<2.0
     sphinx_rtd_theme
     azure-storage-blob<=12.20.0
     prometheus-client==0.5.0
     alabaster<0.7.13
-    mypy
 commands =
 # build API docs
     sphinx-apidoc -o doc/api -T luigi --separate