mypy: Use --strict (#859)

See also: https://mypy.readthedocs.io/en/stable/command_line.html#cmdoption-mypy-strict

Author: tony

CHANGES

@@ -25,6 +25,12 @@ $ pipx install --suffix=@next 'tmuxp' --pip-args '\--pre' --force
 
 ### Development
 
+- **Improved typings**
+
+  Now [`mypy --strict`] compliant (#859)
+
+  [`mypy --strict`]: https://mypy.readthedocs.io/en/stable/command_line.html#cmdoption-mypy-strict
+
 - Poetry 1.5.1 -> 1.6.1 (#885)
 
 ## tmuxp 1.30.1 (2023-09-09)
@@ -35,7 +41,7 @@ _Maintenance only, no bug fixes or new features_
 
 - Cut last python 3.7 release (EOL was June 27th, 2023)
 
-  For security updates, a 1.30.x branch can be maintained for a limited time, 
+  For security updates, a 1.30.x branch can be maintained for a limited time,
   if necessary.
 
 ## tmuxp 1.30.0 (2023-09-04)
@@ -49,6 +55,7 @@ _Maintenance only, no bug fixes or new features_
   This includes fixes made by hand alongside ruff's automated fixes. The more
   stringent rules include import sorting, and still runs almost instantly
   against the whole codebase.
+
 - CI: `black . --check` now runs on pushes and pull requests
 
 ### Packaging

docs/_ext/aafig.py

@@ -21,6 +21,10 @@
 from sphinx.errors import SphinxError
 from sphinx.util.osutil import ensuredir, relative_uri
 
+if t.TYPE_CHECKING:
+    from sphinx.application import Sphinx
+
+
 try:
     import aafigure
 except ImportError:
@@ -32,14 +36,18 @@
 DEFAULT_FORMATS = {"html": "svg", "latex": "pdf", "text": None}
 
 
-def merge_dict(dst, src):
+def merge_dict(
+    dst: t.Dict[str, t.Optional[str]], src: t.Dict[str, t.Optional[str]]
+) -> t.Dict[str, t.Optional[str]]:
     for k, v in src.items():
         if k not in dst:
             dst[k] = v
     return dst
 
 
-def get_basename(text, options, prefix="aafig"):
+def get_basename(
+    text: str, options: t.Dict[str, str], prefix: t.Optional[str] = "aafig"
+) -> str:
     options = options.copy()
     if "format" in options:
         del options["format"]
@@ -52,7 +60,7 @@ class AafigError(SphinxError):
     category = "aafig error"
 
 
-class AafigDirective(images.Image):
+class AafigDirective(images.Image):  # type:ignore
     """
     Directive to insert an ASCII art figure to be rendered by aafigure.
     """
@@ -71,7 +79,7 @@ class AafigDirective(images.Image):
     option_spec = images.Image.option_spec.copy()
     option_spec.update(own_option_spec)
 
-    def run(self):
+    def run(self) -> t.List[nodes.Node]:
         aafig_options = {}
         own_options_keys = [self.own_option_spec.keys(), "scale"]
         for k, v in self.options.items():
@@ -93,7 +101,7 @@ def run(self):
         return [image_node]
 
 
-def render_aafig_images(app, doctree):
+def render_aafig_images(app: "Sphinx", doctree: nodes.Node) -> None:
     format_map = app.builder.config.aafig_format
     merge_dict(format_map, DEFAULT_FORMATS)
     if aafigure is None:
@@ -144,7 +152,9 @@ def __init__(self, *args: object, **kwargs: object) -> None:
         return super().__init__("aafigure module not installed", *args, **kwargs)
 
 
-def render_aafigure(app, text, options):
+def render_aafigure(
+    app: "Sphinx", text: str, options: t.Dict[str, str]
+) -> t.Tuple[str, str, t.Optional[str], t.Optional[str]]:
     """
     Render an ASCII art figure into the requested format output file.
     """
@@ -186,7 +196,7 @@ def render_aafigure(app, text, options):
                 finally:
                     if f is not None:
                         f.close()
-            return relfn, outfn, id, extra
+            return relfn, outfn, None, extra
     except AafigError:
         pass
 
@@ -204,10 +214,10 @@ def render_aafigure(app, text, options):
         with open(metadata_fname, "w") as f:
             f.write(extra)
 
-    return relfn, outfn, id, extra
+    return relfn, outfn, None, extra
 
 
-def setup(app):
+def setup(app: "Sphinx") -> None:
     app.add_directive("aafig", AafigDirective)
     app.connect("doctree-read", render_aafig_images)
     app.add_config_value("aafig_format", DEFAULT_FORMATS, "html")

docs/conf.py

@@ -11,7 +11,6 @@
 if t.TYPE_CHECKING:
     from sphinx.application import Sphinx
 
-
 # Get the project root dir, which is the parent dir of this
 cwd = pathlib.Path(__file__).parent
 project_root = cwd.parent
@@ -177,7 +176,7 @@
 aafig_default_options = {"scale": 0.75, "aspect": 0.5, "proportional": True}
 
 
-def linkcode_resolve(domain, info):
+def linkcode_resolve(domain: str, info: t.Dict[str, str]) -> t.Union[None, str]:
     """
     Determine the URL corresponding to Python object
 
@@ -210,7 +209,8 @@ def linkcode_resolve(domain, info):
     except AttributeError:
         pass
     else:
-        obj = unwrap(obj)
+        if callable(obj):
+            obj = unwrap(obj)
 
     try:
         fn = inspect.getsourcefile(obj)

pyproject.toml

@@ -138,10 +138,12 @@ exclude_lines = [
 ]
 
 [tool.mypy]
+strict = true
 files = [
   "src/",
   "tests/",
 ]
+enable_incomplete_feature = ["Unpack"]
 
 [[tool.mypy.overrides]]
 module = [

src/tmuxp/_compat.py

@@ -12,7 +12,7 @@
 else:
     import pdb
 
-    breakpoint = pdb.set_trace  # type: ignore
+    breakpoint = pdb.set_trace
 
 
 console_encoding = sys.__stdout__.encoding

src/tmuxp/_types.py

@@ -0,0 +1,27 @@
+"""Internal, :const:`typing.TYPE_CHECKING` guarded :term:`type annotations <annotation>`
+
+These are _not_ to be imported at runtime as `typing_extensions` is not
+bundled with tmuxp. Usage example:
+
+>>> import typing as t
+
+>>> if t.TYPE_CHECKING:
+...     from tmuxp._types import PluginConfigSchema
+...
+"""
+import typing as t
+
+from typing_extensions import NotRequired, TypedDict
+
+
+class PluginConfigSchema(TypedDict):
+    plugin_name: NotRequired[str]
+    tmux_min_version: NotRequired[str]
+    tmux_max_version: NotRequired[str]
+    tmux_version_incompatible: NotRequired[t.List[str]]
+    libtmux_min_version: NotRequired[str]
+    libtmux_max_version: NotRequired[str]
+    libtmux_version_incompatible: NotRequired[t.List[str]]
+    tmuxp_min_version: NotRequired[str]
+    tmuxp_max_version: NotRequired[str]
+    tmuxp_version_incompatible: NotRequired[t.List[str]]

src/tmuxp/cli/debug_info.py

@@ -29,19 +29,19 @@ def command_debug_info(
     Print debug info to submit with Issues.
     """
 
-    def prepend_tab(strings):
+    def prepend_tab(strings: t.List[str]) -> t.List[str]:
         """
         Prepend tab to strings in list.
         """
         return ["\t%s" % x for x in strings]
 
-    def output_break():
+    def output_break() -> str:
         """
         Generate output break.
         """
         return "-" * 25
 
-    def format_tmux_resp(std_resp):
+    def format_tmux_resp(std_resp: tmux_cmd) -> str:
         """
         Format tmux command response for tmuxp stdout.
         """

src/tmuxp/cli/edit.py

@@ -22,7 +22,7 @@ def create_edit_subparser(
 def command_edit(
     workspace_file: t.Union[str, pathlib.Path],
     parser: t.Optional[argparse.ArgumentParser] = None,
-):
+) -> None:
     workspace_file = find_workspace_file(workspace_file)
 
     sys_editor = os.environ.get("EDITOR", "vim")

src/tmuxp/cli/freeze.py

@@ -31,12 +31,6 @@ class CLIFreezeNamespace(argparse.Namespace):
     force: t.Optional[bool]
 
 
-def session_completion(ctx, params, incomplete):
-    server = Server()
-    choices = [session.name for session in server.sessions]
-    return sorted(str(c) for c in choices if str(c).startswith(incomplete))
-
-
 def create_freeze_subparser(
     parser: argparse.ArgumentParser,
 ) -> argparse.ArgumentParser:
@@ -177,12 +171,14 @@ def extract_workspace_format(
 
         workspace_format = extract_workspace_format(dest)
         if not is_valid_ext(workspace_format):
-            workspace_format = prompt_choices(
+            _workspace_format = prompt_choices(
                 "Couldn't ascertain one of [%s] from file name. Convert to"
                 % ", ".join(valid_workspace_formats),
-                choices=valid_workspace_formats,
+                choices=t.cast(t.List[str], valid_workspace_formats),
                 default="yaml",
             )
+            assert is_valid_ext(_workspace_format)
+            workspace_format = _workspace_format
 
     if workspace_format == "yaml":
         workspace = configparser.dump(

src/tmuxp/cli/import_config.py

@@ -59,7 +59,7 @@ def command_import(
     workspace_file: str,
     print_list: str,
     parser: argparse.ArgumentParser,
-):
+) -> None:
     """Import a teamocil/tmuxinator config."""
 
 
@@ -116,9 +116,14 @@ def create_import_subparser(
     return parser
 
 
+class ImportConfigFn(t.Protocol):
+    def __call__(self, workspace_dict: t.Dict[str, t.Any]) -> t.Dict[str, t.Any]:
+        ...
+
+
 def import_config(
     workspace_file: str,
-    importfunc: t.Callable,
+    importfunc: ImportConfigFn,
     parser: t.Optional[argparse.ArgumentParser] = None,
 ) -> None:
     existing_workspace_file = ConfigReader._from_file(pathlib.Path(workspace_file))