Type checking improvements

- Add a PEP 561 marker file (py.typed).
- Run mypy during CI.
- Update black to avoid pallets/click#2225

Author: bringhurst

Makefile

@@ -1,6 +1,7 @@
 .DEFAULT_GOAL := all
 isort = isort devtools tests
 black = black -S -l 120 --target-version py37 devtools
+mypy = mypy devtools
 
 .PHONY: install
 install:
@@ -18,6 +19,7 @@ lint:
 	flake8 devtools/ tests/
 	$(isort) --check-only --df
 	$(black) --check --diff
+	$(mypy)
 
 .PHONY: test
 test:

devtools/py.typed

@@ -0,0 +1 @@
+# PEP-561 marker. https://mypy.readthedocs.io/en/latest/installed_packages.html

mypy.ini

@@ -0,0 +1,78 @@
+[mypy]
+
+# Import discovery
+mypy_path = devtools
+namespace_packages = true
+
+# Disallow dynamic typing
+disallow_any_unimported = true
+disallow_any_expr = false
+disallow_any_decorated = false
+disallow_any_explicit = false
+disallow_any_generics = false
+disallow_subclassing_any = true
+
+# Untyped definitions and calls
+disallow_untyped_calls = false
+disallow_untyped_defs = false
+disallow_incomplete_defs = true
+check_untyped_defs = true
+disallow_untyped_decorators = true
+
+# None and Optional handling
+no_implicit_optional = true
+strict_optional = true
+
+# Configuring warning
+warn_redundant_casts = true
+warn_unused_ignores = true
+warn_no_return = true
+warn_return_any = false
+warn_unreachable = true
+
+# Suppressing errors
+show_none_errors = true
+ignore_errors = false
+
+# Miscellaneous strictness flags
+allow_untyped_globals = false
+allow_redefinition = false
+implicit_reexport = false
+strict_equality = true
+
+# Configuring error messages
+show_error_context = true
+show_column_numbers = true
+show_error_codes = true
+pretty = true
+color_output = true
+error_summary = true
+show_absolute_path = true
+
+# Advanced options
+show_traceback = true
+raise_exceptions = true
+
+# Miscellaneous
+warn_unused_configs = true
+verbosity = 0
+
+#
+# Please do not add any additional mypy ignores in this section!
+#
+
+[mypy-devtools.utils]
+# FIXME: Remove this ignore after fixing type errors.
+ignore_errors = true
+
+[mypy-devtools.prettier]
+# FIXME: Remove this ignore after fixing type errors.
+ignore_errors = true
+
+[mypy-devtools.ansi]
+# FIXME: Remove this ignore after fixing type errors.
+ignore_errors = true
+
+[mypy-devtools.debug]
+# FIXME: Remove this ignore after fixing type errors.
+ignore_errors = true

setup.py

@@ -49,6 +49,7 @@
     url='https://github.com/samuelcolvin/python-devtools',
     license='MIT',
     packages=['devtools'],
+    package_data={"devtools": ["py.typed"]},
     python_requires='>=3.6',
     install_requires=[
         'executing>=0.8.0,<1.0.0',

tests/requirements-linting.txt

@@ -1,6 +1,7 @@
-black==20.8b1
+black==22.3.0
 flake8==3.9.2
 isort==5.9.3
-mypy==0.910
+mypy==0.950
 pycodestyle==2.7.0
 pyflakes==2.3.1
+types-Pygments==2.9.19