Don't install stubs automatically with mypy

When installing stubs automatically with `mypy` we can't pin the
dependencies, and we make it harder to just run `mypy` without going
through `nox`.

From now on, dependencies must be explicitly declared in the
`pyproject.toml` file, in the optional `dev-mypy` dependencies.

Signed-off-by: Leandro Lucarella <[email protected]>

Author: llucax

cookiecutter/{{cookiecutter.github_repo_name}}/pyproject.toml

@@ -79,6 +79,9 @@ dev-mkdocs = [
 ]
 dev-mypy = [
   "mypy == 1.5.1",
+{%- if cookiecutter.type == "api" %}
+  "grpc-stubs == 1.53.0.2",
+{%- endif %}
   # For checking the noxfile, docs/ script, and tests
   "{{cookiecutter.pypi_package_name}}[dev-mkdocs,dev-noxfile,dev-pytest]",
 ]

pyproject.toml

@@ -79,7 +79,11 @@ dev-mkdocs = [
 ]
 dev-mypy = [
   "mypy == 1.5.1",
-  "types-setuptools >= 67.6.0, < 68", # Should match the global dependency
+  "types-setuptools == 68.1.0.0", # Should match the build dependency
+  "types-Markdown == 3.4.2.10",
+  "types-PyYAML == 6.0.12.11",
+  "types-babel == 2.11.0.15",
+  "types-colorama == 0.4.15.12",
   # For checking the noxfile, docs/ script, and tests
   "frequenz-repo-config[dev-mkdocs,dev-noxfile,dev-pytest]",
 ]

src/frequenz/repo/config/__init__.py

@@ -189,6 +189,23 @@
 You can just call `mypy` to check the package of your sources or you can use `mypy
 tests` to check the tests, for example.
 
+You might also need to extra optional dependencies to install type checking stubs for
+some packages.  For example for API projects you need the `grpc-stubs` package:
+
+```toml
+[project.optional-dependencies]
+# ...
+dev-mypy = [
+    # ...
+    "grpc-stubs == 1.53.0.2",
+    # ...
+]
+```
+
+You can use `mypy --install-types` to install to get a list of missing stubs, `mypy`
+will list them for you and ask if you want to proceed with the installation.  You can
+answer no and copy the list of missing stubs to the `pyproject.toml` file.
+
 ## `mkdocs` (generating documentation)
 
 ### API reference generation

src/frequenz/repo/config/nox/default.py

@@ -35,10 +35,7 @@
         "--diff",
         "--check",
     ],
-    mypy=[
-        "--install-types",
-        "--non-interactive",
-    ],
+    mypy=[],
     pytest=[
         "-W=all",
         "-vv",

tests_golden/integration/test_cookiecutter_generation/api/frequenz-api-test/pyproject.toml

@@ -59,6 +59,7 @@ dev-mkdocs = [
 ]
 dev-mypy = [
   "mypy == 1.5.1",
+  "grpc-stubs == 1.53.0.2",
   # For checking the noxfile, docs/ script, and tests
   "frequenz-api-test[dev-mkdocs,dev-noxfile,dev-pytest]",
 ]