Move options to pyproject.toml

It is possible to define most options within the `pyproject.toml` file,
which offers several advantages: the tool can be used from the command
line directly (bypassing the need for `nox`), without having to remember
the options. It also facilitates other integrations that need to invoke
mypy directly.

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

Author: llucax

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

@@ -169,6 +169,11 @@ required_plugins = ["pytest-asyncio", "pytest-mock"]
 {%- else %}
 testpaths = ["pytests"]
 {%- endif %}
+
+[tool.mypy]
+explicit_package_bases = true
+namespace_packages = true
+strict = true
 {%- if cookiecutter.type != "api" %}
 
 [[tool.mypy.overrides]]

pyproject.toml

@@ -153,6 +153,11 @@ disable = [
   "unnecessary-lambda-assignment",
 ]
 
+[tool.mypy]
+explicit_package_bases = true
+namespace_packages = true
+strict = true
+
 [[tool.mypy.overrides]]
 module = ["cookiecutter", "cookiecutter.*", "sybil", "sybil.*"]
 ignore_missing_imports = true

src/frequenz/repo/config/__init__.py

@@ -52,6 +52,12 @@
 nox.configure(config)
 ```
 
+!!! note
+
+    When possible, it is recommended to define options in the `pyproject.toml` file
+    (most tools can do this), so they can be consistently used even if the tool is used
+    outside of `nox`.
+
 If you need further customization or to define new sessions, you can use the
 following modules:
 
@@ -167,6 +173,18 @@
 ]
 ```
 
+## `mypy` (static type checking)
+
+To configure `mypy` you can add the recommended options to the `pyproject.toml` file as
+follows:
+
+```toml
+[tool.mypy]
+explicit_package_bases = true
+namespace_packages = true
+strict = true
+```
+
 ## `mkdocs` (generating documentation)
 
 ### API reference generation

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

@@ -37,10 +37,7 @@
     ],
     mypy=[
         "--install-types",
-        "--namespace-packages",
         "--non-interactive",
-        "--explicit-package-bases",
-        "--strict",
     ],
     # SDK: pylint "--extension-pkg-whitelist=pydantic"
     pytest=[

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

@@ -143,6 +143,11 @@ testpaths = ["tests", "src"]
 asyncio_mode = "auto"
 required_plugins = ["pytest-asyncio", "pytest-mock"]
 
+[tool.mypy]
+explicit_package_bases = true
+namespace_packages = true
+strict = true
+
 [[tool.mypy.overrides]]
 module = ["async_solipsism", "async_solipsism.*", "sybil", "sybil.*"]
 ignore_missing_imports = true

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

@@ -135,6 +135,11 @@ disable = [
 [tool.pytest.ini_options]
 testpaths = ["pytests"]
 
+[tool.mypy]
+explicit_package_bases = true
+namespace_packages = true
+strict = true
+
 [tool.setuptools.package-dir]
 "" = "py"
 

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

@@ -142,6 +142,11 @@ testpaths = ["tests", "src"]
 asyncio_mode = "auto"
 required_plugins = ["pytest-asyncio", "pytest-mock"]
 
+[tool.mypy]
+explicit_package_bases = true
+namespace_packages = true
+strict = true
+
 [[tool.mypy.overrides]]
 module = ["async_solipsism", "async_solipsism.*", "sybil", "sybil.*"]
 ignore_missing_imports = true

tests_golden/integration/test_cookiecutter_generation/lib/frequenz-test-python/pyproject.toml

@@ -139,6 +139,11 @@ testpaths = ["tests", "src"]
 asyncio_mode = "auto"
 required_plugins = ["pytest-asyncio", "pytest-mock"]
 
+[tool.mypy]
+explicit_package_bases = true
+namespace_packages = true
+strict = true
+
 [[tool.mypy.overrides]]
 module = ["async_solipsism", "async_solipsism.*", "sybil", "sybil.*"]
 ignore_missing_imports = true

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

@@ -143,6 +143,11 @@ testpaths = ["tests", "src"]
 asyncio_mode = "auto"
 required_plugins = ["pytest-asyncio", "pytest-mock"]
 
+[tool.mypy]
+explicit_package_bases = true
+namespace_packages = true
+strict = true
+
 [[tool.mypy.overrides]]
 module = ["async_solipsism", "async_solipsism.*", "sybil", "sybil.*"]
 ignore_missing_imports = true