~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/smart/bzrdir.py

  • Committer: Martin Pool
  • Date: 2005-03-14 07:07:24 UTC
  • Revision ID: mbp@sourcefrog.net-20050314070724-ba6c85db7d96c508
- add setup.py and install instructions
- rename main script to just bzr

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2006-2010 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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
16
 
 
17
 
"""Server-side bzrdir related request implmentations."""
18
 
 
19
 
 
20
 
from bzrlib import branch, errors, repository, urlutils
21
 
from bzrlib.bzrdir import (
22
 
    BzrDir,
23
 
    BzrDirFormat,
24
 
    BzrDirMetaFormat1,
25
 
    network_format_registry,
26
 
    )
27
 
from bzrlib.smart.request import (
28
 
    FailedSmartServerResponse,
29
 
    SmartServerRequest,
30
 
    SuccessfulSmartServerResponse,
31
 
    )
32
 
 
33
 
 
34
 
class SmartServerRequestOpenBzrDir(SmartServerRequest):
35
 
 
36
 
    def do(self, path):
37
 
        try:
38
 
            t = self.transport_from_client_path(path)
39
 
        except errors.PathNotChild:
40
 
            # The client is trying to ask about a path that they have no access
41
 
            # to.
42
 
            # Ideally we'd return a FailedSmartServerResponse here rather than
43
 
            # a "successful" negative, but we want to be compatibile with
44
 
            # clients that don't anticipate errors from this method.
45
 
            answer = 'no'
46
 
        else:
47
 
            default_format = BzrDirFormat.get_default_format()
48
 
            real_bzrdir = default_format.open(t, _found=True)
49
 
            try:
50
 
                real_bzrdir._format.probe_transport(t)
51
 
            except (errors.NotBranchError, errors.UnknownFormatError):
52
 
                answer = 'no'
53
 
            else:
54
 
                answer = 'yes'
55
 
        return SuccessfulSmartServerResponse((answer,))
56
 
 
57
 
 
58
 
class SmartServerRequestOpenBzrDir_2_1(SmartServerRequest):
59
 
 
60
 
    def do(self, path):
61
 
        """Is there a BzrDir present, and if so does it have a working tree?
62
 
 
63
 
        New in 2.1.
64
 
        """
65
 
        try:
66
 
            t = self.transport_from_client_path(path)
67
 
        except errors.PathNotChild:
68
 
            # The client is trying to ask about a path that they have no access
69
 
            # to.
70
 
            return SuccessfulSmartServerResponse(('no',))
71
 
        try:
72
 
            bd = BzrDir.open_from_transport(t)
73
 
        except errors.NotBranchError:
74
 
            answer = ('no',)
75
 
        else:
76
 
            answer = ('yes',)
77
 
            if bd.has_workingtree():
78
 
                answer += ('yes',)
79
 
            else:
80
 
                answer += ('no',)
81
 
        return SuccessfulSmartServerResponse(answer)
82
 
 
83
 
 
84
 
class SmartServerRequestBzrDir(SmartServerRequest):
85
 
 
86
 
    def do(self, path, *args):
87
 
        """Open a BzrDir at path, and return self.do_bzrdir_request(*args)."""
88
 
        try:
89
 
            self._bzrdir = BzrDir.open_from_transport(
90
 
                self.transport_from_client_path(path))
91
 
        except errors.NotBranchError, e:
92
 
            return FailedSmartServerResponse(('nobranch',))
93
 
        return self.do_bzrdir_request(*args)
94
 
 
95
 
    def _boolean_to_yes_no(self, a_boolean):
96
 
        if a_boolean:
97
 
            return 'yes'
98
 
        else:
99
 
            return 'no'
100
 
 
101
 
    def _format_to_capabilities(self, repo_format):
102
 
        rich_root = self._boolean_to_yes_no(repo_format.rich_root_data)
103
 
        tree_ref = self._boolean_to_yes_no(
104
 
            repo_format.supports_tree_reference)
105
 
        external_lookup = self._boolean_to_yes_no(
106
 
            repo_format.supports_external_lookups)
107
 
        return rich_root, tree_ref, external_lookup
108
 
 
109
 
    def _repo_relpath(self, current_transport, repository):
110
 
        """Get the relative path for repository from current_transport."""
111
 
        # the relpath of the bzrdir in the found repository gives us the
112
 
        # path segments to pop-out.
113
 
        relpath = repository.bzrdir.root_transport.relpath(
114
 
            current_transport.base)
115
 
        if len(relpath):
116
 
            segments = ['..'] * len(relpath.split('/'))
117
 
        else:
118
 
            segments = []
119
 
        return '/'.join(segments)
120
 
 
121
 
 
122
 
class SmartServerBzrDirRequestCloningMetaDir(SmartServerRequestBzrDir):
123
 
 
124
 
    def do_bzrdir_request(self, require_stacking):
125
 
        """Get the format that should be used when cloning from this dir.
126
 
 
127
 
        New in 1.13.
128
 
        
129
 
        :return: on success, a 3-tuple of network names for (control,
130
 
            repository, branch) directories, where '' signifies "not present".
131
 
            If this BzrDir contains a branch reference then this will fail with
132
 
            BranchReference; clients should resolve branch references before
133
 
            calling this RPC.
134
 
        """
135
 
        try:
136
 
            branch_ref = self._bzrdir.get_branch_reference()
137
 
        except errors.NotBranchError:
138
 
            branch_ref = None
139
 
        if branch_ref is not None:
140
 
            # The server shouldn't try to resolve references, and it quite
141
 
            # possibly can't reach them anyway.  The client needs to resolve
142
 
            # the branch reference to determine the cloning_metadir.
143
 
            return FailedSmartServerResponse(('BranchReference',))
144
 
        if require_stacking == "True":
145
 
            require_stacking = True
146
 
        else:
147
 
            require_stacking = False
148
 
        control_format = self._bzrdir.cloning_metadir(
149
 
            require_stacking=require_stacking)
150
 
        control_name = control_format.network_name()
151
 
        # XXX: There should be a method that tells us that the format does/does
152
 
        # not have subformats.
153
 
        if isinstance(control_format, BzrDirMetaFormat1):
154
 
            branch_name = ('branch',
155
 
                control_format.get_branch_format().network_name())
156
 
            repository_name = control_format.repository_format.network_name()
157
 
        else:
158
 
            # Only MetaDir has delegated formats today.
159
 
            branch_name = ('branch', '')
160
 
            repository_name = ''
161
 
        return SuccessfulSmartServerResponse((control_name, repository_name,
162
 
            branch_name))
163
 
 
164
 
 
165
 
class SmartServerRequestCreateBranch(SmartServerRequestBzrDir):
166
 
 
167
 
    def do(self, path, network_name):
168
 
        """Create a branch in the bzr dir at path.
169
 
 
170
 
        This operates precisely like 'bzrdir.create_branch'.
171
 
 
172
 
        If a bzrdir is not present, an exception is propogated
173
 
        rather than 'no branch' because these are different conditions (and
174
 
        this method should only be called after establishing that a bzr dir
175
 
        exists anyway).
176
 
 
177
 
        This is the initial version of this method introduced to the smart
178
 
        server for 1.13.
179
 
 
180
 
        :param path: The path to the bzrdir.
181
 
        :param network_name: The network name of the branch type to create.
182
 
        :return: (ok, network_name)
183
 
        """
184
 
        bzrdir = BzrDir.open_from_transport(
185
 
            self.transport_from_client_path(path))
186
 
        format = branch.network_format_registry.get(network_name)
187
 
        bzrdir.branch_format = format
188
 
        result = format.initialize(bzrdir)
189
 
        rich_root, tree_ref, external_lookup = self._format_to_capabilities(
190
 
            result.repository._format)
191
 
        branch_format = result._format.network_name()
192
 
        repo_format = result.repository._format.network_name()
193
 
        repo_path = self._repo_relpath(bzrdir.root_transport,
194
 
            result.repository)
195
 
        # branch format, repo relpath, rich_root, tree_ref, external_lookup,
196
 
        # repo_network_name
197
 
        return SuccessfulSmartServerResponse(('ok', branch_format, repo_path,
198
 
            rich_root, tree_ref, external_lookup, repo_format))
199
 
 
200
 
 
201
 
class SmartServerRequestCreateRepository(SmartServerRequestBzrDir):
202
 
 
203
 
    def do(self, path, network_name, shared):
204
 
        """Create a repository in the bzr dir at path.
205
 
 
206
 
        This operates precisely like 'bzrdir.create_repository'.
207
 
 
208
 
        If a bzrdir is not present, an exception is propagated
209
 
        rather than 'no branch' because these are different conditions (and
210
 
        this method should only be called after establishing that a bzr dir
211
 
        exists anyway).
212
 
 
213
 
        This is the initial version of this method introduced to the smart
214
 
        server for 1.13.
215
 
 
216
 
        :param path: The path to the bzrdir.
217
 
        :param network_name: The network name of the repository type to create.
218
 
        :param shared: The value to pass create_repository for the shared
219
 
            parameter.
220
 
        :return: (ok, rich_root, tree_ref, external_lookup, network_name)
221
 
        """
222
 
        bzrdir = BzrDir.open_from_transport(
223
 
            self.transport_from_client_path(path))
224
 
        shared = shared == 'True'
225
 
        format = repository.network_format_registry.get(network_name)
226
 
        bzrdir.repository_format = format
227
 
        result = format.initialize(bzrdir, shared=shared)
228
 
        rich_root, tree_ref, external_lookup = self._format_to_capabilities(
229
 
            result._format)
230
 
        return SuccessfulSmartServerResponse(('ok', rich_root, tree_ref,
231
 
            external_lookup, result._format.network_name()))
232
 
 
233
 
 
234
 
class SmartServerRequestFindRepository(SmartServerRequestBzrDir):
235
 
 
236
 
    def _find(self, path):
237
 
        """try to find a repository from path upwards
238
 
 
239
 
        This operates precisely like 'bzrdir.find_repository'.
240
 
 
241
 
        :return: (relpath, rich_root, tree_ref, external_lookup, network_name).
242
 
            All are strings, relpath is a / prefixed path, the next three are
243
 
            either 'yes' or 'no', and the last is a repository format network
244
 
            name.
245
 
        :raises errors.NoRepositoryPresent: When there is no repository
246
 
            present.
247
 
        """
248
 
        bzrdir = BzrDir.open_from_transport(
249
 
            self.transport_from_client_path(path))
250
 
        repository = bzrdir.find_repository()
251
 
        path = self._repo_relpath(bzrdir.root_transport, repository)
252
 
        rich_root, tree_ref, external_lookup = self._format_to_capabilities(
253
 
            repository._format)
254
 
        network_name = repository._format.network_name()
255
 
        return path, rich_root, tree_ref, external_lookup, network_name
256
 
 
257
 
 
258
 
class SmartServerRequestFindRepositoryV1(SmartServerRequestFindRepository):
259
 
 
260
 
    def do(self, path):
261
 
        """try to find a repository from path upwards
262
 
 
263
 
        This operates precisely like 'bzrdir.find_repository'.
264
 
 
265
 
        If a bzrdir is not present, an exception is propagated
266
 
        rather than 'no branch' because these are different conditions.
267
 
 
268
 
        This is the initial version of this method introduced with the smart
269
 
        server. Modern clients will try the V2 method that adds support for the
270
 
        supports_external_lookups attribute.
271
 
 
272
 
        :return: norepository or ok, relpath.
273
 
        """
274
 
        try:
275
 
            path, rich_root, tree_ref, external_lookup, name = self._find(path)
276
 
            return SuccessfulSmartServerResponse(('ok', path, rich_root, tree_ref))
277
 
        except errors.NoRepositoryPresent:
278
 
            return FailedSmartServerResponse(('norepository', ))
279
 
 
280
 
 
281
 
class SmartServerRequestFindRepositoryV2(SmartServerRequestFindRepository):
282
 
 
283
 
    def do(self, path):
284
 
        """try to find a repository from path upwards
285
 
 
286
 
        This operates precisely like 'bzrdir.find_repository'.
287
 
 
288
 
        If a bzrdir is not present, an exception is propagated
289
 
        rather than 'no branch' because these are different conditions.
290
 
 
291
 
        This is the second edition of this method introduced in bzr 1.3, which
292
 
        returns information about the supports_external_lookups format
293
 
        attribute too.
294
 
 
295
 
        :return: norepository or ok, relpath, rich_root, tree_ref,
296
 
            external_lookup.
297
 
        """
298
 
        try:
299
 
            path, rich_root, tree_ref, external_lookup, name = self._find(path)
300
 
            return SuccessfulSmartServerResponse(
301
 
                ('ok', path, rich_root, tree_ref, external_lookup))
302
 
        except errors.NoRepositoryPresent:
303
 
            return FailedSmartServerResponse(('norepository', ))
304
 
 
305
 
 
306
 
class SmartServerRequestFindRepositoryV3(SmartServerRequestFindRepository):
307
 
 
308
 
    def do(self, path):
309
 
        """try to find a repository from path upwards
310
 
 
311
 
        This operates precisely like 'bzrdir.find_repository'.
312
 
 
313
 
        If a bzrdir is not present, an exception is propogated
314
 
        rather than 'no branch' because these are different conditions.
315
 
 
316
 
        This is the third edition of this method introduced in bzr 1.13, which
317
 
        returns information about the network name of the repository format.
318
 
 
319
 
        :return: norepository or ok, relpath, rich_root, tree_ref,
320
 
            external_lookup, network_name.
321
 
        """
322
 
        try:
323
 
            path, rich_root, tree_ref, external_lookup, name = self._find(path)
324
 
            return SuccessfulSmartServerResponse(
325
 
                ('ok', path, rich_root, tree_ref, external_lookup, name))
326
 
        except errors.NoRepositoryPresent:
327
 
            return FailedSmartServerResponse(('norepository', ))
328
 
 
329
 
 
330
 
class SmartServerBzrDirRequestConfigFile(SmartServerRequestBzrDir):
331
 
 
332
 
    def do_bzrdir_request(self):
333
 
        """Get the configuration bytes for a config file in bzrdir.
334
 
        
335
 
        The body is not utf8 decoded - it is the literal bytestream from disk.
336
 
        """
337
 
        config = self._bzrdir._get_config()
338
 
        if config is None:
339
 
            content = ''
340
 
        else:
341
 
            content = config._get_config_file().read()
342
 
        return SuccessfulSmartServerResponse((), content)
343
 
 
344
 
 
345
 
class SmartServerRequestInitializeBzrDir(SmartServerRequest):
346
 
 
347
 
    def do(self, path):
348
 
        """Initialize a bzrdir at path.
349
 
 
350
 
        The default format of the server is used.
351
 
        :return: SmartServerResponse(('ok', ))
352
 
        """
353
 
        target_transport = self.transport_from_client_path(path)
354
 
        BzrDirFormat.get_default_format().initialize_on_transport(target_transport)
355
 
        return SuccessfulSmartServerResponse(('ok', ))
356
 
 
357
 
 
358
 
class SmartServerRequestBzrDirInitializeEx(SmartServerRequestBzrDir):
359
 
 
360
 
    def parse_NoneTrueFalse(self, arg):
361
 
        if not arg:
362
 
            return None
363
 
        if arg == 'False':
364
 
            return False
365
 
        if arg == 'True':
366
 
            return True
367
 
        raise AssertionError("invalid arg %r" % arg)
368
 
 
369
 
    def parse_NoneString(self, arg):
370
 
        return arg or None
371
 
 
372
 
    def _serialize_NoneTrueFalse(self, arg):
373
 
        if arg is False:
374
 
            return 'False'
375
 
        if not arg:
376
 
            return ''
377
 
        return 'True'
378
 
 
379
 
    def do(self, bzrdir_network_name, path, use_existing_dir, create_prefix,
380
 
        force_new_repo, stacked_on, stack_on_pwd, repo_format_name,
381
 
        make_working_trees, shared_repo):
382
 
        """Initialize a bzrdir at path as per
383
 
        BzrDirFormat.initialize_on_transport_ex.
384
 
 
385
 
        New in 1.16.  (Replaces BzrDirFormat.initialize_ex verb from 1.15).
386
 
 
387
 
        :return: return SuccessfulSmartServerResponse((repo_path, rich_root,
388
 
            tree_ref, external_lookup, repo_network_name,
389
 
            repo_bzrdir_network_name, bzrdir_format_network_name,
390
 
            NoneTrueFalse(stacking), final_stack, final_stack_pwd,
391
 
            repo_lock_token))
392
 
        """
393
 
        target_transport = self.transport_from_client_path(path)
394
 
        format = network_format_registry.get(bzrdir_network_name)
395
 
        use_existing_dir = self.parse_NoneTrueFalse(use_existing_dir)
396
 
        create_prefix = self.parse_NoneTrueFalse(create_prefix)
397
 
        force_new_repo = self.parse_NoneTrueFalse(force_new_repo)
398
 
        stacked_on = self.parse_NoneString(stacked_on)
399
 
        stack_on_pwd = self.parse_NoneString(stack_on_pwd)
400
 
        make_working_trees = self.parse_NoneTrueFalse(make_working_trees)
401
 
        shared_repo = self.parse_NoneTrueFalse(shared_repo)
402
 
        if stack_on_pwd == '.':
403
 
            stack_on_pwd = target_transport.base
404
 
        repo_format_name = self.parse_NoneString(repo_format_name)
405
 
        repo, bzrdir, stacking, repository_policy = \
406
 
            format.initialize_on_transport_ex(target_transport,
407
 
            use_existing_dir=use_existing_dir, create_prefix=create_prefix,
408
 
            force_new_repo=force_new_repo, stacked_on=stacked_on,
409
 
            stack_on_pwd=stack_on_pwd, repo_format_name=repo_format_name,
410
 
            make_working_trees=make_working_trees, shared_repo=shared_repo)
411
 
        if repo is None:
412
 
            repo_path = ''
413
 
            repo_name = ''
414
 
            rich_root = tree_ref = external_lookup = ''
415
 
            repo_bzrdir_name = ''
416
 
            final_stack = None
417
 
            final_stack_pwd = None
418
 
            repo_lock_token = ''
419
 
        else:
420
 
            repo_path = self._repo_relpath(bzrdir.root_transport, repo)
421
 
            if repo_path == '':
422
 
                repo_path = '.'
423
 
            rich_root, tree_ref, external_lookup = self._format_to_capabilities(
424
 
                repo._format)
425
 
            repo_name = repo._format.network_name()
426
 
            repo_bzrdir_name = repo.bzrdir._format.network_name()
427
 
            final_stack = repository_policy._stack_on
428
 
            final_stack_pwd = repository_policy._stack_on_pwd
429
 
            # It is returned locked, but we need to do the lock to get the lock
430
 
            # token.
431
 
            repo.unlock()
432
 
            repo_lock_token = repo.lock_write() or ''
433
 
            if repo_lock_token:
434
 
                repo.leave_lock_in_place()
435
 
            repo.unlock()
