← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/directory_service.py

  • Committer: Ian Clatworthy
  • Date: 2009-09-09 15:30:59 UTC
  • mto: (4634.37.2 prepare-2.0)
  • mto: This revision was merged to the branch mainline in revision 4689.
  • Revision ID: ian.clatworthy@canonical.com-20090909153059-sb038agvd38ci2q8
more link fixes in the User Guide

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/directory_service.py
1
 
# Copyright (C) 2008, 2009, 2011 Canonical Ltd
 
1
# Copyright (C) 2008 Canonical Ltd
2
2
#
3
3
# This program is free software; you can redistribute it and/or modify
4
4
# it under the terms of the GNU General Public License as published by
20
20
to true URLs.  Examples include lp:urls and per-user location aliases.
21
21
"""
22
22
 
23
 
from __future__ import absolute_import
24
 
 
25
 
from bzrlib import (
26
 
    errors,
27
 
    registry,
28
 
    )
 
23
from bzrlib import errors, registry
29
24
from bzrlib.lazy_import import lazy_import
30
25
lazy_import(globals(), """
31
 
from bzrlib import (
32
 
    branch as _mod_branch,
33
 
    controldir as _mod_controldir,
34
 
    urlutils,
35
 
    )
 
26
from bzrlib.branch import Branch
 
27
from bzrlib import urlutils
36
28
""")
37
29
 
38
30
 
67
59
 
68
60
directories = DirectoryServiceRegistry()
69
61
 
 
62
 
70
63
class AliasDirectory(object):
71
64
    """Directory lookup for locations associated with a branch.
72
65
 
74
67
    supported.  On error, a subclass of DirectoryLookupFailure will be raised.
75
68
    """
76
69
 
77
 
    branch_aliases = registry.Registry()
78
 
    branch_aliases.register('parent', lambda b: b.get_parent(),
79
 
        help="The parent of this branch.")
80
 
    branch_aliases.register('submit', lambda b: b.get_submit_branch(),
81
 
        help="The submit branch for this branch.")
82
 
    branch_aliases.register('public', lambda b: b.get_public_branch(),
83
 
        help="The public location of this branch.")
84
 
    branch_aliases.register('bound', lambda b: b.get_bound_location(),
85
 
        help="The branch this branch is bound to, for bound branches.")
86
 
    branch_aliases.register('push', lambda b: b.get_push_location(),
87
 
        help="The saved location used for `bzr push` with no arguments.")
88
 
    branch_aliases.register('this', lambda b: b.base,
89
 
        help="This branch.")
90
 
 
91
70
    def look_up(self, name, url):
92
 
        branch = _mod_branch.Branch.open_containing('.')[0]
 
71
        branch = Branch.open_containing('.')[0]
 
72
        lookups = {
 
73
            'parent': branch.get_parent,
 
74
            'submit': branch.get_submit_branch,
 
75
            'public': branch.get_public_branch,
 
76
            'bound': branch.get_bound_location,
 
77
            'push': branch.get_push_location,
 
78
            'this': lambda: branch.base
 
79
        }
93
80
        parts = url.split('/', 1)
94
81
        if len(parts) == 2:
95
82
            name, extra = parts
97
84
            (name,) = parts
98
85
            extra = None
99
86
        try:
100
 
            method = self.branch_aliases.get(name[1:])
 
87
            method = lookups[name[1:]]
101
88
        except KeyError:
102
89
            raise errors.InvalidLocationAlias(url)
103
90
        else:
104
 
            result = method(branch)
 
91
            result = method()
105
92
        if result is None:
106
93
            raise errors.UnsetLocationAlias(url)
107
94
        if extra is not None:
108
95
            result = urlutils.join(result, extra)
109
96
        return result
110
97
 
111
 
    @classmethod
112
 
    def help_text(cls, topic):
113
 
        alias_lines = []
114
 
        for key in cls.branch_aliases.keys():
115
 
            help = cls.branch_aliases.get_help(key)
116
 
            alias_lines.append("  :%-10s%s\n" % (key, help))
117
 
        return """\
118
 
Location aliases
119
 
================
120
 
 
121
 
Bazaar defines several aliases for locations associated with a branch.  These
122
 
can be used with most commands that expect a location, such as `bzr push`.
123
 
 
124
 
The aliases are::
125
 
 
126
 
%s
127
 
For example, to push to the parent location::
128
 
 
129
 
    bzr push :parent
130
 
""" % "".join(alias_lines)
131
 
 
132
 
 
133
98
directories.register(':', AliasDirectory,
134
99
                     'Easy access to remembered branch locations')
135
 
 
136
 
 
137
 
class ColocatedDirectory(object):
138
 
    """Directory lookup for colocated branches.
139
 
 
140
 
    co:somename will resolve to the colocated branch with "somename" in
141
 
    the current directory.
142
 
    """
143
 
 
144
 
    def look_up(self, name, url):
145
 
        dir = _mod_controldir.ControlDir.open_containing('.')[0]
146
 
        return urlutils.join_segment_parameters(dir.user_url,
147
 
            {"branch": urlutils.escape(name)})
148
 
 
149
 
 
150
 
directories.register('co:', ColocatedDirectory,
151
 
                     'Easy access to colocated branches')
152