/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

Viewing changes to repository.py

https://launchpad.net/bugs/605394
Add some basic documentation in 'bzr help git'.

Show diffs side-by-side

added added

removed removed

Lines of Context:
repository.py
1
1
# Copyright (C) 2007 Canonical Ltd
 
2
# Copyright (C) 2008-2009 Jelmer Vernooij <jelmer@samba.org>
2
3
#
3
4
# This program is free software; you can redistribute it and/or modify
4
5
# it under the terms of the GNU General Public License as published by
16
17
 
17
18
"""An adapter between a Git Repository and a Bazaar Branch"""
18
19
 
19
 
import os
20
 
import time
21
 
 
22
 
import bzrlib
23
20
from bzrlib import (
24
 
    deprecated_graph,
25
21
    errors,
26
 
    graph,
27
22
    inventory,
28
 
    osutils,
29
23
    repository,
30
24
    revision,
31
25
    revisiontree,
32
 
    urlutils,
33
 
    versionedfile,
34
26
    )
35
27
from bzrlib.foreign import (
36
 
        ForeignRepository,
37
 
        )
38
 
from bzrlib.trace import mutter
39
 
from bzrlib.transport import get_transport
40
 
 
41
 
from bzrlib.plugins.git.foreign import (
42
 
    versionedfiles,
43
 
    )
44
 
from bzrlib.plugins.git.mapping import default_mapping
45
 
 
46
 
from bzrlib.plugins.git import git
47
 
 
48
 
 
49
 
class GitTags(object):
50
 
 
51
 
    def __init__(self, tags):
52
 
        self._tags = tags
53
 
 
54
 
    def __iter__(self):
55
 
        return iter(self._tags)
 
28
    ForeignRepository,
 
29
    )
 
30
 
 
31
from bzrlib.plugins.git.commit import (
 
32
    GitCommitBuilder,
 
33
    )
 
34
from bzrlib.plugins.git.mapping import (
 
35
    default_mapping,
 
36
    foreign_git,
 
37
    mapping_registry,
 
38
    )
 
39
from bzrlib.plugins.git.tree import (
 
40
    GitRevisionTree,
 
41
    )
 
42
from bzrlib.plugins.git.versionedfiles import (
 
43
    GitRevisions,
 
44
    GitTexts,
 
45
    )
 
46
 
 
47
 
 
48
from dulwich.objects import (
 
49
    Commit,
 
50
    )
56
51
 
57
52
 
58
53
class GitRepository(ForeignRepository):
59
54
    """An adapter to git repositories for bzr."""
60
55
 
61
56
    _serializer = None
 
57
    _commit_builder_class = GitCommitBuilder
 
58
    vcs = foreign_git
62
59
 
63
60
    def __init__(self, gitdir, lockfiles):
64
 
        ForeignRepository.__init__(self, GitFormat(), gitdir, lockfiles)
65
 
        from bzrlib.plugins.git import fetch
66
 
        repository.InterRepository.register_optimiser(fetch.InterGitRepository)
 
61
        ForeignRepository.__init__(self, GitRepositoryFormat(), gitdir,
 
62
            lockfiles)
 
63
        from bzrlib.plugins.git import fetch, push
 
64
        for optimiser in [fetch.InterRemoteGitNonGitRepository,
 
65
                          fetch.InterLocalGitNonGitRepository,
 
66
                          fetch.InterGitGitRepository,
 
67
                          push.InterToLocalGitRepository,
 
68
                          push.InterToRemoteGitRepository]:
 
69
            repository.InterRepository.register_optimiser(optimiser)
67
70
 
68
71
    def is_shared(self):
69
 
        return True
 
72
        return False
70
73
 
71
74
    def supports_rich_root(self):
72
75
        return True
73
76
 
74
 
    def _warn_if_deprecated(self):
 
77
    def _warn_if_deprecated(self, branch=None):
75
78
        # This class isn't deprecated
76
79
        pass
77
80
 
81
84
    def make_working_trees(self):
82
85
        return True
83
86
 
 
87
    def revision_graph_can_have_wrong_parents(self):
 
88
        return False
 
89
 
 
90
    def dfetch(self, source, stop_revision):
 
91
        interrepo = repository.InterRepository.get(source, self)
 
92
        return interrepo.dfetch(stop_revision)
 
93
 
84
94
 
85
95
class LocalGitRepository(GitRepository):
 
96
    """Git repository on the file system."""
86
97
 
87
98
    def __init__(self, gitdir, lockfiles):
88
 
        # FIXME: This also caches negatives. Need to be more careful 
