📝 测试文档部署

This commit is contained in:
2024-08-28 21:27:52 +08:00
parent 0320f13ae9
commit de42d34e38
16 changed files with 493 additions and 426 deletions

View File

@@ -121,29 +121,29 @@ class Docstring(BaseModel):
"""
PREFIX = "" * indent
if is_classmethod:
PREFIX = " -"
ret = ""
ret += self.desc + "\n\n"
# print(self.reduction())
# print(self.desc, self.return_)
if self.args:
ret += PREFIX + f"{get_text(lang, 'docstring.args')}:\n\n"
for arg in self.args:
ret += PREFIX + f"{arg.name}: {arg.type} {arg.desc}\n\n"
ret += PREFIX + f"- {arg.name}: {arg.type} {arg.desc}\n\n"
if self.attrs:
ret += PREFIX + f"{get_text(lang, 'docstring.attrs')}:\n\n"
for attr in self.attrs:
ret += PREFIX + f"{attr.name}: {attr.type} {attr.desc}\n\n"
if self.return_:
ret += PREFIX + f"- {attr.name}: {attr.type} {attr.desc}\n\n"
if self.return_ is not None:
ret += PREFIX + f"{get_text(lang, 'docstring.return')}:\n\n"
ret += PREFIX + f"{self.return_.desc}\n\n"
ret += PREFIX + f"- {self.return_.desc}\n\n"
if self.raise_:
ret += PREFIX + f"{get_text(lang, 'docstring.raises')}:\n\n"
for exception in self.raise_:
ret += PREFIX + f"{exception.name} {exception.desc}\n\n"
ret += PREFIX + f"- {exception.name} {exception.desc}\n\n"
if self.example:
ret += PREFIX + f"{get_text(lang, 'docstring.example')}:\n\n"
for example in self.example:
ret += PREFIX + f"{example.desc}\n Input: {example.input}\n Output: {example.output}\n\n"
ret += PREFIX + f"- {example.desc}\n Input: {example.input}\n Output: {example.output}\n\n"
return ret
def __str__(self):

View File

@@ -115,17 +115,17 @@ class GoogleDocstringParser(Parser):
在一个子解析器中,解析下一行,直到缩进小于等于当前行的缩进
Returns:
"""
while self.lineno + 1 < len(self.lines):
while (self.lineno + 1) < len(self.lines):
line = self.lines[self.lineno + 1]
if line.startswith(" " * self.indent):
line = line[self.indent:]
self.lineno += 1
return line
else:
self.lineno += 1
return None
if not line:
return None
self.lineno += 1
return line
self.lineno += 1
return None
def parse(self) -> Docstring:
"""
@@ -146,7 +146,6 @@ class GoogleDocstringParser(Parser):
add_desc = False
match token:
case "args":
self.parse_args()
case "return":