python - 正确使用生成器输入

Question

我正在尝试向返回生成器的方法添加类型。每当我使用指定的返回类型运行该程序时，就会引发 TypeError。

添加引号或删除输入可以修复错误，但这看起来像是黑客。当然有一个正确的方法可以做到这一点。

def inbox_files(self) -> "Generator[RecordsFile]":
    ...

# OR

def inbox_files(self):
    ...

from typing import Generator, List
from .records_file import RecordsFile

Class Marshaller:

    ...

    def inbox_files(self) -> Generator[RecordsFile]:
        return self._search_directory(self._inbox)

    def _search_directory(self, directory: str) -> RecordsFile:
        for item_name in listdir(directory):
            item_path = path.join(item_name, directory)
            if path.isdir(item_path):
                yield from self._search_directory(item_path)
            elif path.isfile(item_path):
                yield RecordsFile(item_path)
            else:
                print(f"[WARN] Unknown item found: {item_path}")

生成以下堆栈跟踪:

Traceback (most recent call last):
  File "./bin/data_marshal", line 8, in <module>
    from src.app import App
  File "./src/app.py", line 9, in <module>
    from .marshaller import Marshaller
  File "./src/marshaller.py", line 9, in <module>
    class Marshaller:
  File "./src/marshaller.py", line 29, in Marshaller
    def inbox_files(self) -> Generator[RecordsFile]:
  File "/usr/local/Cellar/python/3.7.4/Frameworks/Python.framework/Versions/3.7/lib/python3.7/typing.py", line 254, in inner
    return func(*args, **kwds)
  File "/usr/local/Cellar/python/3.7.4/Frameworks/Python.framework/Versions/3.7/lib/python3.7/typing.py", line 630, in __getitem__
    _check_generic(self, params)
  File "/usr/local/Cellar/python/3.7.4/Frameworks/Python.framework/Versions/3.7/lib/python3.7/typing.py", line 208, in _check_generic
    raise TypeError(f"Too {'many' if alen > elen else 'few'} parameters for {cls};"
TypeError: Too few parameters for typing.Generator; actual 1, expected 3

́\_(ツ)_/́

Answer 1

您必须显式指定发送类型和返回类型，即使两者都是None。

def inbox_files(self) -> Generator[RecordsFile,None,None]:
    return self._search_directory(self._inbox)

请注意，yield 类型可能是您认为的返回类型。发送类型是您可以传递给生成器的 send 方法的值的类型。返回类型是在生成所有可能的值后，可以嵌入由 next 引发的 StopIteration 异常中的值的类型。考虑:

def foo():
    yield 3
    return "hi"

f = foo()

第一次调用 next(f) 将返回 3；第二个将引发 StopIteration("hi")。)

<小时/>

无法发送或返回的生成器只是一个可迭代对象或迭代器(显然都可以使用)。

def inbox_files(self) -> Iterable[RecordsFile]:  # Or Iterator[RecordsFile]
    return self._search_directory(self._inbox)

_search_directory 本身也返回一个生成器/可迭代对象，而不是 RecordsFile 的实例:

def _search_directory(self, directory: str) -> Iterable[RecordsFile]: