mirror of https://github.com/jumpserver/jumpserver
				
				
				
			
		
			
				
	
	
		
			141 lines
		
	
	
		
			4.4 KiB
		
	
	
	
		
			Python
		
	
	
			
		
		
	
	
			141 lines
		
	
	
		
			4.4 KiB
		
	
	
	
		
			Python
		
	
	
# -*- 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 perform"))
 | 
						|
    interval = models.IntegerField(
 | 
						|
        default=24, null=True, blank=True,
 | 
						|
        verbose_name=_("Cycle perform"),
 | 
						|
    )
 | 
						|
    crontab = models.CharField(
 | 
						|
        null=True, blank=True, max_length=128,
 | 
						|
        verbose_name=_("Regularly perform"),
 | 
						|
    )
 | 
						|
 | 
						|
    @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 _('Regularly perform') + " ( {} )".format(self.crontab)
 | 
						|
        if self.is_periodic and self.interval:
 | 
						|
            return _('Cycle perform') + " ( {} 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 perform"))
 | 
						|
    crontab = serializers.CharField(
 | 
						|
        max_length=128, allow_blank=True,
 | 
						|
        allow_null=True, required=False, label=_('Regularly perform')
 | 
						|
    )
 | 
						|
    interval = serializers.IntegerField(
 | 
						|
        default=24, allow_null=True, required=False, label=_('Interval')
 | 
						|
    )
 | 
						|
 | 
						|
    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 periodic or regularly perform setting")
 | 
						|
            raise serializers.ValidationError(msg)
 | 
						|
        return ok
 |