436
 
        final_stack = final_stack or ''
437
 
        final_stack_pwd = final_stack_pwd or ''
438
 
 
439
 
        # We want this to be relative to the bzrdir.
440
 
        if final_stack_pwd:
441
 
            final_stack_pwd = urlutils.relative_url(
442
 
                target_transport.base, final_stack_pwd)
443
 
 
444
 
        # Can't meaningfully return a root path.
445
 
        if final_stack.startswith('/'):
446
 
            client_path = self._root_client_path + final_stack[1:]
447
 
            final_stack = urlutils.relative_url(
448
 
                self._root_client_path, client_path)
449
 
            final_stack_pwd = '.'
450
 
 
451
 
        return SuccessfulSmartServerResponse((repo_path, rich_root, tree_ref,
452
 
            external_lookup, repo_name, repo_bzrdir_name,
453
 
            bzrdir._format.network_name(),
454
 
            self._serialize_NoneTrueFalse(stacking), final_stack,
455
 
            final_stack_pwd, repo_lock_token))
456
 
 
457
 
 
458
 
class SmartServerRequestOpenBranch(SmartServerRequestBzrDir):
459
 
 
460
 
    def do_bzrdir_request(self):
461
 
        """open a branch at path and return the branch reference or branch."""
462
 
        try:
463
 
            reference_url = self._bzrdir.get_branch_reference()
464
 
            if reference_url is None:
465
 
                return SuccessfulSmartServerResponse(('ok', ''))
466
 
            else:
467
 
                return SuccessfulSmartServerResponse(('ok', reference_url))
468
 
        except errors.NotBranchError, e:
469
 
            return FailedSmartServerResponse(('nobranch',))
470
 
 
471
 
 
472
 
class SmartServerRequestOpenBranchV2(SmartServerRequestBzrDir):
473
 
 
474
 
    def do_bzrdir_request(self):
475
 
        """open a branch at path and return the reference or format."""
476
 
        try:
477
 
            reference_url = self._bzrdir.get_branch_reference()
478
 
            if reference_url is None:
479
 
                br = self._bzrdir.open_branch(ignore_fallbacks=True)
480
 
                format = br._format.network_name()
481
 
                return SuccessfulSmartServerResponse(('branch', format))
482
 
            else:
483
 
                return SuccessfulSmartServerResponse(('ref', reference_url))
484
 
        except errors.NotBranchError, e:
485
 
            return FailedSmartServerResponse(('nobranch',))
486
 
 
487
 
 
488
 
class SmartServerRequestOpenBranchV3(SmartServerRequestBzrDir):
489
 
 
490
 
    def do_bzrdir_request(self):
491
 
        """Open a branch at path and return the reference or format.
492
 
        
493
 
        This version introduced in 2.1.
494
 
 
495
 
        Differences to SmartServerRequestOpenBranchV2:
496
 
          * can return 2-element ('nobranch', extra), where 'extra' is a string
497
 
            with an explanation like 'location is a repository'.  Previously
498
 
            a 'nobranch' response would never have more than one element.
499
 
        """
500
 
        try:
501
 
            reference_url = self._bzrdir.get_branch_reference()
502
 
            if reference_url is None:
503
 
                br = self._bzrdir.open_branch(ignore_fallbacks=True)
504
 
                format = br._format.network_name()
505
 
                return SuccessfulSmartServerResponse(('branch', format))
506
 
            else:
507
 
                return SuccessfulSmartServerResponse(('ref', reference_url))
508
 
        except errors.NotBranchError, e:
509
 
            # Stringify the exception so that its .detail attribute will be
510
 
            # filled out.
511
 
            str(e)
512
 
            resp = ('nobranch',)
513
 
            detail = e.detail
514
 
            if detail:
515
 
                if detail.startswith(': '):
516
 
                    detail = detail[2:]
517
 
                resp += (detail,)
518
 
            return FailedSmartServerResponse(resp)
519