##// END OF EJS Templates
namespaces: remove templatename method on the namespaces object...
Sean Farley -
r23739:b8b246cf default
parent child Browse files
Show More
@@ -1,133 +1,129
1 1 from i18n import _
2 2 from mercurial import util
3 3 import templatekw
4 4
5 5 def tolist(val):
6 6 """
7 7 a convenience method to return an empty list instead of None
8 8 """
9 9 if val is None:
10 10 return []
11 11 else:
12 12 return [val]
13 13
14 14 class namespaces(object):
15 15 """provides an interface to register and operate on multiple namespaces. See
16 16 the namespace class below for details on the namespace object.
17 17
18 18 """
19 19
20 20 _names_version = 0
21 21
22 22 def __init__(self):
23 23 self._names = util.sortdict()
24 24
25 25 # shorten the class name for less indentation
26 26 ns = namespace
27 27
28 28 # we need current mercurial named objects (bookmarks, tags, and
29 29 # branches) to be initialized somewhere, so that place is here
30 30 n = ns("bookmarks", "bookmark",
31 31 lambda repo, name: tolist(repo._bookmarks.get(name)),
32 32 lambda repo, name: repo.nodebookmarks(name))
33 33 self.addnamespace(n)
34 34
35 35 n = ns("tags", "tag",
36 36 lambda repo, name: tolist(repo._tagscache.tags.get(name)),
37 37 lambda repo, name: repo.nodetags(name))
38 38 self.addnamespace(n)
39 39
40 40 n = ns("branches", "branch",
41 41 lambda repo, name: tolist(repo.branchtip(name)),
42 42 lambda repo, node: [repo[node].branch()])
43 43 self.addnamespace(n)
44 44
45 45 def __getitem__(self, namespace):
46 46 """returns the namespace object"""
47 47 return self._names[namespace]
48 48
49 49 def addnamespace(self, namespace, order=None):
50 50 """register a namespace
51 51
52 52 namespace: the name to be registered (in plural form)
53 53 order: optional argument to specify the order of namespaces
54 54 (e.g. 'branches' should be listed before 'bookmarks')
55 55
56 56 """
57 57 if order is not None:
58 58 self._names.insert(order, namespace.name, namespace)
59 59 else:
60 60 self._names[namespace.name] = namespace
61 61
62 62 # we only generate a template keyword if one does not already exist
63 63 if namespace.name not in templatekw.keywords:
64 64 def generatekw(**args):
65 65 return templatekw.shownames(namespace.name, **args)
66 66
67 67 templatekw.keywords[namespace.name] = generatekw
68 68
69 69 def singlenode(self, repo, name):
70 70 """
71 71 Return the 'best' node for the given name. Best means the first node
72 72 in the first nonempty list returned by a name-to-nodes mapping function
73 73 in the defined precedence order.
74 74
75 75 Raises a KeyError if there is no such node.
76 76 """
77 77 for ns, v in self._names.iteritems():
78 78 n = v.namemap(repo, name)
79 79 if n:
80 80 # return max revision number
81 81 if len(n) > 1:
82 82 cl = repo.changelog
83 83 maxrev = max(cl.rev(node) for node in n)
84 84 return cl.node(maxrev)
85 85 return n[0]
86 86 raise KeyError(_('no such name: %s') % name)
87 87
88 def templatename(self, namespace):
89 """method that returns the template name of a namespace"""
90 return self._names[namespace].templatename
91
92 88 class namespace(object):
93 89 """provides an interface to a namespace
94 90
95 91 Namespaces are basically generic many-to-many mapping between some
96 92 (namespaced) names and nodes. The goal here is to control the pollution of
97 93 jamming things into tags or bookmarks (in extension-land) and to simplify
98 94 internal bits of mercurial: log output, tab completion, etc.
99 95
100 96 More precisely, we define a mapping of names to nodes, and a mapping from
101 97 nodes to names. Each mapping returns a list.
102 98
103 99 Furthermore, each name mapping will be passed a name to lookup which might
104 100 not be in its domain. In this case, each method should return an empty list
105 101 and not raise an error.
106 102
107 103 This namespace object will define the properties we need:
108 104 'name': the namespace (plural form)
109 105 'templatename': name to use for templating (usually the singular form
110 106 of the plural namespace name)
111 107 'namemap': function that takes a name and returns a list of nodes
112 108 'nodemap': function that takes a node and returns a list of names
113 109
114 110 """
115 111
116 112 def __init__(self, name, templatename, namemap, nodemap):
117 113 """create a namespace
118 114
119 115 name: the namespace to be registered (in plural form)
120 116 templatename: the name to use for templating
121 117 namemap: function that inputs a node, output name(s)
122 118 nodemap: function that inputs a name, output node(s)
123 119
124 120 """
125 121 self.name = name
126 122 self.templatename = templatename
127 123 self.namemap = namemap
128 124 self.nodemap = nodemap
129 125
130 126 def names(self, repo, node):
131 127 """method that returns a (sorted) list of names in a namespace that
132 128 match a given node"""
133 129 return sorted(self.nodemap(repo, node))
General Comments 0
You need to be logged in to leave comments. Login now