Fix mypy errors in docs/source/conf and tests/interface/test-utilities (#617)

Fix mypy errors in docs/source/conf and tests/interface/test-utilities

Fix mypy erros in additional modules.
- *Category*: Type hinting
- *JIRA issue*: https://jira.ihme.washington.edu/browse/MIC-5742
- *JIRA issue*: https://jira.ihme.washington.edu/browse/MIC-5336

### Changes and notes
<!-- 
Change description – why, what, anything unexplained by the above.
Include guidance to reviewers if changes are complex.
--> 

### Testing
<!--
Details on how code was verified, any unit tests local for the
repo, regression testing, etc. At a minimum, this should include an
integration test for a framework change. Consider: plots, images,
(small) csv file.
-->

Author: albrja

CHANGELOG.rst

@@ -1,3 +1,8 @@
+**3.3.20 - 04/30/25**
+
+  - Type-hinting: Fix mypy errors in docs/source/conf.py
+  - Type-hinting: Fix mypy errors in tests/interface/test_utilities.py
+
 **3.3.19 - 04/29/25**
 
   - Type-hinting: Fix mypy errors in tests/framework/test_values.py 

docs/source/conf.py

@@ -21,7 +21,7 @@
 
 base_dir = Path(vivarium.__file__).parent
 
-about = {}
+about: dict[str, str] = {}
 with (base_dir / "__about__.py").open() as f:
     exec(f.read(), about)
 
@@ -88,7 +88,7 @@
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
 # This patterns also effect to html_static_path and html_extra_path
-exclude_patterns = []
+exclude_patterns: list[str] = []
 
 # The name of the Pygments (syntax highlighting) style to use.
 pygments_style = "sphinx"
@@ -137,7 +137,7 @@
 
 # -- Options for LaTeX output ---------------------------------------------
 
-latex_elements = {
+latex_elements: dict[str, str] = {
     # The paper size ('letterpaper' or 'a4paper').
     #
     # 'papersize': 'letterpaper',

pyproject.toml

@@ -30,7 +30,6 @@ exclude = [
     'build',
     # Files below here should have their errors fixed and then be removed from this list
     # You will need to remove the mypy: ignore-errors comment from the file heading as well
-    'docs/source/conf.py',
     'setup.py',
     'src/vivarium/examples/disease_model/disease.py',
     'src/vivarium/examples/disease_model/intervention.py',
@@ -41,7 +40,6 @@ exclude = [
     'src/vivarium/testing_utilities.py',
     'tests/framework/results/test_context.py',
     'tests/framework/test_event.py',
-    'tests/interface/test_utilities.py',
 ]
 
 disable_error_code = []

tests/interface/test_utilities.py

@@ -27,7 +27,7 @@
 )
 
 
-def _write_file(path: Path, contents: str):
+def _write_file(path: Path, contents: str) -> None:
     with open(path, "w") as file:
         file.write(contents)
 
@@ -59,12 +59,12 @@ def _write_file(path: Path, contents: str):
     ],
 )
 def test_get_output_model_name_string(
-    artifact_path,
-    model_spec_filename,
-    contents,
-    expected_output,
-    tmp_path,
-):
+    artifact_path: Path,
+    model_spec_filename: str,
+    contents: str,
+    expected_output: str,
+    tmp_path: Path,
+) -> None:
     model_spec_path = Path(f"{tmp_path}/{model_spec_filename}")
     _write_file(model_spec_path, contents)