Stowage/cpython
2
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2026-01-04 14:32:21 +00:00
Code Issues Projects Releases Packages Wiki Activity

gh-104050: Argument Clinic: Annotate the Block class (#106519)

Browse source
This commit is contained in:
Alex Waygood 2023-07-11 22:21:14 +01:00 • committed by GitHub
parent 3590c45a3d
commit d0972c77aa
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 17 additions and 15 deletions
Download patch file Download diff file Expand all files Collapse all files

32
Tools/clinic/clinic.py
View file

@ -759,7 +759,7 @@ def parse_line(self, line: str) -> None:
def render(
self,
clinic: Clinic | None,
signatures: Iterable[Function]
signatures: Iterable[Module | Class | Function]
) -> str:
function = None
for o in signatures:
@ -1633,6 +1633,7 @@ def create_regex(
return re.compile(pattern)
@dc.dataclass(slots=True, repr=False)
class Block:
r"""
Represents a single block of text embedded in
@ -1679,18 +1680,16 @@ class Block:
"preindent" would be "____" and "indent" would be "__".
"""
def __init__(self, input, dsl_name=None, signatures=None, output=None, indent='', preindent=''):
assert isinstance(input, str)
self.input = input
self.dsl_name = dsl_name
self.signatures = signatures or []
self.output = output
self.indent = indent
self.preindent = preindent
input: str
dsl_name: str | None = None
signatures: list[Module | Class | Function] = dc.field(default_factory=list)
output: Any = None # TODO: Very dynamic; probably untypeable in its current form?
indent: str = ''
preindent: str = ''
def __repr__(self):
def __repr__(self) -> str:
dsl_name = self.dsl_name or "text"
def summarize(s):
def summarize(s: object) -> str:
s = repr(s)
if len(s) > 30:
return s[:26] + "..." + s[0]
@ -4619,10 +4618,13 @@ def state_modulename_name(self, line: str | None) -> None:
if not (existing_function.kind == self.kind and existing_function.coexist == self.coexist):
fail("'kind' of function and cloned function don't match! (@classmethod/@staticmethod/@coexist)")
self.function = existing_function.copy(name=function_name, full_name=full_name, module=module, cls=cls, c_basename=c_basename, docstring='')
self.block.signatures.append(self.function)
(cls or module).functions.append(self.function)
function = existing_function.copy(
name=function_name, full_name=full_name, module=module,
cls=cls, c_basename=c_basename, docstring=''
)
self.function = function
self.block.signatures.append(function)
(cls or module).functions.append(function)
self.next(self.state_function_docstring)
return