test: update mypy typings

invoke/collection.py

@@ -1,6 +1,6 @@
 import copy
 from types import ModuleType
-from typing import Any, Callable, Dict, List, Optional, Tuple
+from typing import Any, Callable, Dict, List, Optional, Tuple, Union
 
 from .util import Lexicon, helpline
 
@@ -284,7 +284,7 @@ def add_task(
 
     def add_collection(
         self,
-        coll: "Collection",
+        coll: Union["Collection", ModuleType],
         name: Optional[str] = None,
         default: Optional[bool] = None,
     ) -> None:

invoke/context.py

@@ -389,7 +389,7 @@ def cd(self, path: Union[PathLike, str]) -> Generator[None, None, None]:
             (such as the various ``Path`` objects out there), and not just
             string literals.
         """
-        path = str(path)
+        path = os.fspath(path)
         self.command_cwds.append(path)
         try:
             yield

invoke/parser/context.py

@@ -91,7 +91,7 @@ def __init__(
         self.args = Lexicon()
         self.positional_args: List[Argument] = []
         self.flags = Lexicon()
-        self.inverse_flags: Dict[str, str] = {}  # No need for Lexicon here
+        self.inverse_flags: Dict[str, Any] = {}  # No need for Lexicon here
         self.name = name
         self.aliases = aliases
         for arg in args:

invoke/runners.py

@@ -19,6 +19,7 @@
     Optional,
     Tuple,
     Type,
+    overload,
 )
 
 # Import some platform-specific things at top level so they can be mocked for
@@ -122,6 +123,16 @@ def __init__(self, context: "Context") -> None:
         self._asynchronous = False
         self._disowned = False
 
+    @overload
+    def run(self, command: str, *, disowned: None, **kwargs: Any) -> "Result":
+        ...
+
+    @overload
+    def run(
+        self, command: str, *, disowned: bool, **kwargs: Any
+    ) -> Optional["Result"]:
+        ...
+
     def run(self, command: str, **kwargs: Any) -> Optional["Result"]:
         """
         Execute ``command``, returning an instance of `Result` once complete.
@@ -1481,7 +1492,7 @@ def __init__(
         exited: int = 0,
         pty: bool = False,
         hide: Tuple[str, ...] = tuple(),
-    ):
+    ) -> None:
         self.stdout = stdout
         self.stderr = stderr
         if encoding is None:
@@ -1506,6 +1517,9 @@ def return_code(self) -> int:
     def __bool__(self) -> bool:
         return self.ok
 
+    def __int__(self) -> int:
+        return self.exited
+
     def __str__(self) -> str:
         if self.exited is not None:
             desc = "Command exited with status {}.".format(self.exited)

invoke/tasks.py

@@ -21,6 +21,7 @@
     Type,
     TypeVar,
     Union,
+    cast,
 )
 
 from .context import Context
@@ -286,7 +287,7 @@ def get_arguments(
         return args
 
 
-def task(*args: Any, **kwargs: Any) -> Callable:
+def task(*args: Any, **kwargs: Any) -> "Task[T]":
     """
     Marks wrapped callable object as a valid Invoke task.
 
@@ -357,7 +358,7 @@ def inner(body: Callable) -> Task[T]:
         return _task
 
     # update_wrapper(inner, klass)
-    return inner
+    return cast('Task["T"]', inner)
 
 
 class Call:

tasks.py

@@ -53,7 +53,7 @@ def test(
 
 # TODO: replace with invocations' once the "call truly local tester" problem is
 # solved (see other TODOs). For now this is just a copy/paste/modify.
-@task(help=test.help)  # type: ignore
+@task(help=test.help)
 def integration(
     c: "Context", opts: Optional[str] = None, pty: bool = True
 ) -> None:

tests/context.py

@@ -213,7 +213,7 @@ class Path:
                 def __init__(self, value):
                     self.value = value
 
-                def __str__(self):
+                def __fspath__(self):
                     return self.value
 
             runner = Local.return_value