Source code for alignak.objects.serviceextinfo

#!/usr/bin/env python
# -*- coding: utf-8 -*-

#
# Copyright (C) 2015-2015: Alignak team, see AUTHORS.txt file for contributors
#
# This file is part of Alignak.
#
# Alignak is free software: you can redistribute it and/or modify
# it under the terms of the GNU Affero General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# Alignak is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU Affero General Public License for more details.
#
# You should have received a copy of the GNU Affero General Public License
# along with Alignak.  If not, see <http://www.gnu.org/licenses/>.
#
#
# This file incorporates work covered by the following copyright and
# permission notice:
#
#  Copyright (C) 2009-2014:
#     Hartmut Goebel, h.goebel@goebel-consult.de
#     aviau, alexandre.viau@savoirfairelinux.com
#     Nicolas Dupeux, nicolas@dupeux.net
#     Sebastien Coavoux, s.coavoux@free.fr
#     Jean Gabes, naparuba@gmail.com
#     Romain Forlot, rforlot@yahoo.com

#  This file is part of Shinken.
#
#  Shinken is free software: you can redistribute it and/or modify
#  it under the terms of the GNU Affero General Public License as published by
#  the Free Software Foundation, either version 3 of the License, or
#  (at your option) any later version.
#
#  Shinken is distributed in the hope that it will be useful,
#  but WITHOUT ANY WARRANTY; without even the implied warranty of
#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
#  GNU Affero General Public License for more details.
#
#  You should have received a copy of the GNU Affero General Public License
#  along with Shinken.  If not, see <http://www.gnu.org/licenses/>.

""" This is the main class for the Service ext info. In fact it's mainly
about the configuration part. Parameters are merged in Service so it's
no use in running part
"""


from alignak.objects.item import Item, Items

from alignak.autoslots import AutoSlots
from alignak.property import StringProp


[docs]class ServiceExtInfo(Item): """ServiceExtInfo class is made to handle some parameters of SchedulingItem:: * notes * notes_url * icon_image * icon_image_alt TODO: Is this class really necessary? """ # AutoSlots create the __slots__ with properties and # running_properties names __metaclass__ = AutoSlots _id = 1 # zero is reserved for host (primary node for parents) my_type = 'serviceextinfo' # properties defined by configuration # *required: is required in conf # *default: default value if no set in conf # *pythonize: function to call when transforming string to python object # *fill_brok: if set, send to broker. there are two categories: # full_status for initial and update status, check_result for check results # *no_slots: do not take this property for __slots__ # Only for the initial call # conf_send_preparation: if set, will pass the property to this function. It's used to "flatten" # some dangerous properties like realms that are too 'linked' to be send like that. # brok_transformation: if set, will call the function with the value of the property # the major times it will be to flatten the data (like realm_name instead of the realm object). properties = Item.properties.copy() properties.update({ 'host_name': StringProp(), 'service_description': StringProp(), 'notes': StringProp(default=''), 'notes_url': StringProp(default=''), 'icon_image': StringProp(default=''), 'icon_image_alt': StringProp(default=''), }) # Hosts macros and prop that give the information # the prop can be callable or not macros = { 'SERVICEDESC': 'service_description', 'SERVICEACTIONURL': 'action_url', 'SERVICENOTESURL': 'notes_url', 'SERVICENOTES': 'notes' } ####### # __ _ _ _ # / _(_) | | (_) # ___ ___ _ __ | |_ _ __ _ _ _ _ __ __ _| |_ _ ___ _ __ # / __/ _ \| '_ \| _| |/ _` | | | | '__/ _` | __| |/ _ \| '_ \ # | (_| (_) | | | | | | | (_| | |_| | | | (_| | |_| | (_) | | | | # \___\___/|_| |_|_| |_|\__, |\__,_|_| \__,_|\__|_|\___/|_| |_| # __/ | # |___/ ######
[docs] def is_correct(self): """ Check if this object is correct :return: True, always. :rtype: bool TODO: Clean this function """ state = True cls = self.__class__ return state
[docs] def get_name(self): """Accessor to host_name attribute or name if first not defined :return: host name (no sense) :rtype: str TODO: Clean this function """ if not self.is_tpl(): try: return self.host_name except AttributeError: # outch, no hostname return 'UNNAMEDHOST' else: try: return self.name except AttributeError: # outch, no name for this template return 'UNNAMEDHOSTTEMPLATE'
[docs] def get_dbg_name(self): """Get the host name for debugging (host_name) :return: service extinfo host name :rtype: str TODO: Remove this function, get_name is doing it """ return self.host_name
[docs] def get_full_name(self): """Get the full name for debugging (host_name) :return: service extinfo host name :rtype: str TODO: Remove this function, get_name is doing it """ return self.host_name
[docs]class ServicesExtInfo(Items): """ServicesExtInfo manage ServiceExtInfo and propagate properties (listed before) into Services if necessary """ name_property = "host_name" # use for the search by name inner_class = ServiceExtInfo # use for know what is in items
[docs] def merge(self, services): """Merge extended host information into services :param services: services list, to look for a specific one :type services: alignak.objects.service.Services :return: None """ for extinfo in self: if hasattr(extinfo, 'register') and not getattr(extinfo, 'register'): # We don't have to merge template continue hosts_names = extinfo.get_name().split(",") for host_name in hosts_names: serv = services.find_srv_by_name_and_hostname(host_name, extinfo.service_description) if serv is not None: # FUUUUUUUUUUsion self.merge_extinfo(serv, extinfo)
[docs] def merge_extinfo(self, service, extinfo): """Merge extended host information into a service :param service: the service to edit :type service: alignak.objects.service.Service :param extinfo: the external info we get data from :type extinfo: alignak.objects.serviceextinfo.ServiceExtInfo :return: None """ properties = ['notes', 'notes_url', 'icon_image', 'icon_image_alt'] # service properties have precedence over serviceextinfo properties for prop in properties: if getattr(service, prop) == '' and getattr(extinfo, prop) != '': setattr(service, prop, getattr(extinfo, prop))