django-tasks-scheduler 1.0.0__tar.gz

django_tasks_scheduler-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022- Daniel Moran, (Before 2016 - iStrategyLabs, LLC)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NON INFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

django_tasks_scheduler-1.0.0/PKG-INFO

@@ -0,0 +1,57 @@
+Metadata-Version: 2.1
+Name: django-tasks-scheduler
+Version: 1.0.0
+Summary: An async job scheduler for django using redis
+Home-page: https://github.com/dsoftwareinc/django-redis-scheduler
+License: MIT
+Keywords: redis,django,background-jobs,job-queue,task-queue,redis-queue,scheduled-jobs
+Author: Daniel Moran
+Author-email: daniel@moransoftware.ca
+Maintainer: Daniel Moran
+Maintainer-email: daniel@moransoftware.ca
+Requires-Python: >=3.9,<4.0
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 3
+Classifier: Framework :: Django :: 3.2
+Classifier: Framework :: Django :: 4
+Classifier: Framework :: Django :: 4.0
+Classifier: Framework :: Django :: 4.1
+Classifier: Framework :: Django :: 4.2
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Provides-Extra: yaml
+Requires-Dist: click (>=8.1,<9.0)
+Requires-Dist: croniter (>=1.4,<2.0)
+Requires-Dist: django (>=3.2)
+Requires-Dist: pyyaml (>=6.0,<7.0) ; extra == "yaml"
+Requires-Dist: rq (>=1.15,<2.0)
+Project-URL: Bug Tracker, https://github.com/dsoftwareinc/django-tasks-scheduler/issues
+Project-URL: Documentation, https://django-tasks-scheduler.readthedocs.io/en/latest/
+Project-URL: Funding, https://github.com/sponsors/cunla
+Description-Content-Type: text/markdown
+
+Django Tasks Scheduler
+===================
+[![Django CI](https://github.com/dsoftwareinc/django-tasks-scheduler/actions/workflows/test.yml/badge.svg)](https://github.com/dsoftwareinc/django-tasks-scheduler/actions/workflows/test.yml)
+![badge](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/cunla/b756396efb895f0e34558c980f1ca0c7/raw/django-tasks-scheduler-4.json)
+[![badge](https://img.shields.io/pypi/dm/django-tasks-scheduler)](https://pypi.org/project/django-tasks-scheduler/)
+[![Open Source Helpers](https://www.codetriage.com/dsoftwareinc/django-tasks-scheduler/badges/users.svg)](https://www.codetriage.com/dsoftwareinc/django-tasks-scheduler)
+
+Documentation can be found in https://django-tasks-scheduler.readthedocs.io/en/latest/
+
+# Sponsor
+
+django-tasks-scheduler is developed for free.
+
+You can support this project by becoming a sponsor using [this link](https://github.com/sponsors/cunla).
+
+
+

django_tasks_scheduler-1.0.0/README.md

@@ -0,0 +1,16 @@
+Django Tasks Scheduler
+===================
+[![Django CI](https://github.com/dsoftwareinc/django-tasks-scheduler/actions/workflows/test.yml/badge.svg)](https://github.com/dsoftwareinc/django-tasks-scheduler/actions/workflows/test.yml)
+![badge](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/cunla/b756396efb895f0e34558c980f1ca0c7/raw/django-tasks-scheduler-4.json)
+[![badge](https://img.shields.io/pypi/dm/django-tasks-scheduler)](https://pypi.org/project/django-tasks-scheduler/)
+[![Open Source Helpers](https://www.codetriage.com/dsoftwareinc/django-tasks-scheduler/badges/users.svg)](https://www.codetriage.com/dsoftwareinc/django-tasks-scheduler)
+
+Documentation can be found in https://django-tasks-scheduler.readthedocs.io/en/latest/
+
+# Sponsor
+
+django-tasks-scheduler is developed for free.
+
+You can support this project by becoming a sponsor using [this link](https://github.com/sponsors/cunla).
+
+

django_tasks_scheduler-1.0.0/pyproject.toml

@@ -0,0 +1,67 @@
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.poetry]
+name = "django-tasks-scheduler"
+packages = [
+    { include = "scheduler" },
+]
+version = "1.0.0"
+description = "An async job scheduler for django using redis"
+readme = "README.md"
+keywords = ["redis", "django", "background-jobs", "job-queue", "task-queue", "redis-queue", "scheduled-jobs"]
+authors = [
+    "Daniel Moran <daniel@moransoftware.ca>",
+]
+maintainers = [
+    "Daniel Moran <daniel@moransoftware.ca>",
+]
+license = "MIT"
+classifiers = [
+    'Development Status :: 5 - Production/Stable',
+    'Environment :: Web Environment',
+    'Intended Audience :: Developers',
+    'License :: OSI Approved :: MIT License',
+    'Operating System :: OS Independent',
+    'Programming Language :: Python',
+    'Programming Language :: Python :: 3.9',
+    'Programming Language :: Python :: 3.10',
+    'Programming Language :: Python :: 3.11',
+    'Framework :: Django',
+    'Framework :: Django :: 4',
+    'Framework :: Django :: 4.0',
+    'Framework :: Django :: 4.1',
+    'Framework :: Django :: 4.2',
+    'Framework :: Django :: 3',
+    'Framework :: Django :: 3.2',
+]
+homepage = "https://github.com/dsoftwareinc/django-redis-scheduler"
+documentation = "https://django-tasks-scheduler.readthedocs.io/en/latest/"
+
+[tool.poetry.urls]
+"Bug Tracker" = "https://github.com/dsoftwareinc/django-tasks-scheduler/issues"
+"Funding" = "https://github.com/sponsors/cunla"
+
+[tool.poetry.dependencies]
+python = "^3.9"
+django = ">=3.2"
+croniter = "^1.4"
+click = "^8.1"
+rq = "^1.15"
+pyyaml = { version = "^6.0", optional = true }
+
+[tool.poetry.dev-dependencies]
+poetry = "^1.5"
+coverage = "^7"
+fakeredis = { version = "^2.15", extras = ['lua'] }
+Flake8-pyproject = "^1.2"
+
+[tool.poetry.extras]
+yaml = ["pyyaml"]
+
+[tool.flake8]
+max-line-length = 119
+exclude = [
+    'scheduler/migrations',
+]

django_tasks_scheduler-1.0.0/scheduler/__init__.py

@@ -0,0 +1,5 @@
+import importlib.metadata
+
+__version__ = importlib.metadata.version('django-tasks-scheduler')
+
+from .decorators import job  # noqa: F401

django_tasks_scheduler-1.0.0/scheduler/admin/__init__.py

@@ -0,0 +1,2 @@
+from .job import JobAdmin  # noqa: F401
+from .redis_models import QueueAdmin, WorkerAdmin  # noqa: F401

django_tasks_scheduler-1.0.0/scheduler/admin/job.py

@@ -0,0 +1,146 @@
+import redis
+from django.contrib import admin, messages
+from django.contrib.contenttypes.admin import GenericStackedInline
+from django.utils.translation import gettext_lazy as _
+
+from scheduler import tools
+from scheduler.models import CronJob, JobArg, JobKwarg, RepeatableJob, ScheduledJob
+from scheduler.settings import SCHEDULER_CONFIG, logger
+from scheduler.tools import get_job_executions
+
+
+class HiddenMixin(object):
+    class Media:
+        js = ['admin/js/jquery.init.js', ]
+
+
+class JobArgInline(HiddenMixin, GenericStackedInline):
+    model = JobArg
+    extra = 0
+    fieldsets = (
+        (None, {
+            'fields': (('arg_type', 'val',),),
+        }),
+    )
+
+
+class JobKwargInline(HiddenMixin, GenericStackedInline):
+    model = JobKwarg
+    extra = 0
+    fieldsets = (
+        (None, {
+            'fields': (('key',), ('arg_type', 'val',),),
+        }),
+    )
+
+
+@admin.register(CronJob, ScheduledJob, RepeatableJob)
+class JobAdmin(admin.ModelAdmin):
+    LIST_DISPLAY_EXTRA = dict(
+        CronJob=('cron_string', 'next_run',),
+        ScheduledJob=('scheduled_time',),
+        RepeatableJob=('scheduled_time', 'interval_display'),
+    )
+    FIELDSET_EXTRA = dict(
+        CronJob=('cron_string', 'repeat', 'timeout', 'result_ttl',),
+        ScheduledJob=('scheduled_time', 'timeout', 'result_ttl'),
+        RepeatableJob=('scheduled_time', ('interval', 'interval_unit',), 'repeat', 'timeout', 'result_ttl',),
+    )
+    """BaseJob admin class"""
+    save_on_top = True
+    change_form_template = 'admin/scheduler/change_form.html'
+    actions = ['disable_selected', 'enable_selected', 'enqueue_job_now', ]
+    inlines = [JobArgInline, JobKwargInline, ]
+    list_filter = ('enabled',)
+    list_display = ('enabled', 'name', 'job_id', 'function_string', 'is_scheduled', 'queue',)
+    list_display_links = ('name',)
+    readonly_fields = ('job_id',)
+    fieldsets = (
+        (None, {
+            'fields': ('name', 'callable', 'enabled', 'at_front',),
+        }),
+        (_('RQ Settings'), {
+            'fields': ('queue', 'job_id',),
+        }),
+    )
+
+    def get_list_display(self, request):
+        if self.model.__name__ not in JobAdmin.LIST_DISPLAY_EXTRA:
+            raise ValueError(f'Unrecognized model {self.model}')
+        return JobAdmin.list_display + JobAdmin.LIST_DISPLAY_EXTRA[self.model.__name__]
+
+    def get_fieldsets(self, request, obj=None):
+        if self.model.__name__ not in JobAdmin.FIELDSET_EXTRA:
+            raise ValueError(f'Unrecognized model {self.model}')
+        return JobAdmin.fieldsets + ((_('Scheduling'), {
+            'fields': JobAdmin.FIELDSET_EXTRA[self.model.__name__],
+        }),)
+
+    @admin.display(description='Next run')
+    def next_run(self, o: CronJob):
+        return tools.get_next_cron_time(o.cron_string)
+
+    def change_view(self, request, object_id, form_url='', extra_context=None):
+        extra = extra_context or {}
+        obj = self.get_object(request, object_id)
+        try:
+            execution_list = get_job_executions(obj.queue, obj)
+        except redis.ConnectionError as e:
+            logger.warn(f'Could not get job executions: {e}')
+            execution_list = list()
+        paginator = self.get_paginator(request, execution_list, SCHEDULER_CONFIG['EXECUTIONS_IN_PAGE'])
+        page_number = request.GET.get('p', 1)
+        page_obj = paginator.get_page(page_number)
+        page_range = paginator.get_elided_page_range(page_obj.number)
+
+        extra.update({
+            "pagination_required": paginator.count > SCHEDULER_CONFIG['EXECUTIONS_IN_PAGE'],
+            'executions': page_obj,
+            'page_range': page_range,
+            'page_var': 'p',
+        })
+
+        return super(JobAdmin, self).change_view(
+            request, object_id, form_url, extra_context=extra)
+
+    def delete_queryset(self, request, queryset):
+        for job in queryset:
+            job.unschedule()
+        super(JobAdmin, self).delete_queryset(request, queryset)
+
+    def delete_model(self, request, obj):
+        obj.unschedule()
+        super(JobAdmin, self).delete_model(request, obj)
+
+    @admin.action(description=_("Disable selected %(verbose_name_plural)s"), permissions=('change',))
+    def disable_selected(self, request, queryset):
+        rows_updated = 0
+        for obj in queryset.filter(enabled=True).iterator():
+            obj.enabled = False
+            obj.unschedule()
+            rows_updated += 1
+
+        message_bit = "1 job was" if rows_updated == 1 else f"{rows_updated} jobs were"
+
+        level = messages.WARNING if not rows_updated else messages.INFO
+        self.message_user(request, f"{message_bit} successfully disabled and unscheduled.", level=level)
+
+    @admin.action(description=_("Enable selected %(verbose_name_plural)s"), permissions=('change',))
+    def enable_selected(self, request, queryset):
+        rows_updated = 0
+        for obj in queryset.filter(enabled=False).iterator():
+            obj.enabled = True
+            obj.save()
+            rows_updated += 1
+
+        message_bit = "1 job was" if rows_updated == 1 else f"{rows_updated} jobs were"
+        level = messages.WARNING if not rows_updated else messages.INFO
+        self.message_user(request, f"{message_bit} successfully enabled and scheduled.", level=level)
+
+    @admin.action(description="Enqueue now", permissions=('change',))
+    def enqueue_job_now(self, request, queryset):
+        job_names = []
+        for job in queryset:
+            job.enqueue_to_run()
+            job_names.append(job.name)
+        self.message_user(request, f"The following jobs have been enqueued: {', '.join(job_names)}", )

django_tasks_scheduler-1.0.0/scheduler/admin/redis_models.py

@@ -0,0 +1,44 @@
+from django.contrib import admin
+
+from scheduler import views
+from scheduler.models import Queue
+from scheduler.models.worker import Worker
+
+
+class ImmutableAdmin(admin.ModelAdmin):
+    def has_add_permission(self, request):
+        return False  # Hide the admin "+ Add" link for Queues
+
+    def has_change_permission(self, request, obj=None):
+        return True
+
+    def has_module_permission(self, request):
+        """
+        return True if the given request has any permission in the given
+        app label.
+
+        Can be overridden by the user in subclasses. In such case it should
+        return True if the given request has permission to view the module on
+        the admin index page and access the module's index page. Overriding it
+        does not restrict access to the add, change or delete views. Use
+        `ModelAdmin.has_(add|change|delete)_permission` for that.
+        """
+        return request.user.has_module_perms('django-tasks-scheduler')
+
+
+@admin.register(Queue)
+class QueueAdmin(ImmutableAdmin):
+    """Admin View for queues"""
+
+    def changelist_view(self, request, extra_context=None):
+        """The 'change list' admin view for this model."""
+        return views.stats(request)
+
+
+@admin.register(Worker)
+class WorkerAdmin(ImmutableAdmin):
+    """Admin View for workers"""
+
+    def changelist_view(self, request, extra_context=None):
+        """The 'change list' admin view for this model."""
+        return views.workers(request)

django_tasks_scheduler-1.0.0/scheduler/apps.py

@@ -0,0 +1,11 @@
+from django.apps import AppConfig
+from django.utils.translation import gettext_lazy as _
+
+
+class SchedulerConfig(AppConfig):
+    default_auto_field = 'django.db.models.AutoField'
+    name = 'scheduler'
+    verbose_name = _('Tasks Scheduler')
+
+    def ready(self):
+        pass

django_tasks_scheduler-1.0.0/scheduler/decorators.py

@@ -0,0 +1,43 @@
+from scheduler import settings
+from .queues import get_queue, QueueNotFoundError
+from .rq_classes import rq_job_decorator
+
+
+def job(*args, **kwargs):
+    """
+    The same as rq package's job decorator, but it automatically works out
+    the ``connection`` argument from SCHEDULER_QUEUES.
+
+    And also, it allows simplified ``@job`` syntax to put job into
+    default queue.
+
+    """
+    if len(args) == 0:
+        func = None
+        queue = 'default'
+    else:
+        if callable(args[0]):
+            func = args[0]
+            queue = 'default'
+        else:
+            func = None
+            queue = args[0]
+        args = args[1:]
+
+    if isinstance(queue, str):
+        try:
+            queue = get_queue(queue)
+            if 'connection' not in kwargs:
+                kwargs['connection'] = queue.connection
+        except KeyError:
+            raise QueueNotFoundError(f'Queue {queue} does not exist')
+
+    config = settings.SCHEDULER_CONFIG
+
+    kwargs.setdefault('result_ttl', config.get('DEFAULT_RESULT_TTL'))
+    kwargs.setdefault('timeout', config.get('DEFAULT_TIMEOUT'))
+
+    decorator = rq_job_decorator(queue, *args, **kwargs)
+    if func:
+        return decorator(func)
+    return decorator

django_tasks_scheduler-1.0.0/scheduler/management/commands/delete_failed_executions.py

@@ -0,0 +1,31 @@
+import click
+from django.core.management.base import BaseCommand
+
+from scheduler.queues import get_queue
+from scheduler.rq_classes import JobExecution
+
+
+class Command(BaseCommand):
+    help = 'Delete failed jobs from Django queue.'
+
+    def add_arguments(self, parser):
+        parser.add_argument(
+            '--queue', '-q', dest='queue', default='default',
+            help='Specify the queue [default]')
+        parser.add_argument('-f', '--func', help='optional job function name, e.g. "app.tasks.func"')
+        parser.add_argument('--dry-run', action='store_true', help='Do not actually delete failed jobs')
+
+    def handle(self, *args, **options):
+        queue = get_queue(options.get('queue', 'default'))
+        job_ids = queue.failed_job_registry.get_job_ids()
+        jobs = [JobExecution.fetch(job_id, connection=queue.connection) for job_id in job_ids]
+        func_name = options.get('func', None)
+        if func_name is not None:
+            jobs = [job for job in jobs if job.func_name == func_name]
+        dry_run = options.get('dry_run', False)
+        click.echo(f'Found {len(jobs)} failed jobs')
+        for job in jobs:
+            click.echo(f'Deleting {job.id}')
+            if not dry_run:
+                job.delete()
+        click.echo(f'Deleted {len(jobs)} failed jobs')

django_tasks_scheduler-1.0.0/scheduler/management/commands/export.py

@@ -0,0 +1,64 @@
+import sys
+
+import click
+from django.apps import apps
+from django.core.management.base import BaseCommand
+
+from scheduler.tools import MODEL_NAMES
+
+
+class Command(BaseCommand):
+    """
+    Export all scheduled jobs
+    """
+    help = __doc__
+
+    def add_arguments(self, parser):
+        parser.add_argument(
+            '-o', '--output',
+            action='store',
+            choices=['json', 'yaml'],
+            default='json',
+            dest='format',
+            help='format of output',
+        )
+
+        parser.add_argument(
+            '-e', '--enabled',
+            action='store_true',
+            dest='enabled',
+            help='Export only enabled jobs',
+        )
+        parser.add_argument(
+            '-f', '--filename',
+            action='store',
+            dest='filename',
+            help='File name to load (otherwise writes to standard output)',
+        )
+
+    def handle(self, *args, **options):
+        file = open(options.get('filename'), 'w') if options.get("filename") else sys.stdout
+        res = list()
+        for model_name in MODEL_NAMES:
+            model = apps.get_model(app_label='scheduler', model_name=model_name)
+            jobs = model.objects.all()
+            if options.get('enabled'):
+                jobs = jobs.filter(enabled=True)
+            for job in jobs:
+                res.append(job.to_dict())
+
+        if options.get("format") == 'json':
+            import json
+            click.echo(json.dumps(res, indent=2), file=file)
+            return
+
+        if options.get("format") == 'yaml':
+            try:
+                import yaml
+            except ImportError:
+                click.echo("Aborting. LibYAML is not installed.")
+                exit(1)
+            # Disable YAML alias
+            yaml.Dumper.ignore_aliases = lambda *x: True
+            click.echo(yaml.dump(res, default_flow_style=False), file=file)
+            return

django_tasks_scheduler-1.0.0/scheduler/management/commands/import.py

@@ -0,0 +1,109 @@
+import sys
+
+import click
+from django.apps import apps
+from django.conf import settings
+from django.contrib.contenttypes.models import ContentType
+from django.core.management.base import BaseCommand
+from django.utils import timezone
+
+from scheduler.models import JobArg, JobKwarg
+from scheduler.tools import MODEL_NAMES
+
+
+def create_job_from_dict(job_dict, update):
+    model = apps.get_model(app_label='scheduler', model_name=job_dict['model'])
+    existing_job = model.objects.filter(name=job_dict['name']).first()
+    if existing_job:
+        if update:
+            click.echo(f'Found existing job "{existing_job}, removing it to be reinserted"')
+            existing_job.delete()
+        else:
+            click.echo(f'Found existing job "{existing_job}", skipping')
+            return
+    kwargs = dict(job_dict)
+    del kwargs['model']
+    del kwargs['callable_args']
+    del kwargs['callable_kwargs']
+    if kwargs.get('scheduled_time', None):
+        kwargs['scheduled_time'] = timezone.datetime.fromisoformat(kwargs['scheduled_time'])
+        if not settings.USE_TZ:
+            kwargs['scheduled_time'] = timezone.make_naive(kwargs['scheduled_time'])
+    model_fields = set(map(lambda field: field.attname, model._meta.get_fields()))
+    keys_to_ignore = list(filter(lambda k: k not in model_fields, kwargs.keys()))
+    for k in keys_to_ignore:
+        del kwargs[k]
+    scheduled_job = model.objects.create(**kwargs)
+    click.echo(f'Created job {scheduled_job}')
+    content_type = ContentType.objects.get_for_model(scheduled_job)
+
+    for arg in job_dict['callable_args']:
+        JobArg.objects.create(
+            content_type=content_type, object_id=scheduled_job.id, **arg, )
+    for arg in job_dict['callable_kwargs']:
+        JobKwarg.objects.create(
+            content_type=content_type, object_id=scheduled_job.id, **arg, )
+
+
+class Command(BaseCommand):
+    """
+    Import scheduled jobs
+    """
+    help = __doc__
+
+    def add_arguments(self, parser):
+        parser.add_argument(
+            '-f', '--format',
+            action='store',
+            choices=['json', 'yaml'],
+            default='json',
+            dest='format',
+            help='format of input',
+        )
+        parser.add_argument(
+            '--filename',
+            action='store',
+            dest='filename',
+            help='File name to load (otherwise loads from standard input)',
+        )
+
+        parser.add_argument(
+            '-r', '--reset',
+            action='store_true',
+            dest='reset',
+            help='Remove all currently scheduled jobs before importing',
+        )
+        parser.add_argument(
+            '-u', '--update',
+            action='store_true',
+            dest='update',
+            help='Update existing records',
+        )
+
+    def handle(self, *args, **options):
+        file = open(options.get('filename')) if options.get("filename") else sys.stdin
+        jobs = list()
+        if options.get("format") == 'json':
+            import json
+            try:
+                jobs = json.load(file)
+            except json.decoder.JSONDecodeError:
+                click.echo('Error decoding json', err=True)
+                exit(1)
+        elif options.get("format") == 'yaml':
+            try:
+                import yaml
+            except ImportError:
+                click.echo("Aborting. LibYAML is not installed.")
+                exit(1)
+            # Disable YAML alias
+            yaml.Dumper.ignore_aliases = lambda *x: True
+            jobs = yaml.load(file, yaml.SafeLoader)
+
+        if options.get('reset'):
+            for model_name in MODEL_NAMES:
+                model = apps.get_model(app_label='scheduler', model_name=model_name)
+                model.objects.all().delete()
+
+        for job in jobs:
+            create_job_from_dict(job, update=options.get('update'))