Documentation

Documentation is graciously hosted at https://django-serverless-cron.readthedocs.io.

Contributions

Feel free to make pull requests and submit issues/requests. Find more detailed instructions under the contributing section.

Alternatively, you can leave a star on the repo to show your support. 🙂

Quickstart

Installation ^^^^^^^^^^^^

Install Django Serverless Cron::

pip install django-serverless-cron

Settings ^^^^^^^^

Add it to your INSTALLED_APPS:

.. code-block:: python

INSTALLED_APPS = (
    # ...
    'django_serverless_cron'
    # ...
)

Add jobs to your settings file:

.. code-block:: python

SERVERLESS_CRONJOBS = [
    # (
    #   '1_hours',                       # frequency (seconds, minutes, hours, days, weeks) -> in this case, every one hour
    #   'mail.jobs.send_mail_function',  # path to task/function functions -> in this case, send_mail_function()
    #   {'kwarg1': 'foo'}                # kwargs passed to the function
    # ),
    (
        '1_days',
        'your_app.services.your_job_function',
        {'kwarg1': 'foo', 'kwarg2': 'bar', "is_bulk": True}
    ),
    (
        '1_hours',
        'mail.jobs.send_mail_function',
        {}                               # job without kwargs
    ),
]

URL patterns ^^^^^^^^^^^^ Add the jobs to your URL patterns:

.. code-block:: python

from django.urls import path, re_path, include #add re_path and include
from django_serverless_cron import urls as django_serverless_cron_urls


urlpatterns = [
    # ...
    re_path(r'^', include(django_serverless_cron_urls)),
    #...
]

Migrate ^^^^^^^

.. code-block:: bash

python manage.py migrate

Running Jobs

In Development ^^^^^^^^^^^^^^

Running Jobs through HTTP requests """"""""""""""""""""""""""""""""""

Call the /run path to run all jobs:

Example:

.. code-block:: bash

curl http://localhost:8000/run

or

.. code-block:: python

import requests

x = requests.get('http://localhost:8000/run')

Running Jobs through the management command """""""""""""""""""""""""""""""""""""""""""

This will run the jobs every 30 seconds:

.. code-block:: bash

python manage.py serverless_cron_run

You can alternatively add the --single_run='True' option to run the jobs just once.

In Production ^^^^^^^^^^^^^

Similar to in development, we can call the /run path via fully managed services which are usually ridiculously cheap. Examples:

• https://cloud.google.com/scheduler -> Great feature set, easy to use, reasonable free tier & very cheap.
• https://aws.amazon.com/eventbridge
• https://azure.microsoft.com/en-gb/services/logic-apps formerly https://docs.microsoft.com/en-us/azure/scheduler/scheduler-intro
• https://cron-job.org/en/ -> Absolutely free and open-source: https://github.com/pschlan/cron-job.org
• https://www.easycron.com
• https://cronhub.io
• https://cronless.com -> Has 30 Second Cron Jobs
• https://github.com/features/actions; https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#onschedule -> eg making a HTTP request using curl in a step
• https://www.cronjob.de
• https://zeplo.io
• https://catalyst.zoho.com/help/cron.html
• https://www.cronjobservices.com

Related media

For more learning check out:

• https://dev.to/googlecloud/when-you-re-not-around-trigger-cloud-run-on-a-schedule-53p4 | https://youtu.be/XIwbIimM49Y
• https://aws.amazon.com/blogs/compute/using-api-destinations-with-amazon-eventbridge/
• https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/RunLambdaSchedule.html
• https://www.ibm.com/cloud/blog/how-to-schedule-rest-api-calls-on-ibm-cloud
• https://vercel.com/docs/concepts/solutions/cron-jobs
• cron-like recurring task scheduler design https://stackoverflow.com/a/3980935/10904662
• https://www.dailyhostnews.com/google-cloud-launches-fully-managed-cron-job-scheduler-for-enterprises
• Cloud Scheduler from Fireship https://www.youtube.com/watch?v=WUPEUjvSBW8

Credits

Tools used in rendering this package:

• Cookiecutter_
• cookiecutter-djangopackage_

.. _Cookiecutter: https://github.com/audreyr/cookiecutter .. _cookiecutter-djangopackage: https://github.com/pydanny/cookiecutter-djangopackage