gh-104050: Argument Clinic: Annotate CRenderData.__init__ (#107207)

Argument Clinic: Annotate `CRenderData.__init__`
This commit is contained in:
Alex Waygood 2023-07-24 22:38:50 +01:00 committed by GitHub
parent d93fe5afe2
commit 4bbf071635
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -372,36 +372,36 @@ def version_comparitor(version1: str, version2: str) -> Literal[-1, 0, 1]:
class CRenderData: class CRenderData:
def __init__(self): def __init__(self) -> None:
# The C statements to declare variables. # The C statements to declare variables.
# Should be full lines with \n eol characters. # Should be full lines with \n eol characters.
self.declarations = [] self.declarations: list[str] = []
# The C statements required to initialize the variables before the parse call. # The C statements required to initialize the variables before the parse call.
# Should be full lines with \n eol characters. # Should be full lines with \n eol characters.
self.initializers = [] self.initializers: list[str] = []
# The C statements needed to dynamically modify the values # The C statements needed to dynamically modify the values
# parsed by the parse call, before calling the impl. # parsed by the parse call, before calling the impl.
self.modifications = [] self.modifications: list[str] = []
# The entries for the "keywords" array for PyArg_ParseTuple. # The entries for the "keywords" array for PyArg_ParseTuple.
# Should be individual strings representing the names. # Should be individual strings representing the names.
self.keywords = [] self.keywords: list[str] = []
# The "format units" for PyArg_ParseTuple. # The "format units" for PyArg_ParseTuple.
# Should be individual strings that will get # Should be individual strings that will get
self.format_units = [] self.format_units: list[str] = []
# The varargs arguments for PyArg_ParseTuple. # The varargs arguments for PyArg_ParseTuple.
self.parse_arguments = [] self.parse_arguments: list[str] = []
# The parameter declarations for the impl function. # The parameter declarations for the impl function.
self.impl_parameters = [] self.impl_parameters: list[str] = []
# The arguments to the impl function at the time it's called. # The arguments to the impl function at the time it's called.
self.impl_arguments = [] self.impl_arguments: list[str] = []
# For return converters: the name of the variable that # For return converters: the name of the variable that
# should receive the value returned by the impl. # should receive the value returned by the impl.
@ -411,17 +411,17 @@ class CRenderData:
# value from the parse function. This is also where # value from the parse function. This is also where
# you should check the _return_value for errors, and # you should check the _return_value for errors, and
# "goto exit" if there are any. # "goto exit" if there are any.
self.return_conversion = [] self.return_conversion: list[str] = []
self.converter_retval = "_return_value" self.converter_retval = "_return_value"
# The C statements required to do some operations # The C statements required to do some operations
# after the end of parsing but before cleaning up. # after the end of parsing but before cleaning up.
# These operations may be, for example, memory deallocations which # These operations may be, for example, memory deallocations which
# can only be done without any error happening during argument parsing. # can only be done without any error happening during argument parsing.
self.post_parsing = [] self.post_parsing: list[str] = []
# The C statements required to clean up after the impl call. # The C statements required to clean up after the impl call.
self.cleanup = [] self.cleanup: list[str] = []
class FormatCounterFormatter(string.Formatter): class FormatCounterFormatter(string.Formatter):