comparison mercurial/revlog.py @ 42981:35ab2c1a58aa

revlog: return sidedata map from `_revisiondata`

Nothing extra any side data yet. However, it will happens in the future. So we
better prepare the callers of the `_revisiondata` to deal with it.

Differential Revision: https://phab.mercurial-scm.org/D6809

42980:0d1272783f24

        """
        if raw:
            msg = ('revlog.revision(..., raw=True) is deprecated, '
                   'use revlog.rawdata(...)')
            util.nouideprecwarn(msg, '5.2', stacklevel=2)
        return self._revisiondata(nodeorrev, _df, raw=raw)

    def sidedata(self, nodeorrev, _df=None):
        """a map of extra data related to the changeset but not part of the hash

        This function currently return a dictionary. However, more advanced

            node = nodeorrev
            rev = None

        # fast path the special `nullid` rev
        if node == nullid:
            return ""

        # The text as stored inside the revlog. Might be the revision or might
        # need to be processed to retrieve the revision.
        rawtext = None

        rev, rawtext, validated = self._rawtext(node, rev, _df=_df)

        if raw and validated:
            # if we don't want to process the raw text and that raw
            # text is cached, we can exit early.
            return rawtext
        if rev is None:
            rev = self.rev(node)
        # the revlog's flag for this revision
        # (usually alter its state or content)
        flags = self.flags(rev)

        if validated and flags == REVIDX_DEFAULT_FLAGS:
            # no extra flags set, no flag processor runs, text = rawtext
            return rawtext

        if raw:
            validatehash = self._processflagsraw(rawtext, flags)
            text = rawtext
        else:
            text, validatehash = self._processflagsread(rawtext, flags)
        if validatehash:
            self.checkhash(text, node, rev=rev)
        if not validated:
            self._revisioncache = (node, rev, rawtext)

        return text

    def _rawtext(self, node, rev, _df=None):
        """return the possibly unvalidated rawtext for a revision

        returns (rev, rawtext, validated)

    def rawdata(self, nodeorrev, _df=None):
        """return an uncompressed raw data of a given node or revision number.

        _df - an existing file handle to read from. (internal-only)
        """
        return self._revisiondata(nodeorrev, _df, raw=True)

    def hash(self, text, p1, p2):
        """Compute a node hash.

        Available as a function so that subclasses can replace the hash

42981:35ab2c1a58aa

        """
        if raw:
            msg = ('revlog.revision(..., raw=True) is deprecated, '
                   'use revlog.rawdata(...)')
            util.nouideprecwarn(msg, '5.2', stacklevel=2)
        return self._revisiondata(nodeorrev, _df, raw=raw)[0]

    def sidedata(self, nodeorrev, _df=None):
        """a map of extra data related to the changeset but not part of the hash

        This function currently return a dictionary. However, more advanced

            node = nodeorrev
            rev = None

        # fast path the special `nullid` rev
        if node == nullid:
            return "", {}

        # The text as stored inside the revlog. Might be the revision or might
        # need to be processed to retrieve the revision.
        rawtext = None

        rev, rawtext, validated = self._rawtext(node, rev, _df=_df)

        if raw and validated:
            # if we don't want to process the raw text and that raw
            # text is cached, we can exit early.
            return rawtext, {}
        if rev is None:
            rev = self.rev(node)
        # the revlog's flag for this revision
        # (usually alter its state or content)
        flags = self.flags(rev)

        if validated and flags == REVIDX_DEFAULT_FLAGS:
            # no extra flags set, no flag processor runs, text = rawtext
            return rawtext, {}

        sidedata = {}
        if raw:
            validatehash = self._processflagsraw(rawtext, flags)
            text = rawtext
        else:
            text, validatehash = self._processflagsread(rawtext, flags)
        if validatehash:
            self.checkhash(text, node, rev=rev)
        if not validated:
            self._revisioncache = (node, rev, rawtext)

        return text, sidedata

    def _rawtext(self, node, rev, _df=None):
        """return the possibly unvalidated rawtext for a revision

        returns (rev, rawtext, validated)

    def rawdata(self, nodeorrev, _df=None):
        """return an uncompressed raw data of a given node or revision number.

        _df - an existing file handle to read from. (internal-only)
        """
        return self._revisiondata(nodeorrev, _df, raw=True)[0]

    def hash(self, text, p1, p2):
        """Compute a node hash.

        Available as a function so that subclasses can replace the hash