ipsilon/admin/common.py

   1 # Copyright (C) 2014  Simo Sorce <simo@redhat.com>
   2 #
   3 # see file 'COPYING' for use and warranty information
   4 #
   5 # This program is free software; you can redistribute it and/or modify
   6 # it under the terms of the GNU General Public License as published by
   7 # the Free Software Foundation, either version 3 of the License, or
   8 # (at your option) any later version.
   9 #
  10 # This program is distributed in the hope that it will be useful,
  11 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 # GNU General Public License for more details.
  14 #
  15 # You should have received a copy of the GNU General Public License
  16 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
  17
  18 import cherrypy
  19 import logging
  20 from ipsilon.util.page import Page
  21 from ipsilon.util.page import admin_protect
  22 from ipsilon.util.endpoint import allow_iframe
  23 from ipsilon.util import config as pconfig
  24
  25
  26 ADMIN_STATUS_OK = "success"
  27 ADMIN_STATUS_ERROR = "danger"
  28 ADMIN_STATUS_WARN = "warning"
  29
  30
  31 class AdminError(Exception):
  32     def __init__(self, message):
  33         super(AdminError, self).__init__(message)
  34         self.message = message
  35
  36     def __str__(self):
  37         return str(self.message)
  38
  39
  40 class AdminPage(Page):
  41
  42     def __init__(self, *args, **kwargs):
  43         super(AdminPage, self).__init__(*args, **kwargs)
  44         self.auth_protect = True
  45
  46
  47 class AdminPluginConfig(AdminPage):
  48
  49     def __init__(self, po, site, parent):
  50         super(AdminPluginConfig, self).__init__(site, form=True)
  51         self._po = po
  52         self.title = '%s plugin' % po.name
  53         self.url = '%s/%s' % (parent.url, po.name)
  54         self.facility = parent.facility
  55         self.menu = [parent]
  56         self.back = parent.url
  57
  58     def root_with_msg(self, message=None, message_type=None):
  59         return self._template('admin/option_config.html', title=self.title,
  60                               menu=self.menu, action=self.url, back=self.back,
  61                               message=message, message_type=message_type,
  62                               name='admin_%s_%s_form' % (self.facility,
  63                                                          self._po.name),
  64                               config=self._po.get_config_obj())
  65
  66     @admin_protect
  67     def GET(self, *args, **kwargs):
  68         return self.root_with_msg()
  69
  70     @admin_protect
  71     def POST(self, *args, **kwargs):
  72
  73         if self._po.is_readonly:
  74             return self.root_with_msg(
  75                 message="Configuration is marked Read-Only",
  76                 message_type=ADMIN_STATUS_WARN)
  77
  78         message = "Nothing was modified."
  79         message_type = "info"
  80         new_db_values = dict()
  81
  82         conf = self._po.get_config_obj()
  83
  84         for name, option in conf.iteritems():
  85             if name in kwargs:
  86                 value = kwargs[name]
  87                 if isinstance(option, pconfig.List):
  88                     value = [x.strip() for x in value.split('\n')]
  89                 elif isinstance(option, pconfig.Condition):
  90                     value = True
  91             else:
  92                 if isinstance(option, pconfig.Condition):
  93                     value = False
  94                 elif isinstance(option, pconfig.Choice):
  95                     value = list()
  96                     for a in option.get_allowed():
  97                         aname = '%s_%s' % (name, a)
  98                         if aname in kwargs:
  99                             value.append(a)
 100                 elif isinstance(option, pconfig.MappingList):
 101                     value = get_mapping_list_value(name,
 102                                                    option.get_value(),
 103                                                    **kwargs)
 104                     if value is None:
 105                         continue
 106                 elif isinstance(option, pconfig.ComplexList):
 107                     value = get_complex_list_value(name,
 108                                                    option.get_value(),
 109                                                    **kwargs)
 110                     if value is None:
 111                         continue
 112                 else:
 113                     continue
 114
 115             if value != option.get_value():
 116                 cherrypy.log.error("Storing [%s]: %s = %s" %
 117                                    (self._po.name, name, value),
 118                                    severity=logging.DEBUG)
 119             option.set_value(value)
 120             new_db_values[name] = option.export_value()
 121
 122         if len(new_db_values) != 0:
 123             # First we try to save in the database
 124             try:
 125                 self._po.save_plugin_config(new_db_values)
 126                 message = "New configuration saved."
 127                 message_type = ADMIN_STATUS_OK
 128             except Exception as e:  # pylint: disable=broad-except
 129                 self.error('Failed to save data: %s' % e)
 130                 message = "Failed to save data!"
 131                 message_type = ADMIN_STATUS_ERROR
 132
 133             # Then refresh the actual objects
 134             self._po.refresh_plugin_config()
 135
 136         return self.root_with_msg(message=message,
 137                                   message_type=message_type)
 138
 139
 140 class AdminPluginsOrder(AdminPage):
 141
 142     def __init__(self, site, parent, facility):
 143         super(AdminPluginsOrder, self).__init__(site, form=True)
 144         self.parent = parent
 145         self.facility = facility
 146         self.url = '%s/order' % parent.url
 147         self.menu = [parent]
 148
 149     @admin_protect
 150     def GET(self, *args, **kwargs):
 151         return self.parent.root_with_msg()
 152
 153     @admin_protect
 154     def POST(self, *args, **kwargs):
 155
 156         if self._site[self.facility].is_readonly:
 157             return self.parent.root_with_msg(
 158                 message="Configuration is marked Read-Only",
 159                 message_type=ADMIN_STATUS_WARN)
 160
 161         message = "Nothing was modified."
 162         message_type = "info"
 163         changed = None
 164         cur_enabled = self._site[self.facility].enabled
 165
 166         if 'order' in kwargs:
 167             order = kwargs['order'].split(',')
 168             if len(order) != 0:
 169                 new_order = []
 170                 try:
 171                     for v in order:
 172                         val = v.strip()
 173                         if val not in cur_enabled:
 174                             error = "Invalid plugin name: %s" % val
 175                             raise ValueError(error)
 176                         new_order.append(val)
 177                     if len(new_order) < len(cur_enabled):
 178                         for val in cur_enabled:
 179                             if val not in new_order:
 180                                 new_order.append(val)
 181
 182                     self.parent.save_enabled_plugins(new_order)
 183
 184                     # When all is saved update also live config. The
 185                     # live config is the ordered list of plugin names.
 186                     self._site[self.facility].refresh_enabled()
 187
 188                     message = "New configuration saved."
 189                     message_type = ADMIN_STATUS_OK
 190
 191                     changed = dict()
 192                     self.debug('%s -> %s' % (cur_enabled, new_order))
 193                     for i in range(0, len(cur_enabled)):
 194                         if cur_enabled[i] != new_order[i]:
 195                             changed[cur_enabled[i]] = 'reordered'
 196
 197                 except ValueError, e:
 198                     message = str(e)
 199                     message_type = ADMIN_STATUS_ERROR
 200
 201                 except Exception as e:  # pylint: disable=broad-except
 202                     self.error('Failed to save data: %s' % e)
 203                     message = "Failed to save data!"
 204                     message_type = ADMIN_STATUS_ERROR
 205
 206         return self.parent.root_with_msg(message=message,
 207                                          message_type=message_type,
 208                                          changed=changed)
 209
 210
 211 class AdminPlugins(AdminPage):
 212     def __init__(self, name, site, parent, facility, ordered=True):
 213         super(AdminPlugins, self).__init__(site)
 214         self._master = parent
 215         self.name = name
 216         self.title = '%s plugins' % name
 217         self.url = '%s/%s' % (parent.url, name)
 218         self.facility = facility
 219         self.template = 'admin/plugins.html'
 220         self.order = None
 221         parent.add_subtree(name, self)
 222
 223         if self._site[facility] is None:
 224             return
 225
 226         for plugin in self._site[facility].available:
 227             cherrypy.log.error('Admin info plugin: %s' % plugin,
 228                                severity=logging.DEBUG)
 229             obj = self._site[facility].available[plugin]
 230             page = AdminPluginConfig(obj, self._site, self)
 231             if hasattr(obj, 'admin'):
 232                 obj.admin.mount(page)
 233             self.add_subtree(plugin, page)
 234
 235         if ordered:
 236             self.order = AdminPluginsOrder(self._site, self, facility)
 237
 238     def save_enabled_plugins(self, names):
 239         self._site[self.facility].save_enabled(names)
 240
 241     def root_with_msg(self, message=None, message_type=None, changed=None):
 242         plugins = self._site[self.facility]
 243
 244         if changed is None:
 245             changed = dict()
 246
 247         targs = {'title': self.title,
 248                  'menu': self._master.menu,
 249                  'message': message,
 250                  'message_type': message_type,
 251                  'available': plugins.available,
 252                  'enabled': plugins.enabled,
 253                  'changed': changed,
 254                  'baseurl': self.url,
 255                  'newurl': self.url}
 256         if self.order:
 257             targs['order_name'] = '%s_order_form' % self.name
 258             targs['order_action'] = self.order.url
 259
 260         return self._template(self.template, **targs)
 261
 262     def root(self, *args, **kwargs):
 263         return self.root_with_msg()
 264
 265     def _get_plugin_obj(self, plugin):
 266         plugins = self._site[self.facility]
 267         if plugins.is_readonly:
 268             msg = "Configuration is marked Read-Only"
 269             raise AdminError(msg)
 270         if plugin not in plugins.available:
 271             msg = "Unknown plugin %s" % plugin
 272             raise AdminError(msg)
 273         obj = plugins.available[plugin]
 274         if obj.is_readonly:
 275             msg = "Plugin Configuration is marked Read-Only"
 276             raise AdminError(msg)
 277         return obj
 278
 279     @admin_protect
 280     def enable(self, plugin):
 281         msg = None
 282         try:
 283             obj = self._get_plugin_obj(plugin)
 284         except AdminError, e:
 285             return self.root_with_msg(str(e), ADMIN_STATUS_WARN)
 286         if not obj.is_enabled:
 287             try:
 288                 obj.enable()
 289             except Exception as e:  # pylint: disable=broad-except
 290                 return self.root_with_msg(str(e), ADMIN_STATUS_WARN)
 291             obj.save_enabled_state()
 292             msg = "Plugin %s enabled" % obj.name
 293         return self.root_with_msg(msg, ADMIN_STATUS_OK,
 294                                   changed={obj.name: 'enabled'})
 295     enable.public_function = True
 296
 297     @admin_protect
 298     def disable(self, plugin):
 299         msg = None
 300         try:
 301             obj = self._get_plugin_obj(plugin)
 302         except AdminError, e:
 303             return self.root_with_msg(str(e), ADMIN_STATUS_WARN)
 304         if obj.is_enabled:
 305             try:
 306                 obj.disable()
 307             except Exception as e:  # pylint: disable=broad-except
 308                 return self.root_with_msg(str(e), ADMIN_STATUS_WARN)
 309             obj.save_enabled_state()
 310             msg = "Plugin %s disabled" % obj.name
 311         return self.root_with_msg(msg, ADMIN_STATUS_OK,
 312                                   changed={obj.name: 'disabled'})
 313     disable.public_function = True
 314
 315
 316 class Admin(AdminPage):
 317
 318     def __init__(self, site, mount):
 319         super(Admin, self).__init__(site)
 320         self.title = 'Home'
 321         self.mount = mount
 322         self.url = '%s/%s' % (self.basepath, mount)
 323         self.menu = [self]
 324
 325     def root(self, *args, **kwargs):
 326         return self._template('admin/index.html',
 327                               title='Configuration',
 328                               baseurl=self.url,
 329                               menu=self.menu)
 330
 331     def add_subtree(self, name, page):
 332         self.__dict__[name] = page
 333         self.menu.append(page)
 334
 335     def del_subtree(self, name):
 336         self.menu.remove(self.__dict__[name])
 337         del self.__dict__[name]
 338
 339     def get_menu_urls(self):
 340         urls = dict()
 341         for item in self.menu:
 342             name = getattr(item, 'name', None)
 343             if name:
 344                 urls['%s_url' % name] = cherrypy.url('/%s/%s' % (self.mount,
 345                                                                  name))
 346         return urls
 347
 348     @admin_protect
 349     @allow_iframe
 350     def scheme(self):
 351         cherrypy.response.headers.update({'Content-Type': 'image/svg+xml'})
 352         urls = self.get_menu_urls()
 353         return str(self._template('admin/ipsilon-scheme.svg', **urls))
 354     scheme.public_function = True
 355
 356
 357 def get_complex_list_value(name, old_value, **kwargs):
 358     delete = list()
 359     change = dict()
 360     for key, val in kwargs.iteritems():
 361         if not key.startswith(name):
 362             continue
 363         n = key[len(name):]
 364         if len(n) == 0 or n[0] != ' ':
 365             continue
 366         try:
 367             index, field = n[1:].split('-')
 368         except ValueError:
 369             continue
 370         if field == 'delete':
 371             delete.append(int(index))
 372         elif field == 'name':
 373             change[int(index)] = val
 374
 375     if len(delete) == 0 and len(change) == 0:
 376         return None
 377
 378     value = old_value
 379
 380     # remove unwanted changes
 381     for i in delete:
 382         if i in change:
 383             del change[i]
 384
 385     # perform requested changes
 386     for index, val in change.iteritems():
 387         val_list = val.split('/')
 388         stripped = list()
 389         for v in val_list:
 390             stripped.append(v.strip())
 391         if len(stripped) == 1:
 392             stripped = stripped[0]
 393         if len(value) <= index:
 394             value.extend([None]*(index + 1 - len(value)))
 395         value[index] = stripped
 396
 397         if len(value[index]) == 0:
 398             value[index] = None
 399
 400     # the previous loop may add 'None' entries
 401     # if any still exists mark them to be deleted
 402     for i in xrange(0, len(value)):
 403         if value[i] is None:
 404             delete.append(i)
 405
 406     # remove duplicates and set in reverse order
 407     delete = list(set(delete))
 408     delete.sort(reverse=True)
 409
 410     for i in delete:
 411         if len(value) > i:
 412             del value[i]
 413
 414     if len(value) == 0:
 415         value = None
 416     return value
 417
 418
 419 def get_mapping_list_value(name, old_value, **kwargs):
 420     delete = list()
 421     change = dict()
 422     for key, val in kwargs.iteritems():
 423         if not key.startswith(name):
 424             continue
 425         n = key[len(name):]
 426         if len(n) == 0 or n[0] != ' ':
 427             continue
 428         try:
 429             index, field = n[1:].split('-')
 430         except ValueError:
 431             continue
 432         if field == 'delete':
 433             delete.append(int(index))
 434         else:
 435             i = int(index)
 436             if i not in change:
 437                 change[i] = dict()
 438             change[i][field] = val
 439
 440     if len(delete) == 0 and len(change) == 0:
 441         return None
 442
 443     value = old_value
 444
 445     # remove unwanted changes
 446     for i in delete:
 447         if i in change:
 448             del change[i]
 449
 450     # perform requested changes
 451     for index, fields in change.iteritems():
 452         for k in 'from', 'to':
 453             if k in fields:
 454                 val = fields[k]
 455                 val_list = val.split('/')
 456                 stripped = list()
 457                 for v in val_list:
 458                     stripped.append(v.strip())
 459                 if len(stripped) == 1:
 460                     stripped = stripped[0]
 461                 if len(value) <= index:
 462                     value.extend([None]*(index + 1 - len(value)))
 463                 if value[index] is None:
 464                     value[index] = [None, None]
 465                 if k == 'from':
 466                     i = 0
 467                 else:
 468                     i = 1
 469                 value[index][i] = stripped
 470
 471         # eliminate incomplete/incorrect entries
 472         if value[index] is not None:
 473             if ((len(value[index]) != 2 or
 474                  value[index][0] is None or
 475                  len(value[index][0]) == 0 or
 476                  value[index][1] is None or
 477                  len(value[index][1]) == 0)):
 478                 value[index] = None
 479
 480     # the previous loop may add 'None' entries
 481     # if any still exists mark them to be deleted
 482     for i in xrange(0, len(value)):
 483         if value[i] is None:
 484             delete.append(i)
 485
 486     # remove duplicates and set in reverse order
 487     delete = list(set(delete))
 488     delete.sort(reverse=True)
 489
 490     for i in delete:
 491         if len(value) > i:
 492             del value[i]
 493
 494     if len(value) == 0:
 495         value = None
 496     return value