Function ParseNolintSuppressions

tools/cpplint.py:1134–1204

Updates the global list of line error-suppressions. Parses any NOLINT comments on the current line, updating the global error_suppressions store. Reports an error if the NOLINT comment was malformed. Args: filename: str, the name of the input file. raw_line: str, the l

(filename, raw_line, linenum, error)

def ParseNolintSuppressions(filename, raw_line, linenum, error):
    """Updates the global list of line error-suppressions.

    Parses any NOLINT comments on the current line, updating the global
    error_suppressions store.  Reports an error if the NOLINT comment
    was malformed.

    Args:
      filename: str, the name of the input file.
      raw_line: str, the line of input text, with comments.
      linenum: int, the number of the current line.
      error: function, an error handler.
    """
    if matched := re.search(r"\bNOLINT(NEXTLINE|BEGIN|END)?\b(\([^)]+\))?", raw_line):
        no_lint_type = matched.group(1)
        if no_lint_type == "NEXTLINE":

            def ProcessCategory(category):
                _error_suppressions.AddLineSuppression(category, linenum + 1)
        elif no_lint_type == "BEGIN":
            if _error_suppressions.HasOpenBlock():
                error(
                    filename,
                    linenum,
                    "readability/nolint",
                    5,
                    (
                        "NONLINT block already defined on line "
                        f"{_error_suppressions.GetOpenBlockStart()}"
                    ),
                )

            def ProcessCategory(category):
                _error_suppressions.StartBlockSuppression(category, linenum)
        elif no_lint_type == "END":
            if not _error_suppressions.HasOpenBlock():
                error(filename, linenum, "readability/nolint", 5, "Not in a NOLINT block")

            def ProcessCategory(category):
                if category is not None:
                    error(
                        filename,
                        linenum,
                        "readability/nolint",
                        5,
                        f"NOLINT categories not supported in block END: {category}",
                    )
                _error_suppressions.EndBlockSuppression(linenum)
        else:

            def ProcessCategory(category):
                _error_suppressions.AddLineSuppression(category, linenum)

        categories = matched.group(2)
        if categories in (None, "(*)"):  # => "suppress all"
            ProcessCategory(None)
        elif categories.startswith("(") and categories.endswith(")"):
            for category in {c.strip() for c in categories[1:-1].split(",")}: