https://github.com/uptick/bronski
https://github.com/uptick/bronski
Last synced: 11 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/uptick/bronski
- Owner: uptick
- Created: 2020-03-02T00:33:29.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2020-10-06T04:14:01.000Z (over 5 years ago)
- Last Synced: 2024-08-08T15:39:35.248Z (almost 2 years ago)
- Language: Python
- Size: 50.8 KB
- Stars: 2
- Watchers: 11
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.rst
- Changelog: CHANGES.rst
Awesome Lists containing this project
README
=======
Bronski
=======
.. image:: https://badge.fury.io/py/bronski.svg
:target: https://pypi.org/project/bronski
.. image:: https://img.shields.io/pypi/pyversions/bronski.svg
:target: https://pypi.org/project/bronski
.. image:: https://github.com/uptick/bronski/workflows/Test/badge.svg
:target: https://github.com/uptick/bronski/actions?query=workflow%3ATest
.. rubric:: A beat server for Django, with cron-like syntax
Bronski allows you to configure periodic function calls using a Django model.
It is ideally suited to being a task "beat" sever, akin to celery-beat.
Install
-------
.. code-block:: sh
$ pip install bronski
Setup
-----
1. Add 'bronski' to your ``INSTALLED_APPS``
This is only needed to enable the management command.
2. Create a model in your own app that inherits from ``bronski.models.CrontabBase``
3. Create and apply migrations:
.. code-block:: sh
$ manage.py makemigrations
$ manage.py migrate
4. Specify your model in settings
.. code-block:: python
CRONTAB_MODEL = "myapp.MyCronModel"
5. Launch your beat server:
.. code-block:: sh
$ ./manage.py bronski
Each minute the ``bronski`` service will scan the model for enabled jobs that
haven't been run in the past 59 seconds. It will then check each to see if its
crontab definition matches the next minute.
For job records that match, their ``run`` method will be called. The default
``run`` method will:
- get the specified function by calling ``self.get_function()``
- resolve the ``kwargs`` to use by calling ``self.get_kwargs()``
- invoke the function with the ``kwargs``.
You can override ``run`` in your custom model to, for instance, enqueue jobs:
.. code-block:: python
class Jobs(CrontabBase):
def run(self):
func = self.get_function()
kwargs = self.get_kwargs()
# Celery task API:
func.delay(**kwargs)
# Dramatiq actor API:
func.send(**kwargs)