~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/smart/branch.py

  • Committer: Canonical.com Patch Queue Manager
  • Date: 2008-10-31 04:39:04 UTC
  • mfrom: (3565.6.16 switch_nick)
  • Revision ID: pqm@pqm.ubuntu.com-20081031043904-52fnbfrloojemvcc
(mbp) branch nickname documentation

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
# Copyright (C) 2006 Canonical Ltd
 
2
#
 
3
# This program is free software; you can redistribute it and/or modify
 
4
# it under the terms of the GNU General Public License as published by
 
5
# the Free Software Foundation; either version 2 of the License, or
 
6
# (at your option) any later version.
 
7
#
 
8
# This program is distributed in the hope that it will be useful,
 
9
# but WITHOUT ANY WARRANTY; without even the implied warranty of
 
10
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 
11
# GNU General Public License for more details.
 
12
#
 
13
# You should have received a copy of the GNU General Public License
 
14
# along with this program; if not, write to the Free Software
 
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 
16
 
 
17
"""Server-side branch related request implmentations."""
 
18
 
 
19
 
 
20
from bzrlib import errors
 
21
from bzrlib.bzrdir import BzrDir
 
22
from bzrlib.smart.request import (
 
23
    FailedSmartServerResponse,
 
24
    SmartServerRequest,
 
25
    SuccessfulSmartServerResponse,
 
26
    )
 
27
 
 
28
 
 
29
class SmartServerBranchRequest(SmartServerRequest):
 
30
    """Base class for handling common branch request logic.
 
31
    """
 
32
 
 
33
    def do(self, path, *args):
 
34
        """Execute a request for a branch at path.
 
35
    
 
36
        All Branch requests take a path to the branch as their first argument.
 
37
 
 
38
        If the branch is a branch reference, NotBranchError is raised.
 
39
 
 
40
        :param path: The path for the repository as received from the
 
41
            client.
 
42
        :return: A SmartServerResponse from self.do_with_branch().
 
43
        """
 
44
        transport = self.transport_from_client_path(path)
 
45
        bzrdir = BzrDir.open_from_transport(transport)
 
46
        if bzrdir.get_branch_reference() is not None:
 
47
            raise errors.NotBranchError(transport.base)
 
48
        branch = bzrdir.open_branch()
 
49
        return self.do_with_branch(branch, *args)
 
50
 
 
51
 
 
52
class SmartServerLockedBranchRequest(SmartServerBranchRequest):
 
53
    """Base class for handling common branch request logic for requests that
 
54
    need a write lock.
 
55
    """
 
56
 
 
57
    def do_with_branch(self, branch, branch_token, repo_token, *args):
 
58
        """Execute a request for a branch.
 
59
 
 
60
        A write lock will be acquired with the given tokens for the branch and
 
61
        repository locks.  The lock will be released once the request is
 
62
        processed.  The physical lock state won't be changed.
 
63
        """
 
64
        # XXX: write a test for LockContention
 
65
        branch.repository.lock_write(token=repo_token)
 
66
        try:
 
67
            branch.lock_write(token=branch_token)
 
68
            try:
 
69
                return self.do_with_locked_branch(branch, *args)
 
70
            finally:
 
71
                branch.unlock()
 
72
        finally:
 
73
            branch.repository.unlock()
 
74
 
 
75
 
 
76
class SmartServerBranchGetConfigFile(SmartServerBranchRequest):
 
77
    
 
78
    def do_with_branch(self, branch):
 
79
        """Return the content of branch.conf
 
80
        
 
81
        The body is not utf8 decoded - its the literal bytestream from disk.
 
82
        """
 
83
        # This was at one time called by RemoteBranchLockableFiles
 
84
        # intercepting access to this file; as of 1.5 it is not called by the
 
85
        # client but retained for compatibility.  It may be called again to
 
86
        # allow the client to get the configuration without needing vfs
 
87
        # access.
 
88
        try:
 
89
            content = branch._transport.get_bytes('branch.conf')
 
90
        except errors.NoSuchFile:
 
91
            content = ''
 
92
        return SuccessfulSmartServerResponse( ('ok', ), content)
 