89
 
        # about this once we start writing to git
90
 
        self._parents_provider = graph.CachingParentsProvider(self)
91
99
        GitRepository.__init__(self, gitdir, lockfiles)
92
100
        self.base = gitdir.root_transport.base
93
101
        self._git = gitdir._git
94
 
        self.texts = None
95
 
        self.signatures = versionedfiles.VirtualSignatureTexts(self)
96
 
        self.revisions = versionedfiles.VirtualRevisionTexts(self)
97
 
        self.tags = GitTags(self._git.get_tags())
 
102
        self.signatures = None
 
103
        self.revisions = GitRevisions(self, self._git.object_store)
 
104
        self.inventories = None
 
105
        self.texts = GitTexts(self)
 
106
 
 
107
    def _iter_revision_ids(self):
 
108
        for sha in self._git.object_store:
 
109
            o = self._git.object_store[sha]
 
110
            if not isinstance(o, Commit):
 
111
                continue
 
112
            rev = self.get_mapping().import_commit(o,
 
113
                self.lookup_foreign_revision_id)
 
114
            yield o.id, rev.revision_id
98
115
 
99
116
    def all_revision_ids(self):
100
 
        ret = set([revision.NULL_REVISION])
101
 
        if self._git.heads() == []:
102
 
            return ret
103
 
        bzr_heads = [self.get_mapping().revision_id_foreign_to_bzr(h) for h in self._git.heads()]
104
 
        ret = set(bzr_heads)
105
 
        graph = self.get_graph()
106
 
        for rev, parents in graph.iter_ancestry(bzr_heads):
107
 
            ret.add(rev)
 
117
        ret = set([])
 
118
        for git_sha, revid in self._iter_revision_ids():
 
119
            ret.add(revid)
108
120
        return ret
109
121
 
110
 
    #def get_revision_delta(self, revision_id):
111
 
    #    parent_revid = self.get_revision(revision_id).parent_ids[0]
112
 
    #    diff = self._git.diff(ids.convert_revision_id_bzr_to_git(parent_revid),
113
 
    #                   ids.convert_revision_id_bzr_to_git(revision_id))
114
 
 
115
 
    def _make_parents_provider(self):
116
 
        """See Repository._make_parents_provider()."""
117
 
        return self._parents_provider
118
 
 
119
122
    def get_parent_map(self, revids):
120
123
        parent_map = {}
121
 
        mutter("get_parent_map(%r)", revids)
122
124
        for revision_id in revids:
123
125
            assert isinstance(revision_id, str)
124
126
            if revision_id == revision.NULL_REVISION:
125
127
                parent_map[revision_id] = ()
126
128
                continue
127
 
            hexsha = self.lookup_git_revid(revision_id, self.get_mapping())
128
 
            commit  = self._git.commit(hexsha)
129
 
            if commit is None:
 
129
            hexsha, mapping = self.lookup_bzr_revision_id(revision_id)
 
130
            try:
 
131
                commit = self._git[hexsha]
 
132
            except KeyError:
130
133
                continue
131
 
            else:
132
 
                parent_map[revision_id] = [self.get_mapping().revision_id_foreign_to_bzr(p) for p in commit.parents]
 
134
            parent_map[revision_id] = [self.lookup_foreign_revision_id(p, mapping) for p in commit.parents]
133
135
        return parent_map
134
136
 
135
137
    def get_ancestry(self, revision_id, topo_sorted=True):
136
138
        """See Repository.get_ancestry().
137
139
        """
138
140
        if revision_id is None:
139
 
            return self._all_revision_ids()
 
141
            return [None, revision.NULL_REVISION] + self._all_revision_ids()
140
142
        assert isinstance(revision_id, str)
141
143
        ancestry = []
142
144
        graph = self.get_graph()
143
145
        for rev, parents in graph.iter_ancestry([revision_id]):
144
 
            if rev == revision.NULL_REVISION:
145
 
                rev = None
146
146
            ancestry.append(rev)
147
147
        ancestry.reverse()
148
 
        return ancestry
 
148
        return [None] + ancestry
149
149
 
150
150
    def get_signature_text(self, revision_id):
151
151
        raise errors.NoSuchRevision(self, revision_id)
152
152
 
153
 
    def lookup_revision_id(self, revid):
 
153
    def pack(self, hint=None, clean_obsolete_packs=False):
 
154
        self._git.object_store.pack_loose_objects()
 
155
 
 
156
    def lookup_foreign_revision_id(self, foreign_revid, mapping=None):
