Class NestingState

tools/cpplint.py:3275–3717

Holds states related to parsing braces.

class NestingState:
    """Holds states related to parsing braces."""

    def __init__(self):
        # Stack for tracking all braces.  An object is pushed whenever we
        # see a "{", and popped when we see a "}".  Only 3 types of
        # objects are possible:
        # - _ClassInfo: a class or struct.
        # - _NamespaceInfo: a namespace.
        # - _BlockInfo: some other type of block.
        self.stack: list[_BlockInfo] = []

        # Top of the previous stack before each Update().
        #
        # Because the nesting_stack is updated at the end of each line, we
        # had to do some convoluted checks to find out what is the current
        # scope at the beginning of the line.  This check is simplified by
        # saving the previous top of nesting stack.
        #
        # We could save the full stack, but we only need the top.  Copying
        # the full nesting stack would slow down cpplint by ~10%.
        self.previous_stack_top: _BlockInfo | None = None

        # The number of open parentheses in the previous stack top before the last update.
        # Used to prevent false indentation detection when e.g. a function parameter is indented.
        # We can't use previous_stack_top, a shallow copy whose open_parentheses value is updated.
        self.previous_open_parentheses = 0

        # The last stack item we popped.
        self.popped_top: _BlockInfo | None = None

        # Stack of _PreprocessorInfo objects.
        self.pp_stack = []

    def SeenOpenBrace(self):
        """Check if we have seen the opening brace for the innermost block.

        Returns:
          True if we have seen the opening brace, False if the innermost
          block is still expecting an opening brace.
        """
        return (not self.stack) or self.stack[-1].seen_open_brace

    def InNamespaceBody(self):
        """Check if we are currently one level inside a namespace body.

        Returns:
          True if top of the stack is a namespace block, False otherwise.
        """
        return self.stack and isinstance(self.stack[-1], _NamespaceInfo)

    def InExternC(self):
        """Check if we are currently one level inside an 'extern "C"' block.

        Returns:
          True if top of the stack is an extern block, False otherwise.
        """
        return self.stack and isinstance(self.stack[-1], _ExternCInfo)