93
 
 
94
 
 
95
class SmartServerBranchRequestGetStackedOnURL(SmartServerBranchRequest):
 
96
 
 
97
    def do_with_branch(self, branch):
 
98
        stacked_on_url = branch.get_stacked_on_url()
 
99
        return SuccessfulSmartServerResponse(('ok', stacked_on_url))
 
100
 
 
101
 
 
102
class SmartServerRequestRevisionHistory(SmartServerBranchRequest):
 
103
 
 
104
    def do_with_branch(self, branch):
 
105
        """Get the revision history for the branch.
 
106
 
 
107
        The revision list is returned as the body content,
 
108
        with each revision utf8 encoded and \x00 joined.
 
109
        """
 
110
        return SuccessfulSmartServerResponse(
 
111
            ('ok', ), ('\x00'.join(branch.revision_history())))
 
112
 
 
113
 
 
114
class SmartServerBranchRequestLastRevisionInfo(SmartServerBranchRequest):
 
115
    
 
116
    def do_with_branch(self, branch):
 
117
        """Return branch.last_revision_info().
 
118
        
 
119
        The revno is encoded in decimal, the revision_id is encoded as utf8.
 
120
        """
 
121
        revno, last_revision = branch.last_revision_info()
 
122
        return SuccessfulSmartServerResponse(('ok', str(revno), last_revision))
 
123
 
 
124
 
 
125
class SmartServerSetTipRequest(SmartServerLockedBranchRequest):
 
126
    """Base class for handling common branch request logic for requests that
 
127
    update the branch tip.
 
128
    """
 
129
 
 
130
    def do_with_locked_branch(self, branch, *args):
 
131
        try:
 
132
            return self.do_tip_change_with_locked_branch(branch, *args)
 
133
        except errors.TipChangeRejected, e:
 
134
            msg = e.msg
 
135
            if isinstance(msg, unicode):
 
136
                msg = msg.encode('utf-8')
 
137
            return FailedSmartServerResponse(('TipChangeRejected', msg))
 
138
 
 
139
 
 
140
class SmartServerBranchRequestSetLastRevision(SmartServerSetTipRequest):
 
141
    
 
142
    def do_tip_change_with_locked_branch(self, branch, new_last_revision_id):
 
143
        if new_last_revision_id == 'null:':
 
144
            branch.set_revision_history([])
 
145
        else:
 
146
            if not branch.repository.has_revision(new_last_revision_id):
 
147
                return FailedSmartServerResponse(
 
148
                    ('NoSuchRevision', new_last_revision_id))
 
149
            branch.generate_revision_history(new_last_revision_id)
 
150
        return SuccessfulSmartServerResponse(('ok',))
 
151
 
 
152
 
 
153
class SmartServerBranchRequestSetLastRevisionEx(SmartServerSetTipRequest):
 
154
    
 
155
    def do_tip_change_with_locked_branch(self, branch, new_last_revision_id,
 
156
            allow_divergence, allow_overwrite_descendant):
 
157
        """Set the last revision of the branch.
 
158
 
 
159
        New in 1.6.
 
160
        
 
161
        :param new_last_revision_id: the revision ID to set as the last
 
162
            revision of the branch.
 
163
        :param allow_divergence: A flag.  If non-zero, change the revision ID
 
164
            even if the new_last_revision_id's ancestry has diverged from the
 
165
            current last revision.  If zero, a 'Diverged' error will be
 
166
            returned if new_last_revision_id is not a descendant of the current
 
167
            last revision.
 
168
        :param allow_overwrite_descendant:  A flag.  If zero and
 
169
            new_last_revision_id is not a descendant of the current last
 
170
            revision, then the last revision will not be changed.  If non-zero
 
171
            and there is no divergence, then the last revision is always
 
172
            changed.
 
173
 
 
174
        :returns: on success, a tuple of ('ok', revno, revision_id), where
 
175
            revno and revision_id are the new values of the current last
 
176
            revision info.  The revision_id might be different to the
 
177
            new_last_revision_id if allow_overwrite_descendant was not set.
 
178
        """
 
179
        do_not_overwrite_descendant = not allow_overwrite_descendant
 
180
        try:
 