154
157
        """Lookup a revision id.
155
 
        
156
 
        :param revid: Bazaar revision id.
157
 
        :return: Tuple with git revisionid and mapping.
 
158
 
158
159
        """
159
 
        # Yes, this doesn't really work, but good enough as a stub
160
 
        return osutils.sha(rev_id).hexdigest(), self.get_mapping()
 
160
        if mapping is None:
 
161
            mapping = self.get_mapping()
 
162
        from dulwich.protocol import (
 
163
            ZERO_SHA,
 
164
            )
 
165
        if foreign_revid == ZERO_SHA:
 
166
            return revision.NULL_REVISION
 
167
        commit = self._git[foreign_revid]
 
168
        rev = mapping.import_commit(commit, lambda x: None)
 
169
        return rev.revision_id
161
170
 
162
171
    def has_signature_for_revision_id(self, revision_id):
163
172
        return False
164
173
 
165
 
    def lookup_git_revid(self, bzr_revid, mapping):
 
174
    def lookup_bzr_revision_id(self, bzr_revid, mapping=None):
166
175
        try:
167
 
            return mapping.revision_id_bzr_to_foreign(bzr_revid)
 
176
            return mapping_registry.revision_id_bzr_to_foreign(bzr_revid)
168
177
        except errors.InvalidRevisionId:
169
 
            raise errors.NoSuchRevision(self, bzr_revid)
 
178
            if mapping is None:
 
179
                mapping = self.get_mapping()
 
180
            try:
 
181
                return self._git.refs[mapping.revid_as_refname(bzr_revid)], mapping
 
182
            except KeyError:
 
183
                # Update refs from Git commit objects
 
184
                # FIXME: Hitting this a lot will be very inefficient...
 
185
                for git_sha, revid in self._iter_revision_ids():
 
186
                    self._git.refs[mapping.revid_as_refname(revid)] = git_sha
 
187
                    if revid == bzr_revid:
 
188
                        return git_sha, mapping
 
189
                raise errors.NoSuchRevision(self, bzr_revid)
170
190
 
171
191
    def get_revision(self, revision_id):
172
 
        git_commit_id = self.lookup_git_revid(revision_id, self.get_mapping())
 
192
        git_commit_id, mapping = self.lookup_bzr_revision_id(revision_id)
173
193
        try:
174
 
            commit = self._git.commit(git_commit_id)
 
194
            commit = self._git[git_commit_id]
175
195
        except KeyError:
176
196
            raise errors.NoSuchRevision(self, revision_id)
177
197
        # print "fetched revision:", git_commit_id
178
 
        revision = self.get_mapping().import_commit(commit)
 
198
        revision = mapping.import_commit(commit,
 
199
            self.lookup_foreign_revision_id)
179
200
        assert revision is not None
180
201
        return revision
181
202
 
182
203
    def has_revision(self, revision_id):
183
204
        try:
184
 
            self.get_revision(revision_id)
 
205
            git_commit_id, mapping = self.lookup_bzr_revision_id(revision_id)
185
206
        except errors.NoSuchRevision:
186
207
            return False
187
 
        else:
188
 
            return True
 
208
        return (git_commit_id in self._git)
 
209
 
 
210
    def has_revisions(self, revision_ids):
 
211
        return set(filter(self.has_revision, revision_ids))
189
212
 
190
213
    def get_revisions(self, revids):
191
214
        return [self.get_revision(r) for r in revids]
196
219
 
197
220
    def revision_tree(self, revision_id):
198
221
        revision_id = revision.ensure_null(revision_id)
199
 
 
200
222
        if revision_id == revision.NULL_REVISION:
201
223
            inv = inventory.Inventory(root_id=None)
202
224
            inv.revision_id = revision_id
203
225
            return revisiontree.RevisionTree(self, inv, revision_id)
204
 
 
205
 
        return GitRevisionTree(self, self.get_mapping(), revision_id)
 
226
        return GitRevisionTree(self, revision_id)
206
227
 
207
228
    def get_inventory(self, revision_id):
208
229
        assert revision_id != None
211
232
    def set_make_working_trees(self, trees):
212
233
        pass
213
234
 
214
 
    def fetch_objects(self, determine_wants, graph_walker, progress=None):
 
235
    def fetch_objects(self, determine_wants, graph_walker, resolve_ext_ref,
 
236
        progress=None):
215
237
        return self._git.fetch_objects(determine_wants, graph_walker, progress)
216
238
 
217
 
 
218
 
