python周期任務(wù)調(diào)度工具Schedule使用詳解

更新時(shí)間：2021年11月23日 08:41:43 作者：Python學(xué)習(xí)與數(shù)據(jù)挖掘

這篇文章主要為大家介紹了python周期任務(wù)調(diào)度工具Schedule的使用及示例詳解，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進(jìn)步，早日升職加薪

1.準(zhǔn)備

開始之前，你要確保Python和pip已經(jīng)成功安裝在電腦上，請選擇以下任一種方式輸入命令安裝依賴：

Windows 環(huán)境打開 Cmd (開始-運(yùn)行-CMD)。

MacOS 環(huán)境打開 Terminal (command+空格輸入Terminal)。

如果你用的是 VSCode編輯器或 Pycharm，可以直接使用界面下方的Terminal.

pip install schedule

2.基本使用

最基本的使用在文首已經(jīng)提到過，下面給大家展示更多的調(diào)度任務(wù)例子：

import schedule
import time
def job():
    print("I'm working...")
# 每十分鐘執(zhí)行任務(wù)
schedule.every(10).minutes.do(job)
# 每個(gè)小時(shí)執(zhí)行任務(wù)
schedule.every().hour.do(job)
# 每天的10:30執(zhí)行任務(wù)
schedule.every().day.at("10:30").do(job)
# 每個(gè)月執(zhí)行任務(wù)
schedule.every().monday.do(job)
# 每個(gè)星期三的13:15分執(zhí)行任務(wù)
schedule.every().wednesday.at("13:15").do(job)
# 每分鐘的第17秒執(zhí)行任務(wù)
schedule.every().minute.at(":17").do(job)
while True:
    schedule.run_pending()
    time.sleep(1)

可以看到，從月到秒的配置，上面的例子都覆蓋到了。不過如果你想只運(yùn)行一次任務(wù)的話，可以這么配

import schedule
import time
def job_that_executes_once():
    # 此處編寫的任務(wù)只會(huì)執(zhí)行一次...
    return schedule.CancelJob
schedule.every().day.at('22:30').do(job_that_executes_once)
while True:
    schedule.run_pending()
    time.sleep(1)

參數(shù)傳遞

如果你有參數(shù)需要傳遞給作業(yè)去執(zhí)行，你只需要這么做：

import schedule
def greet(name):
    print('Hello', name)
# do() 將額外的參數(shù)傳遞給job函數(shù)
schedule.every(2).seconds.do(greet, name='Alice')
schedule.every(4).seconds.do(greet, name='Bob')

獲取目前所有的作業(yè)

如果你想獲取目前所有的作業(yè)：

import schedule
def hello():
    print('Hello world')
schedule.every().second.do(hello)
all_jobs = schedule.get_jobs()

取消所有作業(yè)

如果某些機(jī)制觸發(fā)了，你需要立即清除當(dāng)前程序的所有作業(yè)：

import schedule
def greet(name):
    print('Hello {}'.format(name))
schedule.every().second.do(greet)
schedule.clear()

標(biāo)簽功能

在設(shè)置作業(yè)的時(shí)候，為了后續(xù)方便管理作業(yè)，你可以給作業(yè)打個(gè)標(biāo)簽，這樣你可以通過標(biāo)簽過濾獲取作業(yè)或取消作業(yè)。

import schedule
def greet(name):
    print('Hello {}'.format(name))
# .tag 打標(biāo)簽
schedule.every().day.do(greet, 'Andrea').tag('daily-tasks', 'friend')
schedule.every().hour.do(greet, 'John').tag('hourly-tasks', 'friend')
schedule.every().hour.do(greet, 'Monica').tag('hourly-tasks', 'customer')
schedule.every().day.do(greet, 'Derek').tag('daily-tasks', 'guest')
# get_jobs(標(biāo)簽)：可以獲取所有該標(biāo)簽的任務(wù)
friends = schedule.get_jobs('friend')
# 取消所有 daily-tasks 標(biāo)簽的任務(wù)
schedule.clear('daily-tasks')

設(shè)定作業(yè)截止時(shí)間

如果你需要讓某個(gè)作業(yè)到某個(gè)時(shí)間截止，你可以通過這個(gè)方法：

import schedule
from datetime import datetime, timedelta, time
def job():
    print('Boo')
# 每個(gè)小時(shí)運(yùn)行作業(yè)，18:30后停止
schedule.every(1).hours.until("18:30").do(job)
# 每個(gè)小時(shí)運(yùn)行作業(yè)，2030-01-01 18:33 today
schedule.every(1).hours.until("2030-01-01 18:33").do(job)
# 每個(gè)小時(shí)運(yùn)行作業(yè)，8個(gè)小時(shí)后停止
schedule.every(1).hours.until(timedelta(hours=8)).do(job)
# 每個(gè)小時(shí)運(yùn)行作業(yè)，11:32:42后停止
schedule.every(1).hours.until(time(11, 33, 42)).do(job)
# 每個(gè)小時(shí)運(yùn)行作業(yè)，2020-5-17 11:36:20后停止
schedule.every(1).hours.until(datetime(2020, 5, 17, 11, 36, 20)).do(job)