181
            last_revno, last_rev = branch.last_revision_info()
 
182
            graph = branch.repository.get_graph()
 
183
            if not allow_divergence or do_not_overwrite_descendant:
 
184
                relation = branch._revision_relations(
 
185
                    last_rev, new_last_revision_id, graph)
 
186
                if relation == 'diverged' and not allow_divergence:
 
187
                    return FailedSmartServerResponse(('Diverged',))
 
188
                if relation == 'a_descends_from_b' and do_not_overwrite_descendant:
 
189
                    return SuccessfulSmartServerResponse(
 
190
                        ('ok', last_revno, last_rev))
 
191
            new_revno = graph.find_distance_to_null(
 
192
                new_last_revision_id, [(last_rev, last_revno)])
 
193
            branch.set_last_revision_info(new_revno, new_last_revision_id)
 
194
        except errors.GhostRevisionsHaveNoRevno:
 
195
            return FailedSmartServerResponse(
 
196
                ('NoSuchRevision', new_last_revision_id))
 
197
        return SuccessfulSmartServerResponse(
 
198
            ('ok', new_revno, new_last_revision_id))
 
199
 
 
200
 
 
201
class SmartServerBranchRequestSetLastRevisionInfo(SmartServerSetTipRequest):
 
202
    """Branch.set_last_revision_info.  Sets the revno and the revision ID of
 
203
    the specified branch.
 
204
 
 
205
    New in bzrlib 1.4.
 
206
    """
 
207
    
 
208
    def do_tip_change_with_locked_branch(self, branch, new_revno,
 
209
            new_last_revision_id):
 
210
        try:
 
211
            branch.set_last_revision_info(int(new_revno), new_last_revision_id)
 
212
        except errors.NoSuchRevision:
 
213
            return FailedSmartServerResponse(
 
214
                ('NoSuchRevision', new_last_revision_id))
 
215
        return SuccessfulSmartServerResponse(('ok',))
 
216
 
 
217
 
 
218
class SmartServerBranchRequestLockWrite(SmartServerBranchRequest):
 
219
    
 
220
    def do_with_branch(self, branch, branch_token='', repo_token=''):
 
221
        if branch_token == '':
 
222
            branch_token = None
 
223
        if repo_token == '':
 
224
            repo_token = None
 
225
        try:
 
226
            repo_token = branch.repository.lock_write(token=repo_token)
 
227
            try:
 
228
                branch_token = branch.lock_write(token=branch_token)
 
229
            finally:
 
230
                # this leaves the repository with 1 lock
 
231
                branch.repository.unlock()
 
232
        except errors.LockContention:
 
233
            return FailedSmartServerResponse(('LockContention',))
 
234
        except errors.TokenMismatch:
 
235
            return FailedSmartServerResponse(('TokenMismatch',))
 
236
        except errors.UnlockableTransport:
 
237
            return FailedSmartServerResponse(('UnlockableTransport',))
 
238
        except errors.LockFailed, e:
 
239
            return FailedSmartServerResponse(('LockFailed', str(e.lock), str(e.why)))
 
240
        if repo_token is None:
 
241
            repo_token = ''
 
242
        else:
 
243
            branch.repository.leave_lock_in_place()
 
244
        branch.leave_lock_in_place()
 
245
        branch.unlock()
 
246
        return SuccessfulSmartServerResponse(('ok', branch_token, repo_token))
 
247
 
 
248
 
 
249
class SmartServerBranchRequestUnlock(SmartServerBranchRequest):
 
250
 
 
251
    def do_with_branch(self, branch, branch_token, repo_token):
 
252
        try:
 
253
            branch.repository.lock_write(token=repo_token)
 
254
            try:
 
255
                branch.lock_write(token=branch_token)
 
256
            finally:
 
257
                branch.repository.unlock()
 
258
        except errors.TokenMismatch:
 
259
            return FailedSmartServerResponse(('TokenMismatch',))
 
260
        if repo_token:
 
261
            branch.repository.dont_leave_lock_in_place()
 
262
        branch.dont_leave_lock_in_place()
 
263
        branch.unlock()
 
264
        return SuccessfulSmartServerResponse(('ok',))
 
265