# -*- coding: utf-8 -*-
#
# Copyright 2013-2022 Univention GmbH
#
# https://www.univention.de/
#
# All rights reserved.
#
# The source code of this program is made available
# under the terms of the GNU Affero General Public License version 3
# (GNU AGPL V3) as published by the Free Software Foundation.
#
# Binary versions of this program provided by Univention to you as
# well as other copyrighted, protected or trademarked materials like
# Logos, graphics, fonts, specific documentations and configurations,
# cryptographic keys etc. are subject to a license agreement between
# you and Univention and not subject to the GNU AGPL V3.
#
# In the case you use this program under the terms of the GNU AGPL V3,
# the program is provided 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 with the Debian GNU/Linux or Univention distribution in file
# /usr/share/common-licenses/AGPL-3; if not, see
# <https://www.gnu.org/licenses/>.
"""
|UDM| module for |UDM| modules
"""
import apt
from univention.admin.layout import Tab, Group
import univention.admin.filter
import univention.admin.handlers
import univention.admin.password
import univention.admin.syntax
import univention.admin.localization
try:
from univention.admin.syntax import UMCMessageCatalogFilename_and_GNUMessageCatalog
except ImportError:
# workaround for errors during errata-updates. should be removable with UCS 5.0-1
class UMCMessageCatalogFilename(univention.admin.syntax.string):
"""
Syntax for a message catalog filename for UMC module translations`.
Must have a filename like <language code>-<umcmoduleid>`.
"""
@classmethod
def parse(self, text):
text = univention.admin.syntax.string.parse(text)
language_id, dash, module_id = text.partition('-')
if not dash:
raise univention.admin.uexceptions.valueError(_('Not a valid filename for umcmessagecatalog. It must match "$language-$moduleid.mo" (e.g. "de-udm-foo.mo")'))
return text
univention.admin.syntax.UMCMessageCatalogFilename = UMCMessageCatalogFilename
class UMCMessageCatalogFilename_and_GNUMessageCatalog(complex):
"""
Syntax for a message catalog and the corresponding UMCMessageCatalogFilename.
See :py:class:`GNUMessageCatalog` and :py:class:`UMCMessageCatalogFilename`.
"""
delimiter = ': '
subsyntaxes = [('UMCMessageCatalogFilename', univention.admin.syntax.UMCMessageCatalogFilename), ('GNU message catalog', univention.admin.syntax.GNUMessageCatalog)]
subsyntax_key_value = True
all_required = True
multivalue = True
univention.admin.syntax.UMCMessageCatalogFilename_and_GNUMessageCatalog = UMCMessageCatalogFilename_and_GNUMessageCatalog
translation = univention.admin.localization.translation('univention.admin.handlers.settings')
_ = translation.translate
module = 'settings/udm_module'
superordinate = 'settings/cn'
childs = False
operations = ['add', 'edit', 'remove', 'search', 'move']
short_description = _('Settings: UDM Module')
object_name = _('UDM Module')
object_name_plural = _('UDM Modules')
long_description = ''
options = {
'default': univention.admin.option(
short_description=short_description,
default=True,
objectClasses=['top', 'univentionObjectMetadata', 'univentionUDMModule'],
),
}
property_descriptions = {
'name': univention.admin.property(
short_description=_('UDM module name'),
long_description='',
syntax=univention.admin.syntax.string,
include_in_default_search=True,
required=True,
identifies=True
),
'filename': univention.admin.property(
short_description=_('UDM module file name'),
long_description='',
syntax=univention.admin.syntax.string, # relative path, may contain directories
required=True,
default='',
),
'data': univention.admin.property(
short_description=_('UDM module data'),
long_description='UDM module data (syntax: Base64 encoded Bzip2)',
syntax=univention.admin.syntax.Base64Bzip2Text,
required=True,
),
'active': univention.admin.property(
short_description=_('Active'),
long_description='',
syntax=univention.admin.syntax.TrueFalseUp,
default='FALSE',
),
'appidentifier': univention.admin.property(
short_description=_('App identifier'),
long_description='',
syntax=univention.admin.syntax.TextArea,
multivalue=True,
),
'package': univention.admin.property(
short_description=_('Software package'),
long_description='',
syntax=univention.admin.syntax.string,
),
'packageversion': univention.admin.property(
short_description=_('Software package version'),
long_description='',
syntax=univention.admin.syntax.DebianPackageVersion,
),
'ucsversionstart': univention.admin.property(
short_description=_('Minimal UCS version'),
long_description='',
syntax=univention.admin.syntax.UCSVersion,
),
'ucsversionend': univention.admin.property(
short_description=_('Maximal UCS version'),
long_description='',
syntax=univention.admin.syntax.UCSVersion,
),
'messagecatalog': univention.admin.property(
short_description=_('GNU message catalog for translations'),
long_description='GNU message catalog (syntax: <language tag> <Base64 encoded GNU message catalog>)',
syntax=univention.admin.syntax.Localesubdirname_and_GNUMessageCatalog,
multivalue=True,
),
'umcmessagecatalog': univention.admin.property(
short_description=_('GNU message catalog for UMC translations'),
long_description='GNU message catalog (syntax: <UDMModuleID tag> <Base64 encoded GNU message catalog>)',
syntax=univention.admin.syntax.UMCMessageCatalogFilename_and_GNUMessageCatalog,
multivalue=True,
),
'umcregistration': univention.admin.property(
short_description=_('UMC registration data'),
long_description='UMC registration data (syntax: Bzip2 compressed and Base64 encoded XML)',
syntax=univention.admin.syntax.Base64Bzip2XML,
),
'icon': univention.admin.property(
short_description=_('UMC icon'),
long_description='UMC icon (syntax: Base64 encoded jpeg, png or svgz)',
syntax=univention.admin.syntax.Base64UMCIcon,
multivalue=True,
),
}
layout = [
Tab(_('General'), _('Basic values'), layout=[
Group(_('General UDM module settings'), layout=[
["name"],
["filename"],
["data"],
["messagecatalog"],
["umcmessagecatalog"],
["umcregistration"],
["icon"],
]),
Group(_('Metadata'), layout=[
["package"],
["packageversion"],
["appidentifier"],
]),
Group(_('UCS Version Dependencies'), layout=[
["ucsversionstart"],
["ucsversionend"],
]),
Group(_('Activated'), layout=[
["active"],
]),
]),
]
mapping = univention.admin.mapping.mapping()
mapping.register('name', 'cn', None, univention.admin.mapping.ListToString)
mapping.register('filename', 'univentionUDMModuleFilename', None, univention.admin.mapping.ListToString)
mapping.register('data', 'univentionUDMModuleData', univention.admin.mapping.mapBase64, univention.admin.mapping.unmapBase64)
mapping.register('active', 'univentionUDMModuleActive', None, univention.admin.mapping.ListToString)
mapping.register('appidentifier', 'univentionAppIdentifier')
mapping.register('package', 'univentionOwnedByPackage', None, univention.admin.mapping.ListToString)
mapping.register('packageversion', 'univentionOwnedByPackageVersion', None, univention.admin.mapping.ListToString)
mapping.register('ucsversionstart', 'univentionUCSVersionStart', None, univention.admin.mapping.ListToString)
mapping.register('ucsversionend', 'univentionUCSVersionEnd', None, univention.admin.mapping.ListToString)
# messagecatalogs and umcmessagecatalogs are handled via object._post_map and object._post_unmap defined below
mapping.register('icon', 'univentionUMCIcon', univention.admin.mapping.mapBase64, univention.admin.mapping.unmapBase64)
mapping.register('umcregistration', 'univentionUMCRegistrationData', univention.admin.mapping.mapBase64, univention.admin.mapping.unmapBase64)
messagecatalog_mappings = {
'messagecatalog': 'univentionMessageCatalog;entry-lang-',
'umcmessagecatalog': 'univentionUMCMessageCatalog;entry-',
}
[docs]class object(univention.admin.handlers.simpleLdap):
module = module
def _ldap_pre_modify(self):
super(object, self)._ldap_pre_modify()
diff_keys = [key for key in self.info.keys() if self.info.get(key) != self.oldinfo.get(key) and key not in ('active', 'appidentifier')]
if not diff_keys: # check for trivial change
return
if not self.hasChanged('package'):
old_version = self.oldinfo.get('packageversion', '0')
if not apt.apt_pkg.version_compare(self['packageversion'], old_version) > -1:
raise univention.admin.uexceptions.valueInvalidSyntax(_('packageversion: Version must not be lower than the current one.'), property='packageversion')
def _post_unmap(self, info, values):
info['messagecatalog'] = []
info['umcmessagecatalog'] = []
for udm_attr, ldap_attr in messagecatalog_mappings.items():
for ldap_attribute, value_list in values.items():
if ldap_attribute.startswith(ldap_attr):
language_tag = ldap_attribute.split(ldap_attr, 1)[1]
mo_data_base64 = univention.admin.mapping.unmapBase64(value_list)
info[udm_attr].append((language_tag, mo_data_base64))
return info
def _post_map(self, modlist, diff):
for udm_attr, ldap_attr in messagecatalog_mappings.items():
for property_name, old_value, new_value in diff:
if property_name == udm_attr:
old_dict = dict(old_value)
new_dict = dict(new_value)
for tag, old_mo_data_base64 in old_dict.items():
ldap_attribute = ''.join((ldap_attr, tag))
new_mo_data_base64 = new_dict.get(tag)
if not new_mo_data_base64: # property value has been removed
old_mo_data_binary = univention.admin.mapping.mapBase64(old_mo_data_base64)
modlist.append((ldap_attribute, old_mo_data_binary, None))
else:
if new_mo_data_base64 != old_mo_data_base64:
old_mo_data_binary = univention.admin.mapping.mapBase64(old_mo_data_base64)
new_mo_data_binary = univention.admin.mapping.mapBase64(new_mo_data_base64)
modlist.append((ldap_attribute, old_mo_data_binary, new_mo_data_binary))
for tag, new_mo_data_base64 in new_dict.items():
ldap_attribute = ''.join((ldap_attr, tag))
if not old_dict.get(tag): # property value has been added
new_mo_data_binary = univention.admin.mapping.mapBase64(new_mo_data_base64)
modlist.append((ldap_attribute, None, new_mo_data_binary))
break
return modlist
lookup = object.lookup
lookup_filter = object.lookup_filter
identify = object.identify