截止日期之后，該作業(yè)將無法運(yùn)行。

立即運(yùn)行所有作業(yè)，而不管其安排如何

如果某個(gè)機(jī)制觸發(fā)了，你需要立即運(yùn)行所有作業(yè)，可以調(diào)用 schedule.run_all() :

import schedule
def job_1():
    print('Foo')
def job_2():
    print('Bar')
schedule.every().monday.at("12:40").do(job_1)
schedule.every().tuesday.at("16:40").do(job_2)
schedule.run_all()
# 立即運(yùn)行所有作業(yè)，每次作業(yè)間隔10秒
schedule.run_all(delay_seconds=10)

3.高級(jí)使用

裝飾器安排作業(yè)

如果你覺得設(shè)定作業(yè)這種形式太啰嗦了，也可以使用裝飾器模式：

from schedule import every, repeat, run_pending
import time
# 此裝飾器效果等同于 schedule.every(10).minutes.do(job)
@repeat(every(10).minutes)
def job():
    print("I am a scheduled job")
while True:
    run_pending()
    time.sleep(1)

并行執(zhí)行

默認(rèn)情況下，Schedule 按順序執(zhí)行所有作業(yè)。其背后的原因是，很難找到讓每個(gè)人都高興的并行執(zhí)行模型。

不過你可以通過多線程的形式來運(yùn)行每個(gè)作業(yè)以解決此限制：

import threading
import time
import schedule
def job1():
    print("I'm running on thread %s" % threading.current_thread())
def job2():
    print("I'm running on thread %s" % threading.current_thread())
def job3():
    print("I'm running on thread %s" % threading.current_thread())
def run_threaded(job_func):
    job_thread = threading.Thread(target=job_func)
    job_thread.start()
schedule.every(10).seconds.do(run_threaded, job1)
schedule.every(10).seconds.do(run_threaded, job2)
schedule.every(10).seconds.do(run_threaded, job3)
while True:
    schedule.run_pending()
    time.sleep(1)

日志記錄

Schedule 模塊同時(shí)也支持 logging 日志記錄，這么使用：

import schedule
import logging
logging.basicConfig()
schedule_logger = logging.getLogger('schedule')
# 日志級(jí)別為DEBUG
schedule_logger.setLevel(level=logging.DEBUG)
def job():
    print("Hello, Logs")
schedule.every().second.do(job)
schedule.run_all()
schedule.clear()

效果如下：

DEBUG:schedule:Running *all* 1 jobs with 0s delay in between
DEBUG:schedule:Running job Job(interval=1, unit=seconds, do=job, args=(), kwargs={})
Hello, Logs
DEBUG:schedule:Deleting *all* jobs

異常處理

Schedule 不會(huì)自動(dòng)捕捉異常，它遇到異常會(huì)直接拋出，這會(huì)導(dǎo)致一個(gè)嚴(yán)重的問題：后續(xù)所有的作業(yè)都會(huì)被中斷執(zhí)行，因此我們需要捕捉到這些異常。

你可以手動(dòng)捕捉，但是某些你預(yù)料不到的情況需要程序進(jìn)行自動(dòng)捕獲，加一個(gè)裝飾器就能做到了：

import functools
def catch_exceptions(cancel_on_failure=False):
    def catch_exceptions_decorator(job_func):
        @functools.wraps(job_func)
        def wrapper(*args, **kwargs):
            try:
                return job_func(*args, **kwargs)
            except:
                import traceback
                print(traceback.format_exc())
                if cancel_on_failure:
                    return schedule.CancelJob
        return wrapper
    return catch_exceptions_decorator
@catch_exceptions(cancel_on_failure=True)
def bad_task():
    return 1 / 0
schedule.every(5).minutes.do(bad_task)

這樣，bad_task 在執(zhí)行時(shí)遇到的任何錯(cuò)誤，都會(huì)被 catch_exceptions 捕獲，這點(diǎn)在保證調(diào)度任務(wù)正常運(yùn)轉(zhuǎn)的時(shí)候非常關(guān)鍵。

我們的文章到此就結(jié)束啦，如果你喜歡今天的Python 實(shí)戰(zhàn)教程，請持續(xù)關(guān)注。

以上就是python周期任務(wù)調(diào)度工具Schedule使用詳解的詳細(xì)內(nèi)容，更多關(guān)于周期任務(wù)調(diào)度工具Schedule的資料請關(guān)注腳本之家其它相關(guān)文章！

您可能感興趣的文章: