# SPDX-FileCopyrightText: 2004-2025 Univention GmbH
# SPDX-License-Identifier: AGPL-3.0-only
"""|UDM| module for the repository sync policies"""
import univention.admin.cron
import univention.admin.handlers
import univention.admin.localization
import univention.admin.syntax
from univention.admin.layout import Group, Tab
from univention.admin.policy import (
emptyAttributesProperty, fixedAttributesProperty, ldapFilterProperty, policy_object_tab,
prohibitedObjectClassesProperty, register_policy_mapping, requiredObjectClassesProperty,
)
translation = univention.admin.localization.translation('univention.admin.handlers.policies')
_ = translation.translate
[docs]
class repositorySyncFixedAttributes(univention.admin.syntax.select):
name = 'repositorySyncFixedAttributes'
choices = [
('univentionRepositoryCron', _('Repository synchronisation')),
]
module = 'policies/repositorysync'
operations = ['add', 'edit', 'remove', 'search']
policy_oc = 'univentionPolicyRepositorySync'
policy_apply_to = ['computers/domaincontroller_master', 'computers/domaincontroller_backup', 'computers/domaincontroller_slave', 'computers/memberserver']
policy_position_dn_prefix = 'cn=repository,cn=update'
childs = False
short_description = _('Policy: Repository synchronisation')
object_name = _('Repository synchronisation policy')
object_name_plural = _('Repository synchronisation policies')
policy_short_description = _('Repository synchronisation')
long_description = ''
# fmt: off
options = {
'default': univention.admin.option(
short_description=short_description,
default=True,
objectClasses=['top', 'univentionPolicy', 'univentionPolicyRepositorySync'],
),
}
property_descriptions = dict({
'name': univention.admin.property(
short_description=_('Name'),
long_description='',
syntax=univention.admin.syntax.policyName,
include_in_default_search=True,
required=True,
may_change=False,
identifies=True,
),
'month': univention.admin.property(
short_description=_('Month'),
long_description='',
syntax=univention.admin.syntax.Month,
multivalue=True,
),
'day': univention.admin.property(
short_description=_('Day'),
long_description='',
syntax=univention.admin.syntax.Day,
multivalue=True,
),
'weekday': univention.admin.property(
short_description=_('Day of week'),
long_description='',
syntax=univention.admin.syntax.Weekday,
multivalue=True,
),
'hour': univention.admin.property(
short_description=_('Hour'),
long_description='',
syntax=univention.admin.syntax.Hour,
multivalue=True,
),
'minute': univention.admin.property(
short_description=_('Minute'),
long_description='',
syntax=univention.admin.syntax.Minute,
multivalue=True,
),
}, **dict([
requiredObjectClassesProperty(),
prohibitedObjectClassesProperty(),
fixedAttributesProperty(syntax=repositorySyncFixedAttributes),
emptyAttributesProperty(syntax=repositorySyncFixedAttributes),
ldapFilterProperty(),
]))
layout = [
Tab(_('General'), _('Repository synchronisation settings'), layout=[
Group(_('General repository synchronisation settings'), layout=[
'name',
['month', 'weekday'],
['day', 'hour'],
'minute',
]),
]),
policy_object_tab(),
]
mapping = univention.admin.mapping.mapping()
mapping.register('name', 'cn', None, univention.admin.mapping.ListToString)
register_policy_mapping(mapping)
# fmt: on
[docs]
class object(univention.admin.handlers.simplePolicy):
module = module
def __init__(self, co, lo, position, dn='', superordinate=None, attributes=[]):
univention.admin.handlers.simplePolicy.__init__(self, co, lo, position, dn, superordinate, attributes)
self.cron_parsed = 0
oldcron = self.oldattr.get('univentionRepositoryCron', [b''])[0].decode('ASCII')
if oldcron:
self.parse_cron(oldcron)
self.cron_parsed = 1
self.save()
self.changes = 0
[docs]
def parse_cron(self, cronstring):
# don't use self[key] inside here - it will be recursive call(ed by) __getitem__
self.log.debug('parse cron', value=cronstring)
cron = univention.admin.cron.cron_split(cronstring)
keys = ['minute', 'hour', 'day', 'month', 'weekday']
for key in keys:
if key in cron:
self[key] = []
for value in cron[key]:
if value != '*':
univention.admin.handlers.simplePolicy.__getitem__(self, key).append(value)
def __getitem__(self, key):
value = univention.admin.handlers.simplePolicy.__getitem__(self, key) # need this first to initialize policy-results
# set cron if we are in resultmode
if self.resultmode and hasattr(self, 'policy_attrs') and 'univentionRepositoryCron' in self.policy_attrs and (not self.cron_parsed):
self.parse_cron(self.policy_attrs['univentionRepositoryCron']['value'][0])
if not self.cron_parsed:
self.save()
self.changes = 0
self.cron_parsed = 1
value = univention.admin.handlers.simplePolicy.__getitem__(self, key) # need to reload
return value
def _ldap_modlist(self):
ml = univention.admin.handlers.simplePolicy._ldap_modlist(self)
if self.hasChanged(['minute', 'hour', 'day', 'month', 'weekday']):
cron = {}
if self.has_property('minute'):
cron['minute'] = self['minute']
if self.has_property('hour'):
cron['hour'] = self['hour']
if self.has_property('day'):
cron['day'] = self['day']
if self.has_property('month'):
cron['month'] = self['month']
if self.has_property('weekday'):
cron['weekday'] = self['weekday']
cron = univention.admin.cron.cron_create(cron)
ml.append(('univentionRepositoryCron', self.oldattr.get('univentionRepositoryCron', []), [cron.encode('ASCII')]))
return ml
lookup = object.lookup
lookup_filter = object.lookup_filter
identify = object.identify