autojob 1.0.0

Description:

autojob 1.0.0

README.md

English
简体中文

AutoJob
AutoJob 是整合了APScheduler和Django的一个定时任务app，只需安装依赖，通过一定配置即可完成定时任务的开发，可通过页面管理定时任务的编辑和状态变更
该app解决了在 Django + uwsgi 部署应用时，启动多个进程会导致定时任务启动冲突的情况
暂只支持corn和date两种类型，本地需安装redis
该定时任务还适配了simple-ui前端框架
安装方式
pip install autojob

使用方式
1. 添加 "autojob" 到 settings.py的 INSTALLED_APPS 中：
INSTALLED_APPS = [
...
'autojob.apps.AutoJob',
]

2. 执行 python manage.py migrate autojob 迁移数据表，下面是添加触发器的方式
两种录入自定义定时任务的方式

终端命令方式

## django项目中编写了自定义的定时任务后，可以在终端执行以下命令：
python manage.py scan_jobs

##返回以下信息，即表示成功添加了定时任务触发器到数据表中（重复执行不会导致重复添加）：
###检测到新增定时任务：myapp.abc.job_test


代码调用方式

## 这种方式是在`wsgi.py`文件中增加对command的引用来录入自定义定时任务触发器
from app.management.commands.scan_jobs import Command
scan_jobs = Command()
scan_jobs.handle()

##返回以下信息，即表示成功添加了定时任务触发器到数据表中（重复执行不会导致重复添加）：
###检测到新增定时任务：myapp.abc.job_test

3. django应用启动时调用定时任务，在 wsgi.py中添加：
from autojob import job_tool
job_tool.job_control()

4. 在 settings.py添加redis配置
CACHES = {
"default": {
"BACKEND": "django_redis.cache.RedisCache",
"LOCATION": "redis://127.0.0.1:6379/0",
"OPTIONS": {
"PICK_VERSION": -1,
"COMPRESSOR": "django_redis.compressors.zlib.ZlibCompressor",
"CLIENT_CLASS": "django_redis.client.DefaultClient",
"PASSWORD": ""
}
}
}

5. 一个测试任务的demo： job_test.py
# coding=utf-8
import datetime
import logging

from app.job_tool import job_before

logger = logging.getLogger(__name__)


@job_before
def job_test(*args):
# 当应用程序启动时，录入任务触发器时会读取下面这行文档当做触发器的描述，如果没有则默认描述是函数的路径
"""一个测试的定时任务"""
now = datetime.datetime.now().strftime('%Y-%m-%d %H:%M:%S')
logger.info(now + '__This is a timed task for testing:' + args[0])