class GitRevisionTree(revisiontree.RevisionTree):
219
 
 
220
 
    def __init__(self, repository, mapping, revision_id):
221
 
        self._repository = repository
222
 
        self.revision_id = revision_id
223
 
        assert isinstance(revision_id, str)
224
 
        self.mapping = mapping
225
 
        git_id = repository.lookup_git_revid(revision_id, self.mapping)
226
 
        try:
227
 
            commit = repository._git.commit(git_id)
228
 
        except KeyError, r:
229
 
            raise errors.NoSuchRevision(repository, revision_id)
230
 
        self.tree = commit.tree
231
 
        self._inventory = inventory.Inventory(revision_id=revision_id)
232
 
        self._inventory.root.revision = revision_id
233
 
        self._build_inventory(self.tree, self._inventory.root, "")
234
 
 
235
 
    def get_revision_id(self):
236
 
        return self.revision_id
237
 
 
238
 
    def get_file_text(self, file_id):
239
 
        entry = self._inventory[file_id]
240
 
        if entry.kind == 'directory': return ""
241
 
        return self._repository._git.get_blob(entry.text_id).data
242
 
 
243
 
    def _build_inventory(self, tree_id, ie, path):
244
 
        assert isinstance(path, str)
245
 
        tree = self._repository._git.tree(tree_id)
246
 
        for mode, name, hexsha in tree.entries():
247
 
            basename = name.decode("utf-8")
248
 
            if path == "":
249
 
                child_path = name
250
 
            else:
251
 
                child_path = urlutils.join(path, name)
252
 
            file_id = self.mapping.generate_file_id(child_path)
253
 
            entry_kind = (mode & 0700000) / 0100000
254
 
            if entry_kind == 0:
255
 
                child_ie = inventory.InventoryDirectory(file_id, basename, ie.file_id)
256
 
            elif entry_kind == 1:
257
 
                file_kind = (mode & 070000) / 010000
258
 
                b = self._repository._git.get_blob(hexsha)
259
 
                if file_kind == 0:
260
 
                    child_ie = inventory.InventoryFile(file_id, basename, ie.file_id)
261
 
                    child_ie.text_sha1 = osutils.sha_string(b.data)
262
 
                elif file_kind == 2:
263
 
                    child_ie = inventory.InventoryLink(file_id, basename, ie.file_id)
264
 
                    child_ie.text_sha1 = osutils.sha_string("")
265
 
                else:
266
 
                    raise AssertionError(
267
 
                        "Unknown file kind, perms=%o." % (mode,))
268
 
                child_ie.text_id = b.id
269
 
                child_ie.text_size = len(b.data)
270
 
            else:
271
 
                raise AssertionError(
272
 
                    "Unknown blob kind, perms=%r." % (mode,))
273
 
            fs_mode = mode & 0777
274
 
            child_ie.executable = bool(fs_mode & 0111)
275
 
            child_ie.revision = self.revision_id
276
 
            self._inventory.add(child_ie)
277
 
            if entry_kind == 0:
278
 
                self._build_inventory(hexsha, child_ie, child_path)
279
 
 
280
 
 
281
 
class GitFormat(object):
 
239
    def _get_versioned_file_checker(self, text_key_references=None,
 
240
                        ancestors=None):
 
241
        return GitVersionedFileChecker(self,
 
242
            text_key_references=text_key_references, ancestors=ancestors)
 
243
    
 
244
 
 
245
class GitVersionedFileChecker(repository._VersionedFileChecker):
 
246
 
 
247
    file_ids = []
 
248
 
 
249
    def _check_file_version_parents(self, texts, progress_bar):
 
250
        return {}, []
 
251
 
 
252
 
 
253
class GitRepositoryFormat(repository.RepositoryFormat):
 
254
    """Git repository format."""
282
255
 
283
256
    supports_tree_reference = False
284
257
    rich_root_data = True
287
260
        return "Git Repository"
288
261
 
289
262
    def initialize(self, url, shared=False, _internal=False):
290
 
        raise bzr_errors.UninitializableFormat(self)
 
263
        raise errors.UninitializableFormat(self)
291
264
 
292
265
    def check_conversion_target(self, target_repo_format):
293
266
        return target_repo_format.rich_root_data
 
267
 
 
268
    def get_foreign_tests_repository_factory(self):
 
269
        from bzrlib.plugins.git.tests.test_repository import (
 
270
            ForeignTestsRepositoryFactory,
 
271
            )
 
272
        return ForeignTestsRepositoryFactory()
 
273
 
 
274
    def network_name(self):
 
275
        return "git"