← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/directory_service.py

(Marius Kruger) Update the wsgi bindings to load plugins and enable
        logging (optional)

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/directory_service.py
 
1
# Copyright (C) 2008 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
"""Directory service registration and usage.
 
18
 
 
19
Directory services are utilities that provide a mapping from URL-like strings
 
20
to true URLs.  Examples include lp:urls and per-user location aliases.
 
21
"""
 
22
 
 
23
from bzrlib import errors, registry
 
24
from bzrlib.branch import Branch
 
25
from bzrlib import urlutils
 
26
 
 
27
 
 
28
class DirectoryServiceRegistry(registry.Registry):
 
29
    """This object maintains and uses a list of directory services.
 
30
 
 
31
    Directory services may be registered via the standard Registry methods.
 
32
    They will be invoked if their key is a prefix of the supplied URL.
 
33
 
 
34
    Each item registered should be a factory of objects that provide a look_up
 
35
    method, as invoked by dereference.  Specifically, look_up should accept a
 
36
    name and URL, and return a URL.
 
37
    """
 
38
 
 
39
    def dereference(self, url):
 
40
        """Dereference a supplied URL if possible.
 
41
 
 
42
        URLs that match a registered directory service prefix are looked up in
 
43
        it.  Non-matching urls are returned verbatim.
 
44
 
 
45
        This is applied only once; the resulting URL must not be one that
 
46
        requires further dereferencing.
 
47
 
 
48
        :param url: The URL to dereference
 
49
        :return: The dereferenced URL if applicable, the input URL otherwise.
 
50
        """
 
51
        match = self.get_prefix(url)
 
52
        if match is None:
 
53
            return url
 
54
        service, name = match
 
55
        return service().look_up(name, url)
 
56
 
 
57
directories = DirectoryServiceRegistry()
 
58
 
 
59
 
 
60
class AliasDirectory(object):
 
61
    """Directory lookup for locations associated with a branch.
 
62
 
 
63
    :parent, :submit, :public, :push, :this, and :bound are currently
 
64
    supported.  On error, a subclass of DirectoryLookupFailure will be raised.
 
65
    """
 
66
 
 
67
    def look_up(self, name, url):
 
68
        branch = Branch.open_containing('.')[0]
 
69
        lookups = {
 
70
            'parent': branch.get_parent,
 
71
            'submit': branch.get_submit_branch,
 
72
            'public': branch.get_public_branch,
 
73
            'bound': branch.get_bound_location,
 
74
            'push': branch.get_push_location,
 
75
            'this': lambda: branch.base
 
76
        }
 
77
        parts = url.split('/', 1)
 
78
        if len(parts) == 2:
 
79
            name, extra = parts
 
80
        else:
 
81
            (name,) = parts
 
82
            extra = None
 
83
        try:
 
84
            method = lookups[name[1:]]
 
85
        except KeyError:
 
86
            raise errors.InvalidLocationAlias(url)
 
87
        else:
 
88
            result = method()
 
89
        if result is None:
 
90
            raise errors.UnsetLocationAlias(url)
 
91
        if extra is not None:
 
92
            result = urlutils.join(result, extra)
 
93
        return result
 
94
 
 
95
directories.register(':', AliasDirectory,
 
96
                     'Easy access to remembered branch locations')