4 # Copyright (C) 2006, 2007, 2008 Google Inc.
6 # This program is free software; you can redistribute it and/or modify
7 # it under the terms of the GNU General Public License as published by
8 # the Free Software Foundation; either version 2 of the License, or
9 # (at your option) any later version.
11 # This program is distributed in the hope that it will be useful, but
12 # WITHOUT ANY WARRANTY; without even the implied warranty of
13 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 # General Public License for more details.
16 # You should have received a copy of the GNU General Public License
17 # along with this program; if not, write to the Free Software
18 # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
21 """Remote API connection map.
28 from ganeti import constants
29 from ganeti import http
31 from ganeti.rapi import baserlib
32 from ganeti.rapi import rlib1
33 from ganeti.rapi import rlib2
35 # the connection map is created at the end of this file
40 """Map resource to method.
43 def __init__(self, connector=CONNECTOR):
44 """Resource mapper constructor.
47 con: a dictionary, mapping method name with URL path regexp
50 self._connector = connector
52 def getController(self, uri):
53 """Find method for a given URI.
59 None if no method is found or a tuple containing the following fields:
60 methd: name of method mapped to URI
61 items: a list of variable intems in the path
62 args: a dictionary with additional parameters from URL
66 (path, query) = uri.split('?', 1)
67 args = cgi.parse_qs(query)
75 for key, handler in self._connector.iteritems():
77 if hasattr(key, "match"):
80 result = (handler, list(m.groups()), args)
85 result = (handler, [], args)
91 raise http.HTTPNotFound()
94 class R_root(baserlib.R_Generic):
101 """Show the list of mapped resources.
104 A dictionary with 'name' and 'uri' keys for each of them.
107 root_pattern = re.compile('^R_([a-zA-Z0-9]+)$')
110 for handler in CONNECTOR.values():
111 m = root_pattern.match(handler.__name__)
115 rootlist.append(name)
117 return baserlib.BuildUriList(rootlist, "/%s")
123 "/version": rlib1.R_version,
125 "/tags": rlib1.R_tags,
126 "/info": rlib1.R_info,
128 "/nodes": rlib1.R_nodes,
129 re.compile(r'^/nodes/([\w\._-]+)$'): rlib1.R_nodes_name,
130 re.compile(r'^/nodes/([\w\._-]+)/tags$'): rlib1.R_nodes_name_tags,
132 "/instances": rlib1.R_instances,
133 re.compile(r'^/instances/([\w\._-]+)$'): rlib1.R_instances_name,
134 re.compile(r'^/instances/([\w\._-]+)/tags$'): rlib1.R_instances_name_tags,
138 "/2/jobs": rlib2.R_2_jobs,
139 "/2/nodes": rlib2.R_2_nodes,
140 "/2/instances": rlib2.R_2_instances,
141 re.compile(r'^/2/instances/([\w\._-]+)$'): rlib1.R_instances_name,
142 re.compile(r'^/2/instances/([\w\._-]+)/tags$'): rlib2.R_2_instances_name_tags,
143 re.compile(r'/2/jobs/(%s)$' % constants.JOB_ID_TEMPLATE): rlib2.R_2_jobs_id,