我有一个带有类型提示的长签名的函数,例如
def set_parameters(
tokenizer: Union[None, "Tokenizer", str] = None,
vocab: Optional["Vocab"] = None,
vocab_from: Optional[Dict[str, str]] = None,
max_sent_length: Optional[int] = None,
max_turn_length: Optional[int] = None,
convert_to_lower_letter: Optional[bool] = None,
weak=False) -> "FieldContext":
Run Code Online (Sandbox Code Playgroud)
我使用 Sphinx autodoc 生成文档字符串。
.. autofunction:: set_parameters
Run Code Online (Sandbox Code Playgroud)
然后,Sphinx 将忽略换行符并在一行中描述该函数。
set_parameters(tokenizer: Union[None, Tokenizer, str] = None, vocab: Optional[Vocab] = None, vocab_from: Optional[Dict[str, str]] = None, max_sent_length: Optional[int] = None, max_turn_length: Optional[int] = None, convert_to_lower_letter: Optional[bool] = None, weak=False) -> FieldContext:
Run Code Online (Sandbox Code Playgroud)
它非常丑陋且难以阅读。我想要的是它要么跟随我的代码中的换行符,要么自动执行一些换行符。有什么办法可以实现吗?