Method in_project_scope

pydevd.py:1255–1316

Note: in general this method should not be used (apply_files_filter should be used in most cases as it also handles the project scope check). :param frame: The frame we want to check. :param absolute_filename: Must be the result from get_abs

(self, frame, absolute_filename=None)

        return self.plugin

    def in_project_scope(self, frame, absolute_filename=None):
        """
        Note: in general this method should not be used (apply_files_filter should be used
        in most cases as it also handles the project scope check).

        :param frame:
            The frame we want to check.

        :param absolute_filename:
            Must be the result from get_abs_path_real_path_and_base_from_frame(frame)[0] (can
            be used to speed this function a bit if it's already available to the caller, but
            in general it's not needed).
        """
        try:
            if absolute_filename is None:
                try:
                    # Make fast path faster!
                    abs_real_path_and_basename = NORM_PATHS_AND_BASE_CONTAINER[frame.f_code.co_filename]
                except:
                    abs_real_path_and_basename = get_abs_path_real_path_and_base_from_frame(frame)

                absolute_filename = abs_real_path_and_basename[0]

            cache_key = (frame.f_code.co_firstlineno, absolute_filename, frame.f_code)

            return self._in_project_scope_cache[cache_key]
        except KeyError:
            cache = self._in_project_scope_cache
            try:
                abs_real_path_and_basename  # If we've gotten it previously, use it again.
            except NameError:
                abs_real_path_and_basename = get_abs_path_real_path_and_base_from_frame(frame)

            # pydevd files are never considered to be in the project scope.
            file_type = self.get_file_type(frame, abs_real_path_and_basename)
            if file_type == self.PYDEV_FILE:
                cache[cache_key] = False

            elif IS_PY314_OR_GREATER and frame.f_code.co_name == "__annotate__":
                # Special handling for __annotate__ functions (PEP 649 in Python 3.14+).
                # These are compiler-generated functions that can raise NotImplementedError
                # when called with unsupported format arguments by inspect.call_annotate_function.
                # They should be treated as library code to avoid false positives in exception handling.
                # Note: PEP 649 reserves the __annotate__ name for compiler-generated functions,
                # so user-defined functions with this name are discouraged and will also be treated
                # as library code to maintain consistency with the language design.
                cache[cache_key] = False

            elif absolute_filename == "<string>":
                # Special handling for '<string>'
                if file_type == self.LIB_FILE:
                    cache[cache_key] = False
                else:
                    cache[cache_key] = True

            elif self.source_mapping.has_mapping_entry(absolute_filename):
                cache[cache_key] = True