Function _ClassifyInclude

tools/cpplint.py:5755–5827

Figures out what kind of header 'include' is. Args: fileinfo: The current file cpplint is running over. A FileInfo instance. include: The path to a #included file. used_angle_brackets: True if the #include used <> rather than "". include_order: "default" or other value a

(fileinfo, include, used_angle_brackets, include_order="default")

def _ClassifyInclude(fileinfo, include, used_angle_brackets, include_order="default"):
    """Figures out what kind of header 'include' is.

    Args:
      fileinfo: The current file cpplint is running over. A FileInfo instance.
      include: The path to a #included file.
      used_angle_brackets: True if the #include used <> rather than "".
      include_order: "default" or other value allowed in program arguments

    Returns:
      One of the _XXX_HEADER constants.

    For example:
      >>> _ClassifyInclude(FileInfo('foo/foo.cc'), 'stdio.h', True)
      _C_SYS_HEADER
      >>> _ClassifyInclude(FileInfo('foo/foo.cc'), 'string', True)
      _CPP_SYS_HEADER
      >>> _ClassifyInclude(FileInfo('foo/foo.cc'), 'foo/foo.h', True, "standardcfirst")
      _OTHER_SYS_HEADER
      >>> _ClassifyInclude(FileInfo('foo/foo.cc'), 'foo/foo.h', False)
      _LIKELY_MY_HEADER
      >>> _ClassifyInclude(FileInfo('foo/foo_unknown_extension.cc'),
      ...                  'bar/foo_other_ext.h', False)
      _POSSIBLE_MY_HEADER
      >>> _ClassifyInclude(FileInfo('foo/foo.cc'), 'foo/bar.h', False)
      _OTHER_HEADER
    """
    # This is a list of all standard c++ header files, except
    # those already checked for above.
    is_cpp_header = include in _CPP_HEADERS

    # Mark include as C header if in list or in a known folder for standard-ish C headers.
    is_std_c_header = (include_order == "default") or (
        include in _C_HEADERS
        # additional linux glibc header folders
        or re.search(rf"(?:{'|'.join(C_STANDARD_HEADER_FOLDERS)})\/.*\.h", include)
    )

    # Headers with C++ extensions shouldn't be considered C system headers
    include_ext = os.path.splitext(include)[1]
    is_system = used_angle_brackets and include_ext not in [".hh", ".hpp", ".hxx", ".h++"]

    if is_system:
        if is_cpp_header:
            return _CPP_SYS_HEADER
        if is_std_c_header:
            return _C_SYS_HEADER
        return _OTHER_SYS_HEADER

    # If the target file and the include we're checking share a
    # basename when we drop common extensions, and the include
    # lives in . , then it's likely to be owned by the target file.
    target_dir, target_base = os.path.split(_DropCommonSuffixes(fileinfo.RepositoryName()))
    include_dir, include_base = os.path.split(_DropCommonSuffixes(include))
    target_dir_pub = os.path.normpath(target_dir + "/../public")
    target_dir_pub = target_dir_pub.replace("\\", "/")
    if target_base == include_base and (include_dir in (target_dir, target_dir_pub)):
        return _LIKELY_MY_HEADER