# -*- coding: utf-8 -*- # import abc from django.db import models from django.utils.translation import gettext_lazy as _ from rest_framework import serializers from .celery.utils import ( create_or_update_celery_periodic_tasks, disable_celery_periodic_task, delete_celery_periodic_task, ) __all__ = [ 'PeriodTaskModelMixin', 'PeriodTaskSerializerMixin', ] class PeriodTaskModelMixin(models.Model): name = models.CharField( max_length=128, unique=False, verbose_name=_("Name") ) is_periodic = models.BooleanField(default=False, verbose_name=_("Periodic run")) interval = models.IntegerField( default=24, null=True, blank=True, verbose_name=_("Interval"), ) crontab = models.CharField( blank=True, max_length=128, null=True, verbose_name=_("Crontab"), ) @abc.abstractmethod def get_register_task(self): period_name, task, args, kwargs = None, None, (), {} return period_name, task, args, kwargs @property def interval_ratio(self): return 3600, 'h' @property def interval_display(self): unit = self.interval_ratio[1] if not self.interval: return '' return '{} {}'.format(self.interval, unit) def set_period_schedule(self): name, task, args, kwargs = self.get_register_task() is_active = self.is_active if hasattr(self, 'is_active') else True if not self.is_periodic or not is_active: disable_celery_periodic_task(name) return crontab = interval = None if self.crontab: crontab = self.crontab elif self.interval: interval = self.interval * self.interval_ratio[0] tasks = { name: { 'task': task, 'interval': interval, 'crontab': crontab, 'args': args, 'kwargs': kwargs, 'enabled': True, } } create_or_update_celery_periodic_tasks(tasks) def save(self, *args, **kwargs): instance = super().save(**kwargs) self.set_period_schedule() return instance def delete(self, using=None, keep_parents=False): name = self.get_register_task()[0] instance = super().delete(using=using, keep_parents=keep_parents) delete_celery_periodic_task(name) return instance @property def periodic_display(self): if self.is_periodic and self.crontab: return _('Crontab') + " ( {} )".format(self.crontab) if self.is_periodic and self.interval: return _('Interval') + " ( {} h )".format(self.interval) return '-' @property def schedule(self): from django_celery_beat.models import PeriodicTask name = self.get_register_task()[0] return PeriodicTask.objects.filter(name=name).first() class Meta: abstract = True class PeriodTaskSerializerMixin(serializers.Serializer): is_periodic = serializers.BooleanField(default=True, label=_("Periodic run")) crontab = serializers.CharField( max_length=128, allow_blank=True, allow_null=True, required=False, label=_('Crontab') ) interval = serializers.IntegerField( default=24, allow_null=True, required=False, label=_('Interval') ) periodic_display = serializers.CharField(read_only=True, label=_('Run period')) INTERVAL_MAX = 65535 INTERVAL_MIN = 1 def validate_crontab(self, crontab): if not crontab: return crontab if isinstance(crontab, str) and len(crontab.strip().split()) != 5: msg = _('* Please enter a valid crontab expression') raise serializers.ValidationError(msg) return crontab def validate_interval(self, interval): if not interval and not isinstance(interval, int): return interval msg = _("Range {} to {}").format(self.INTERVAL_MIN, self.INTERVAL_MAX) if interval > self.INTERVAL_MAX or interval < self.INTERVAL_MIN: raise serializers.ValidationError(msg) return interval def validate_is_periodic(self, ok): if not ok: return ok crontab = self.initial_data.get('crontab') interval = self.initial_data.get('interval') if ok and not any([crontab, interval]): msg = _("Require interval or crontab setting") raise serializers.ValidationError(msg) return ok def validate(self, attrs): attrs = super().validate(attrs) if not attrs.get('is_periodic'): attrs['interval'] = None attrs['crontab'] = '' if attrs.get('crontab'): attrs['interval'] = None return attrs