/brz/remove-bazaar

# Copyright (C) 2008-2012 Canonical Ltd

#

# This program is free software; you can redistribute it and/or modify

# it under the terms of the GNU General Public License as published by

# the Free Software Foundation; either version 2 of the License, or

# (at your option) any later version.

#

# This program is distributed in the hope that it will be useful,

# but WITHOUT ANY WARRANTY; without even the implied warranty of

# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

# GNU General Public License for more details.

#

# You should have received a copy of the GNU General Public License

# along with this program; if not, write to the Free Software

# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA

"""Foreign branch utilities."""

from __future__ import absolute_import

from .branch import (

    Branch,

    )

from .repository import Repository

from .revision import Revision

from . import (

    errors,

    registry,

    )

class VcsMapping(object):

    """Describes the mapping between the semantics of Bazaar and a foreign VCS.

    """

    # Whether this is an experimental mapping that is still open to changes.

    experimental = False

    # Whether this mapping supports exporting and importing all bzr semantics.

    roundtripping = False

    # Prefix used when importing revisions native to the foreign VCS (as

    # opposed to roundtripping bzr-native revisions) using this mapping.

    revid_prefix = None

    def __init__(self, vcs):

        """Create a new VcsMapping.

        :param vcs: VCS that this mapping maps to Bazaar

        """

        self.vcs = vcs

    def revision_id_bzr_to_foreign(self, bzr_revid):

        """Parse a bzr revision id and convert it to a foreign revid.

        :param bzr_revid: The bzr revision id (a string).

        :return: A foreign revision id, can be any sort of object.

        """

        raise NotImplementedError(self.revision_id_bzr_to_foreign)

    def revision_id_foreign_to_bzr(self, foreign_revid):

        """Parse a foreign revision id and convert it to a bzr revid.

        :param foreign_revid: Foreign revision id, can be any sort of object.

        :return: A bzr revision id.

        """

        raise NotImplementedError(self.revision_id_foreign_to_bzr)

class VcsMappingRegistry(registry.Registry):

    """Registry for Bazaar<->foreign VCS mappings.

    There should be one instance of this registry for every foreign VCS.

    """

    def register(self, key, factory, help):

        """Register a mapping between Bazaar and foreign VCS semantics.

        The factory must be a callable that takes one parameter: the key.

        It must produce an instance of VcsMapping when called.

        """

        if b":" in key:

            raise ValueError("mapping name can not contain colon (:)")

        registry.Registry.register(self, key, factory, help)

    def set_default(self, key):

        """Set the 'default' key to be a clone of the supplied key.

        This method must be called once and only once.

        """

        self._set_default_key(key)

    def get_default(self):

        """Convenience function for obtaining the default mapping to use."""

        return self.get(self._get_default_key())

    def revision_id_bzr_to_foreign(self, revid):

        """Convert a bzr revision id to a foreign revid."""

        raise NotImplementedError(self.revision_id_bzr_to_foreign)

class ForeignRevision(Revision):

    """A Revision from a Foreign repository. Remembers

    information about foreign revision id and mapping.

    """

    def __init__(self, foreign_revid, mapping, *args, **kwargs):

        if "inventory_sha1" not in kwargs:

            kwargs["inventory_sha1"] = b""

        super(ForeignRevision, self).__init__(*args, **kwargs)

        self.foreign_revid = foreign_revid

        self.mapping = mapping

class ForeignVcs(object):

    """A foreign version control system."""

    branch_format = None

    repository_format = None

    def __init__(self, mapping_registry, abbreviation=None):

        """Create a new foreign vcs instance.

        :param mapping_registry: Registry with mappings for this VCS.

        :param abbreviation: Optional abbreviation ('bzr', 'svn', 'git', etc)

        """

        self.abbreviation = abbreviation

        self.mapping_registry = mapping_registry

    def show_foreign_revid(self, foreign_revid):

        """Prepare a foreign revision id for formatting using bzr log.

        :param foreign_revid: Foreign revision id.

        :return: Dictionary mapping string keys to string values.

        """

        return {}

    def serialize_foreign_revid(self, foreign_revid):

        """Serialize a foreign revision id for this VCS.

        :param foreign_revid: Foreign revision id

        :return: Bytestring with serialized revid, will not contain any

            newlines.

        """

        raise NotImplementedError(self.serialize_foreign_revid)

class ForeignVcsRegistry(registry.Registry):

    """Registry for Foreign VCSes.

    There should be one entry per foreign VCS. Example entries would be

    "git", "svn", "hg", "darcs", etc.

    """

    def register(self, key, foreign_vcs, help):

        """Register a foreign VCS.

        :param key: Prefix of the foreign VCS in revision ids

        :param foreign_vcs: ForeignVCS instance

        :param help: Description of the foreign VCS

        """

        if ":" in key or "-" in key:

            raise ValueError("vcs name can not contain : or -")

        registry.Registry.register(self, key, foreign_vcs, help)

    def parse_revision_id(self, revid):

        """Parse a bzr revision and return the matching mapping and foreign

        revid.

        :param revid: The bzr revision id

        :return: tuple with foreign revid and vcs mapping

        """

        if b":" not in revid or b"-" not in revid:

            raise errors.InvalidRevisionId(revid, None)

        try:

            foreign_vcs = self.get(revid.split(b"-")[0].decode('ascii'))

        except KeyError:

            raise errors.InvalidRevisionId(revid, None)

        return foreign_vcs.mapping_registry.revision_id_bzr_to_foreign(revid)

foreign_vcs_registry = ForeignVcsRegistry()

class ForeignRepository(Repository):

    """A Repository that exists in a foreign version control system.

    The data in this repository can not be represented natively using

    Bazaars internal datastructures, but have to converted using a VcsMapping.

    """

    # This repository's native version control system

    vcs = None

    def has_foreign_revision(self, foreign_revid):

        """Check whether the specified foreign revision is present.

        :param foreign_revid: A foreign revision id, in the format used

                              by this Repository's VCS.

        """

        raise NotImplementedError(self.has_foreign_revision)

    def lookup_bzr_revision_id(self, revid):

        """Lookup a mapped or roundtripped revision by revision id.

        :param revid: Bazaar revision id

        :return: Tuple with foreign revision id and mapping.

        """

        raise NotImplementedError(self.lookup_revision_id)

    def all_revision_ids(self, mapping=None):

        """See Repository.all_revision_ids()."""

        raise NotImplementedError(self.all_revision_ids)

    def get_default_mapping(self):

        """Get the default mapping for this repository."""

        raise NotImplementedError(self.get_default_mapping)

class ForeignBranch(Branch):

    """Branch that exists in a foreign version control system."""

    def __init__(self, mapping):

        self.mapping = mapping

        super(ForeignBranch, self).__init__()