1
# Copyright (C) 2006, 2007 Canonical Ltd
 
 
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.
 
 
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.
 
 
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
 
 
17
"""VFS operations for the smart server.
 
 
19
This module defines the smart server methods that are low-level file operations
 
 
20
-- i.e. methods that operate directly on files and directories, rather than
 
 
21
higher-level concepts like branches and revisions.
 
 
23
These methods, plus 'hello' and 'get_bundle', are version 1 of the smart server
 
 
24
protocol, as implemented in bzr 0.11 and later.
 
 
29
from bzrlib import errors
 
 
30
from bzrlib.smart import request
 
 
33
def _deserialise_optional_mode(mode):
 
 
34
    # XXX: FIXME this should be on the protocol object.  Later protocol versions
 
 
35
    # might serialise modes differently.
 
 
43
    """Is the VFS enabled ?
 
 
45
    the VFS is disabled when the BZR_NO_SMART_VFS environment variable is set.
 
 
47
    :return: True if it is enabled.
 
 
49
    return not 'BZR_NO_SMART_VFS' in os.environ
 
 
52
class VfsRequest(request.SmartServerRequest):
 
 
53
    """Base class for VFS requests.
 
 
55
    VFS requests are disabled if vfs_enabled() returns False.
 
 
58
    def _check_enabled(self):
 
 
60
            raise errors.DisabledMethod(self.__class__.__name__)
 
 
63
class HasRequest(VfsRequest):
 
 
65
    def do(self, relpath):
 
 
66
        r = self._backing_transport.has(relpath) and 'yes' or 'no'
 
 
67
        return request.SuccessfulSmartServerResponse((r,))
 
 
70
class GetRequest(VfsRequest):
 
 
72
    def do(self, relpath):
 
 
74
            backing_bytes = self._backing_transport.get_bytes(relpath)
 
 
75
        except errors.ReadError:
 
 
76
            # cannot read the file
 
 
77
            return request.FailedSmartServerResponse(('ReadError', ))
 
 
78
        except errors.PermissionDenied:
 
 
79
            return request.FailedSmartServerResponse(('PermissionDenied',))
 
 
80
        return request.SuccessfulSmartServerResponse(('ok',), backing_bytes)
 
 
83
class AppendRequest(VfsRequest):
 
 
85
    def do(self, relpath, mode):
 
 
86
        self._relpath = relpath
 
 
87
        self._mode = _deserialise_optional_mode(mode)
 
 
89
    def do_body(self, body_bytes):
 
 
90
        old_length = self._backing_transport.append_bytes(
 
 
91
            self._relpath, body_bytes, self._mode)
 
 
92
        return request.SuccessfulSmartServerResponse(('appended', '%d' % old_length))
 
 
95
class DeleteRequest(VfsRequest):
 
 
97
    def do(self, relpath):
 
 
98
        self._backing_transport.delete(relpath)
 
 
99
        return request.SuccessfulSmartServerResponse(('ok', ))
 
 
102
class IterFilesRecursiveRequest(VfsRequest):
 
 
104
    def do(self, relpath):
 
 
105
        transport = self._backing_transport.clone(relpath)
 
 
106
        filenames = transport.iter_files_recursive()
 
 
107
        return request.SuccessfulSmartServerResponse(('names',) + tuple(filenames))
 
 
110
class ListDirRequest(VfsRequest):
 
 
112
    def do(self, relpath):
 
 
113
        filenames = self._backing_transport.list_dir(relpath)
 
 
114
        return request.SuccessfulSmartServerResponse(('names',) + tuple(filenames))
 
 
117
class MkdirRequest(VfsRequest):
 
 
119
    def do(self, relpath, mode):
 
 
120
        self._backing_transport.mkdir(relpath,
 
 
121
                                      _deserialise_optional_mode(mode))
 
 
122
        return request.SuccessfulSmartServerResponse(('ok',))
 
 
125
class MoveRequest(VfsRequest):
 
 
127
    def do(self, rel_from, rel_to):
 
 
128
        self._backing_transport.move(rel_from, rel_to)
 
 
129
        return request.SuccessfulSmartServerResponse(('ok',))
 
 
132
class PutRequest(VfsRequest):
 
 
134
    def do(self, relpath, mode):
 
 
135
        self._relpath = relpath
 
 
136
        self._mode = _deserialise_optional_mode(mode)
 
 
138
    def do_body(self, body_bytes):
 
 
139
        self._backing_transport.put_bytes(self._relpath, body_bytes, self._mode)
 
 
140
        return request.SuccessfulSmartServerResponse(('ok',))
 
 
143
class PutNonAtomicRequest(VfsRequest):
 
 
145
    def do(self, relpath, mode, create_parent, dir_mode):
 
 
146
        self._relpath = relpath
 
 
147
        self._dir_mode = _deserialise_optional_mode(dir_mode)
 
 
148
        self._mode = _deserialise_optional_mode(mode)
 
 
149
        # a boolean would be nicer XXX
 
 
150
        self._create_parent = (create_parent == 'T')
 
 
152
    def do_body(self, body_bytes):
 
 
153
        self._backing_transport.put_bytes_non_atomic(self._relpath,
 
 
156
                create_parent_dir=self._create_parent,
 
 
157
                dir_mode=self._dir_mode)
 
 
158
        return request.SuccessfulSmartServerResponse(('ok',))
 
 
161
class ReadvRequest(VfsRequest):
 
 
163
    def do(self, relpath):
 
 
164
        self._relpath = relpath
 
 
166
    def do_body(self, body_bytes):
 
 
167
        """accept offsets for a readv request."""
 
 
168
        offsets = self._deserialise_offsets(body_bytes)
 
 
169
        backing_bytes = ''.join(bytes for offset, bytes in
 
 
170
            self._backing_transport.readv(self._relpath, offsets))
 
 
171
        return request.SuccessfulSmartServerResponse(('readv',), backing_bytes)
 
 
173
    def _deserialise_offsets(self, text):
 
 
174
        # XXX: FIXME this should be on the protocol object.
 
 
176
        for line in text.split('\n'):
 
 
179
            start, length = line.split(',')
 
 
180
            offsets.append((int(start), int(length)))
 
 
184
class RenameRequest(VfsRequest):
 
 
186
    def do(self, rel_from, rel_to):
 
 
187
        self._backing_transport.rename(rel_from, rel_to)
 
 
188
        return request.SuccessfulSmartServerResponse(('ok', ))
 
 
191
class RmdirRequest(VfsRequest):
 
 
193
    def do(self, relpath):
 
 
194
        self._backing_transport.rmdir(relpath)
 
 
195
        return request.SuccessfulSmartServerResponse(('ok', ))
 
 
198
class StatRequest(VfsRequest):
 
 
200
    def do(self, relpath):
 
 
201
        stat = self._backing_transport.stat(relpath)
 
 
202
        return request.SuccessfulSmartServerResponse(
 
 
203
            ('stat', str(stat.st_size), oct(stat.st_mode)))