django-crontask - GitLite

KO | EN

gitlite — search

#javascript #hacktoberfest #react #llm #go #machine-learning #rust #linux #nodejs #kubernetes #pytorch #mcp #openai #open-source

django-crontask

(★ 126)

Cron style scheduler for Django's task framework

파일 탐색기

최종 버전 다운로드 (.zip)

- - superjoe.agent.md
- - ci.yml
  - release.yml
- copilot-instructions.md
- dependabot.yml
- - __init__.py
  - sentry.py
- - __init__.py
- __init__.py
- conf.py
- tasks.py
- utils.py
- logo-dark.svg
- logo-light.svg
- - __init__.py
  - test_sentry.py
- - __init__.py
  - settings.py
  - tasks.py
  - urls.py
- __init__.py
- conftest.py
- test_commands.py
- test_tasks.py
- test_utils.py
.codecov.yml
.editorconfig
.gitignore
.pre-commit-config.yaml
LICENSE
pyproject.toml
README.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/codingjoe/django-crontask

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd django-crontask

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Python

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Python 3 설치 시 'Add Python to PATH' 옵션을 꼭 체크하세요 (Windows).

python3 -m pip install django-crontask

requirements.txt 등에 명시된 파이썬 라이브러리를 설치합니다.

python3 -m pip install django-crontask[sentry] # with sentry cron monitor support

requirements.txt 등에 명시된 파이썬 라이브러리를 설치합니다.

✅ 에러 메시지 없이 실행되고 터미널에 안내 문구가 출력되면 정상입니다.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Django CronTask

<p align="center">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://github.com/codingjoe/django-crontask/raw/main/images/logo-dark.svg">
    <source media="(prefers-color-scheme: light)" srcset="https://github.com/codingjoe/django-crontask/raw/main/images/logo-light.svg">
    <img alt="Django CronTask: Cron style scheduler for Django's task framework" src="https://github.com/codingjoe/django-crontask/raw/main/images/logo-light.svg">
  </picture>
</p>

**Cron style scheduler for asynchronous tasks in Django.**

- setup recurring tasks via crontab syntax
- lightweight helpers build on top of [APScheduler]
- [Sentry] cron monitor support

[![PyPi Version](https://img.shields.io/pypi/v/django-crontask.svg)](https://pypi.python.org/pypi/django-crontask/)
[![Test Coverage](https://codecov.io/gh/codingjoe/django-crontask/branch/main/graph/badge.svg)](https://codecov.io/gh/codingjoe/django-crontask)
[![GitHub License](https://img.shields.io/github/license/codingjoe/django-crontask)](https://raw.githubusercontent.com/codingjoe/django-crontask/master/LICENSE)

## Sponsors

[![Sponsors](https://sponsor.pics/codingjoe/django-crontask.svg)](https://github.com/sponsors/codingjoe)

## Setup

> [!NOTE]
> Still need a reliable task backend? Check out [Threadmill]!

You need to have [Django's Task framework][django-tasks] setup properly.

```ShellSession
python3 -m pip install django-crontask
# or
python3 -m pip install django-crontask[sentry]  # with sentry cron monitor support
```

Add `crontask` to your `INSTALLED_APPS` in `settings.py`:

```python
# settings.py
INSTALLED_APPS = [
    "crontask",
    # ...
]
```

Finally, you launch the scheduler in a separate process:

```ShellSession
python3 manage.py crontask
```

### Setup Redis as a lock backend (optional)

If you use Redis as a broker, you can use Redis as a lock backend as well.
The lock backend is used to prevent multiple instances of the scheduler
from running at the same time. This is important if you have multiple
instances of your application running.

```python
# settings.py
CRONTASK = {
    "REDIS_URL": "redis://localhost:6379/0",
}
```

## Usage

```python
# tasks.py
import logging

from django.tasks import task
from crontask import cron

logger = logging.getLogger(__name__)

@cron("*/5 * * * *")  # every 5 minutes
@task
def my_task():
    logger.info("Hello World")
```

### Advanced Trigger Usage

You can also use other trigger types from [APScheduler].
Just import the trigger and use it in the `cron` decorator.

```python
import logging

from django.tasks import task
from django.utils import timezone
from apscheduler.triggers.interval import IntervalTrigger
from crontask import cron

logger = logging.getLogger(__name__)

every_ten_minutes = IntervalTrigger(
    minutes=10, timezone=timezone.get_default_timezone()
)

@cron(every_ten_minutes)
@task
def my_interval_task():
    logger.info("Hello from interval task")
```

### Sentry Cron Monitors

If you use [Sentry] suitable tasks will be automatically monitored.
The monitor's slug will be the actor's name. Like `my_task` in the example above.

Certain triggers are not supported by Sentry as well as sub-minute intervals.
In these cases, no monitor will be created and no telemetry will be sent.

Pass a custom config via `sentry_monitor_config` or set it to `None`
to disable Sentry monitoring for a single task:

```python
@cron("* * * * *", sentry_monitor_config=None)
@task
def my_task_without_sentry(): ...
```

### The crontask command

```ShellSession
$ python3 manage.py crontask --help
usage: manage.py crontask [-h] [--no-task-loading] [--no-heartbeat] [--version] [-v {0,1,2,3}]
                         [--settings SETTINGS] [--pythonpath PYTHONPATH] [--traceback] [--no-color]
                         [--force-color] [--skip-checks]

Run task scheduler for all tasks with the `cron` decorator.

options:
  -h, --help            show this help message and exit
  --no-task-loading     Don't load tasks from installed apps.
  --no-heartbeat        Don't start the heartbeat actor.
```

[apscheduler]: https://apscheduler.readthedocs.io/en/stable/
[django-tasks]: https://docs.djangoproject.com/en/6.0/topics/tasks/
[sentry]: https://docs.sentry.io/product/crons/
[threadmill]: https://github.com/codingjoe/threadmill