sched模塊內容很簡單,只定義了一個類。它用來最為一個通用的事件調度模塊。
class sched.scheduler(timefunc, delayfunc)這個類定義了調度事件的通用接口,它需要外部傳入兩個參數,timefunc是一個沒有參數的返回時間類型數字的函數(常用使用的如time模塊裡面的time),delayfunc應該是一個需要一個參數來調用、與timefunc的輸出兼容、並且作用為延遲多個時間單位的函數(常用的如time模塊的sleep)。
下面是一個列子:
import sched, time
s = sched.scheduler(time.time, time.sleep) # 生成調度器
def print_time():
print "From print_time", time.time()
def print_some_times():
print time.time()
s.enter(5, 1, print_time, ())
# 加入調度事件
# 四個參數分別是:
# 間隔事件(具體值決定與delayfunc, 這裡為秒);
# 優先級(兩個事件在同一時間到達的情況);
# 觸發的函數;
# 函數參數;
s.enter(10, 1, print_time, ())
# 運行
s.run()
print time.time()
if __name__ == '__main__':
print_some_times()
看到的輸出結果,隔5秒中執行第一個事件,隔10秒後執行第二個事件:
1499259731.99
From print_time 1499259736.99
From print_time 1499259741.99
1499259741.99
在多線程場景中,會有線程安全問題,run()函數會阻塞主線程。官方建議使用threading.Timer類代替:
''' 學習中遇到問題沒人解答?小編創建了一個Python學習交流QQ群:711312441 尋找有志同道合的小伙伴,互幫互助,群裡還有不錯的視頻學習教程和PDF電子書! '''
import time
from threading import Timer
def print_time():
print "From print_time", time.time()
def print_some_times():
print time.time()
Timer(5, print_time, ()).start()
Timer(10, print_time, ()).start()
time.sleep(11) # 阻塞主線程,等待調度程序執行完畢,再執行後面內容
print time.time()
if __name__ == '__main__':
print_some_times()
scheduler對象擁有下面這些方法或屬性:
加入一個事件,time參數應該是一個與傳遞給構造函數的timefunc函數的返回值相兼容的數值類型。在同一時間到達的事件將按照priority順序執行。
執行事件其實就是執行action(argument)。argument必須是一個包含action參數的序列。
返回值是一個事件,它可以用於稍後取消事件(請參見cancel())。
安排一個事件來延遲delay個時間單位。除了時間外,其他參數、含義和返回值與enterabs()的值相同。其實內部enterabs就是用來被enter調用。
從隊列中刪除事件。如果事件不是當前隊列中的事件,則該方法將跑出一個ValueError。
判斷隊列是否為空。
運行所有預定的事件。這個函數將等待(使用傳遞給構造函數的delayfunc()函數),然後執行事件,直到不再有預定的事件。
任何action或delayfunc都可以引發異常。在這兩種情況下,調度器將保持一個一致的狀態並傳播異常。如果一個異常是由action引起的,就不會再繼續執行run()。
只讀屬性,返回一個即將到達的事件列表(按到達事件排序),每個事件都是有time、priority、action、argument組成的namedtuple。