~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/smart/branch.py

  • Committer: Robert Collins
  • Date: 2007-05-07 16:48:14 UTC
  • mto: This revision was merged to the branch mainline in revision 2485.
  • Revision ID: robertc@robertcollins.net-20070507164814-wpagonutf4b5cf8s
Move HACKING to docs/developers/HACKING and adjust Makefile to accomodate this.

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
    def do(self, path, *args):
 
33
        """Execute a request for a branch at path.
 
34
 
 
35
        If the branch is a branch reference, NotBranchError is raised.
 
36
        """
 
37
        transport = self._backing_transport.clone(path)
 
38
        bzrdir = BzrDir.open_from_transport(transport)
 
39
        if bzrdir.get_branch_reference() is not None:
 
40
            raise errors.NotBranchError(transport.base)
 
41
        branch = bzrdir.open_branch()
 
42
        return self.do_with_branch(branch, *args)
 
43
 
 
44
 
 
45
class SmartServerLockedBranchRequest(SmartServerBranchRequest):
 
46
    """Base class for handling common branch request logic for requests that
 
47
    need a write lock.
 
48
    """
 
49
 
 
50
    def do_with_branch(self, branch, branch_token, repo_token, *args):
 
51
        """Execute a request for a branch.
 
52
 
 
53
        A write lock will be acquired with the given tokens for the branch and
 
54
        repository locks.  The lock will be released once the request is
 
55
        processed.  The physical lock state won't be changed.
 
56
        """
 
57
        # XXX: write a test for LockContention
 
58
        branch.repository.lock_write(token=repo_token)
 
59
        try:
 
60
            branch.lock_write(token=branch_token)
 
61
            try:
 
62
                return self.do_with_locked_branch(branch, *args)
 
63
            finally:
 
64
                branch.unlock()
 
65
        finally:
 
66
            branch.repository.unlock()
 
67
 
 
68
 
 
69
class SmartServerBranchGetConfigFile(SmartServerBranchRequest):
 
70
    
 
71
    def do_with_branch(self, branch):
 
72
        """Return the content of branch.control_files.get('branch.conf').
 
73
        
 
74
        The body is not utf8 decoded - its the literal bytestream from disk.
 
75
        """
 
76
        try:
 
77
            content = branch.control_files.get('branch.conf').read()
 
78
        except errors.NoSuchFile:
 
79
            content = ''
 
80
        return SuccessfulSmartServerResponse( ('ok', ), content)
 
81
 
 
82
 
 
83
class SmartServerRequestRevisionHistory(SmartServerBranchRequest):
 
84
 
 
85
    def do_with_branch(self, branch):
 
86
        """Get the revision history for the branch.
 
87
 
 
88
        The revision list is returned as the body content,
 
89
        with each revision utf8 encoded and \x00 joined.
 
90
        """
 
91
        return SuccessfulSmartServerResponse(
 
92
            ('ok', ), ('\x00'.join(branch.revision_history())))
 
93
 
 
94
 
 
95
class SmartServerBranchRequestLastRevisionInfo(SmartServerBranchRequest):
 
96
    
 
97
    def do_with_branch(self, branch):
 
98
        """Return branch.last_revision_info().
 
99
        
 
100
        The revno is encoded in decimal, the revision_id is encoded as utf8.
 
101
        """
 
102
        revno, last_revision = branch.last_revision_info()
 
103
        return SuccessfulSmartServerResponse(('ok', str(revno), last_revision))
 
104
 
 
105
 
 
106
class SmartServerBranchRequestSetLastRevision(SmartServerLockedBranchRequest):
 
107
    
 
108
    def do_with_locked_branch(self, branch, new_last_revision_id):
 
109
        if new_last_revision_id == 'null:':
 
110
            branch.set_revision_history([])
 
111
        else:
 
112
            if not branch.repository.has_revision(new_last_revision_id):
 
113
                return FailedSmartServerResponse(
 
114
                    ('NoSuchRevision', new_last_revision_id))
 
115
            branch.generate_revision_history(new_last_revision_id)
 
116
        return SuccessfulSmartServerResponse(('ok',))
 
117
 
 
118
 
 
119
class SmartServerBranchRequestLockWrite(SmartServerBranchRequest):
 
120
    
 
121
    def do_with_branch(self, branch, branch_token='', repo_token=''):
 
122
        if branch_token == '':
 
123
            branch_token = None
 
124
        if repo_token == '':
 
125
            repo_token = None
 
126
        try:
 
127
            repo_token = branch.repository.lock_write(token=repo_token)
 
128
            try:
 
129
                branch_token = branch.lock_write(token=branch_token)
 
130
            finally:
 
131
                branch.repository.unlock()
 
132
        except errors.LockContention:
 
133
            return FailedSmartServerResponse(('LockContention',))
 
134
        except errors.TokenMismatch:
 
135
            return FailedSmartServerResponse(('TokenMismatch',))
 
136
        except errors.UnlockableTransport:
 
137
            return FailedSmartServerResponse(('UnlockableTransport',))
 
138
        branch.repository.leave_lock_in_place()
 
139
        branch.leave_lock_in_place()
 
140
        branch.unlock()
 
141
        return SuccessfulSmartServerResponse(('ok', branch_token, repo_token))
 
142
 
 
143
 
 
144
class SmartServerBranchRequestUnlock(SmartServerBranchRequest):
 
145
 
 
146
    def do_with_branch(self, branch, branch_token, repo_token):
 
147
        try:
 
148
            branch.repository.lock_write(token=repo_token)
 
149
            try:
 
150
                branch.lock_write(token=branch_token)
 
151
            finally:
 
152
                branch.repository.unlock()
 
153
        except errors.TokenMismatch:
 
154
            return FailedSmartServerResponse(('TokenMismatch',))
 
155
        branch.repository.dont_leave_lock_in_place()
 
156
        branch.dont_leave_lock_in_place()
 
157
        branch.unlock()
 
158
        return SuccessfulSmartServerResponse(('ok',))
 
159