comparison mercurial/localrepo.py @ 48684:568f63b5a30f

dirstate: introduce a "tracked-key" feature

A new format variant is introduced. When used, a `tracked-key` file will be
generated. That file will be update when the set of tracked file might have
changed. This will be useful for external automation (e.g. build tool) to be
notified when the set of relevant files changes.

One of the motivation for this changes is to mitigate effect dirstate-v2 has on
such automation. Since the dirstate file is updated much more frequently on
dirstate-v2, monitoring update to that file is no longer a viable strategy.

See the associated documentation for details about the feature

To prevent older client to update the repository without updating that file, a
new requirements is introduced.

The `postfinalizegenerators` business is a bit weird, so I'll likely clean that
up soon.

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

48683:111f5a0cbcaa

    _basesupported = {
        requirementsmod.BOOKMARKS_IN_STORE_REQUIREMENT,
        requirementsmod.CHANGELOGV2_REQUIREMENT,
        requirementsmod.COPIESSDC_REQUIREMENT,
        requirementsmod.DIRSTATE_V2_REQUIREMENT,
        requirementsmod.DOTENCODE_REQUIREMENT,
        requirementsmod.FNCACHE_REQUIREMENT,
        requirementsmod.GENERALDELTA_REQUIREMENT,
        requirementsmod.INTERNAL_PHASE_REQUIREMENT,

    def _makedirstate(self):
        """Extension point for wrapping the dirstate per-repo."""
        sparsematchfn = lambda: sparse.matcher(self)
        v2_req = requirementsmod.DIRSTATE_V2_REQUIREMENT
        use_dirstate_v2 = v2_req in self.requirements

        return dirstate.dirstate(
            self.vfs,
            self.ui,
            self.root,
            self._dirstatevalidate,
            sparsematchfn,
            self.nodeconstants,
            use_dirstate_v2,
        )

    def _dirstatevalidate(self, node):
        try:
            self.changelog.rev(node)

        if createopts.get(b'sharedrelative'):
            requirements.add(requirementsmod.RELATIVE_SHARED_REQUIREMENT)
        else:
            requirements.add(requirementsmod.SHARED_REQUIREMENT)

    return requirements


def checkrequirementscompat(ui, requirements):
    """Checks compatibility of repository requirements enabled and disabled.

48684:568f63b5a30f

    _basesupported = {
        requirementsmod.BOOKMARKS_IN_STORE_REQUIREMENT,
        requirementsmod.CHANGELOGV2_REQUIREMENT,
        requirementsmod.COPIESSDC_REQUIREMENT,
        requirementsmod.DIRSTATE_TRACKED_KEY_V1,
        requirementsmod.DIRSTATE_V2_REQUIREMENT,
        requirementsmod.DOTENCODE_REQUIREMENT,
        requirementsmod.FNCACHE_REQUIREMENT,
        requirementsmod.GENERALDELTA_REQUIREMENT,
        requirementsmod.INTERNAL_PHASE_REQUIREMENT,

    def _makedirstate(self):
        """Extension point for wrapping the dirstate per-repo."""
        sparsematchfn = lambda: sparse.matcher(self)
        v2_req = requirementsmod.DIRSTATE_V2_REQUIREMENT
        tk = requirementsmod.DIRSTATE_TRACKED_KEY_V1
        use_dirstate_v2 = v2_req in self.requirements
        use_tracked_key = tk in self.requirements

        return dirstate.dirstate(
            self.vfs,
            self.ui,
            self.root,
            self._dirstatevalidate,
            sparsematchfn,
            self.nodeconstants,
            use_dirstate_v2,
            use_tracked_key=use_tracked_key,
        )

    def _dirstatevalidate(self, node):
        try:
            self.changelog.rev(node)

        if createopts.get(b'sharedrelative'):
            requirements.add(requirementsmod.RELATIVE_SHARED_REQUIREMENT)
        else:
            requirements.add(requirementsmod.SHARED_REQUIREMENT)

    tracked_key = ui.configint(b'format', b'exp-dirstate-tracked-key-version')
    if tracked_key:
        if tracked_key != 1:
            msg = _("ignoring unknown tracked key version: %d\n")
            hint = _(
                "see `hg help config.format.exp-dirstate-tracked-key-version"
            )
            ui.warn(msg % tracked_key, hint=hint)
        else:
            requirements.add(requirementsmod.DIRSTATE_TRACKED_KEY_V1)

    return requirements


def checkrequirementscompat(ui, requirements):
    """Checks compatibility of repository requirements enabled and disabled.