144 lines
4.8 KiB
Python
144 lines
4.8 KiB
Python
# -*- coding: utf-8 -*-
|
|
|
|
# Nemubot is a smart and modulable IM bot.
|
|
# Copyright (C) 2012-2014 nemunaire
|
|
#
|
|
# This program is free software: you can redistribute it and/or modify
|
|
# it under the terms of the GNU Affero General Public License as published by
|
|
# the Free Software Foundation, either version 3 of the License, or
|
|
# (at your option) any later version.
|
|
#
|
|
# This program is distributed in the hope that it will be useful,
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
# GNU Affero General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU Affero General Public License
|
|
# along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
from datetime import datetime, timedelta
|
|
|
|
class ModuleEvent:
|
|
|
|
"""Representation of a event initiated by a bot module"""
|
|
|
|
def __init__(self, call=None, call_data=None, func=None, func_data=None,
|
|
cmp=None, cmp_data=None, interval=60, offset=0, times=1):
|
|
|
|
"""Initialize the event
|
|
|
|
Keyword arguments:
|
|
call -- Function to call when the event is realized
|
|
call_data -- Argument(s) (single or dict) to pass as argument
|
|
func -- Function called to check
|
|
func_data -- Argument(s) (single or dict) to pass as argument OR if no func, initial data to watch
|
|
cmp -- Boolean function called to check changes
|
|
cmp_data -- Argument(s) (single or dict) to pass as argument OR if no cmp, data compared to previous
|
|
interval -- Time in seconds between each check (default: 60)
|
|
offset -- Time in seconds added to interval before the first check (default: 0)
|
|
times -- Number of times the event has to be realized before being removed; -1 for no limit (default: 1)
|
|
"""
|
|
|
|
# What have we to check?
|
|
self.func = func
|
|
self.func_data = func_data
|
|
|
|
# How detect a change?
|
|
self.cmp = cmp
|
|
self.cmp_data = None
|
|
if cmp_data is not None:
|
|
self.cmp_data = cmp_data
|
|
elif self.func is not None:
|
|
if self.func_data is None:
|
|
self.cmp_data = self.func()
|
|
elif isinstance(self.func_data, dict):
|
|
self.cmp_data = self.func(**self.func_data)
|
|
else:
|
|
self.cmp_data = self.func(self.func_data)
|
|
|
|
# What should we call when?
|
|
self.call = call
|
|
if call_data is not None:
|
|
self.call_data = call_data
|
|
else:
|
|
self.call_data = func_data
|
|
|
|
# Store times
|
|
self.offset = timedelta(seconds=offset) # Time to wait before the first check
|
|
self.interval = timedelta(seconds=interval)
|
|
self._end = None # Cache
|
|
|
|
# How many times do this event?
|
|
self.times = times
|
|
|
|
|
|
@property
|
|
def current(self):
|
|
"""Return the date of the near check"""
|
|
if self.times != 0:
|
|
if self._end is None:
|
|
self._end = datetime.now() + self.offset + self.interval
|
|
return self._end
|
|
return None
|
|
|
|
|
|
@property
|
|
def next(self):
|
|
"""Return the date of the next check"""
|
|
if self.times != 0:
|
|
if self._end is None:
|
|
return self.current
|
|
elif self._end < datetime.now():
|
|
self._end += self.interval
|
|
return self._end
|
|
return None
|
|
|
|
|
|
@property
|
|
def time_left(self):
|
|
"""Return the time left before/after the near check"""
|
|
if self.current is not None:
|
|
return self.current - datetime.now()
|
|
return 99999 #TODO: 99999 is not a valid time to return
|
|
|
|
|
|
def check(self):
|
|
"""Run a check and realized the event if this is time"""
|
|
|
|
# Get initial data
|
|
if self.func is None:
|
|
d_init = self.func_data
|
|
elif self.func_data is None:
|
|
d_init = self.func()
|
|
elif isinstance(self.func_data, dict):
|
|
d_init = self.func(**self.func_data)
|
|
else:
|
|
d_init = self.func(self.func_data)
|
|
|
|
# then compare with current data
|
|
if self.cmp is None:
|
|
if self.cmp_data is None:
|
|
rlz = True
|
|
else:
|
|
rlz = (d_init != self.cmp_data)
|
|
elif self.cmp_data is None:
|
|
rlz = self.cmp(d_init)
|
|
elif isinstance(self.cmp_data, dict):
|
|
rlz = self.cmp(d_init, **self.cmp_data)
|
|
else:
|
|
rlz = self.cmp(d_init, self.cmp_data)
|
|
|
|
if rlz:
|
|
self.times -= 1
|
|
|
|
# Call attended function
|
|
if self.call_data is None:
|
|
if d_init is None:
|
|
self.call()
|
|
else:
|
|
self.call(d_init)
|
|
elif isinstance(self.call_data, dict):
|
|
self.call(d_init, **self.call_data)
|
|
else:
|
|
self.call(d_init, self.call_data)
|