Method get_resource

src/commoncode/resource.py:860–895

Return the Resource with `path` or None if it does not exists. The ``path`` must be relative to the root (and including the root name as its first segment).

(self, path)

    # FIXME: the PATH SHOULD NOT INCLUDE THE ROOT NAME
    def get_resource(self, path):
        """
        Return the Resource with `path` or None if it does not exists.
        The ``path`` must be relative to the root (and including the root
        name as its first segment).
        """
        assert isinstance(path, str), f"Invalid path: {path!r} is not a string."
        path = clean_path(path)
        if TRACE:
            msg = ["  Codebase.get_resource:", "path:", path]
            if not path or path not in self.resources_by_path:
                msg.append("not in resources!")
            else:
                msg.extend(["exists on disk:", self._exists_on_disk(path)])
                msg.extend(["exists in memo:", self._exists_in_memory(path)])
            logger_debug(*msg)

        # we use Codebase.CACHED_RESOURCE as a semaphore for existing but only
        # on-disk, non-in-memory resource that we need to load from the disk
        # cache to differentiate from None which means missing
        res = self.resources_by_path.get(path)
        if res is Codebase.CACHED_RESOURCE:
            res = self._load_resource(path)

        elif isinstance(res, Resource):
            res = attr.evolve(res)

        elif res is None:
            pass
        else:
            # this should never happen
            raise Exception(f"get_resource: Internal error when getting {path!r}")

        if TRACE:
            logger_debug("    Resource:", res)
        return res

    def save_resource(self, resource):
        """