ctlmod.py

   1 # Erebus IRC bot - Author: John Runyon
   2 # vim: fileencoding=utf-8
   3 # module loading/unloading/tracking code
   4
   5 from __future__ import print_function
   6
   7 import sys, time, importlib
   8 import modlib
   9
  10 if sys.version_info.major >= 3:
  11         from importlib import reload # reload is only available as a global in Py2, only in importlib in Py3
  12 else:
  13         importlib.invalidate_caches = lambda: None # invalidate_caches doesn't exist in Py2
  14
  15 modules = {}
  16 dependents = {}
  17 #dependents[modname] = [list of modules which depend on modname]
  18
  19 def isloaded(modname): return modname in modules
  20 def modhas(modname, attname): return getattr(modules[modname], attname, None) is not None
  21
  22 def load(parent, modname, dependent=False):
  23         """Wrapper to call _load and print the return value."""
  24         if dependent:
  25                 print("(Loading dependency %s..." % (modname), end=' ')
  26         else:
  27                 print("%09.3f [MOD] [?] Loading %s..." % (time.time() % 100000, modname), end=' ')
  28         modstatus = _load(parent, modname, dependent)
  29         if not modstatus:
  30                 if dependent:
  31                         print("failed: %s)" % (modstatus), end=' ')
  32                 else:
  33                         print("failed: %s." % (modstatus))
  34         elif modstatus == True:
  35                 if dependent:
  36                         print("OK)", end=' ')
  37                 else:
  38                         print("OK.")
  39         else:
  40                 if dependent:
  41                         print("OK: %s)" % (modstatus), end=' ')
  42                 else:
  43                         print("OK: %s." % (modstatus))
  44         return modstatus
  45
  46 def _load(parent, modname, dependent=False):
  47         """Load and return the new status of the module."""
  48         successstatus = []
  49         if not isloaded(modname):
  50                 importlib.invalidate_caches()
  51                 try:
  52                         mod = importlib.import_module('modules.'+modname)
  53                         reload(mod) #in case it's been previously loaded.
  54                 except Exception as e:
  55                         return modlib.error(e)
  56
  57
  58                 if not hasattr(mod, 'modinfo'):
  59                         return modlib.error('no modinfo')
  60
  61                 if parent.APIVERSION not in mod.modinfo['compatible']:
  62                         return modlib.error('API-incompatible')
  63
  64                 modules[modname] = mod
  65                 dependents[modname] = []
  66
  67                 for dep in mod.modinfo['depends']:
  68                         if bool(int(parent.cfg.get('autoloads', dep, default=1))):
  69                                 if dep not in modules:
  70                                         depret = load(parent, dep, dependent=True)
  71                                         if depret is not None and not depret:
  72                                                 return depret
  73                         else:
  74                                 return modlib.error("dependent %s disabled" % (dep))
  75                         dependents[dep].append(modname)
  76
  77                 for dep in mod.modinfo['softdeps']:
  78                         if bool(int(parent.cfg.get('autoloads', dep, default=1))):
  79                                 if dep not in modules:
  80                                         depret = load(parent, dep, dependent=True)
  81                                         if depret is not None and not depret:
  82                                                 successstatus.append("softdep %s failed" % (dep))
  83                         else:
  84                                 successstatus.append("softdep %s disabled" % (dep))
  85                         #swallow errors loading - softdeps are preferred, not required
  86
  87
  88                 ret = mod.modstart(parent)
  89                 if ret is None:
  90                         ret = True
  91                 if not ret:
  92                         del modules[modname]
  93                         del dependents[modname]
  94                         for dep in mod.modinfo['depends']:
  95                                 dependents[dep].remove(modname)
  96
  97                 successstatus = ';'.join(successstatus)
  98                 if len(successstatus) > 0 and ret:
  99                         if ret == True:
 100                                 return successstatus
 101                         else:
 102                                 return "%s (%s)" % (ret, successstatus)
 103                 else:
 104                         return ret
 105         else: #if not isloaded...else:
 106                 return modlib.error('already loaded')
 107
 108 def unload(parent, modname):
 109         if isloaded(modname):
 110                 for dependent in dependents[modname]:
 111                         unload(parent, dependent)
 112                 for dep in modules[modname].modinfo['depends']:
 113                         dependents[dep].remove(modname)
 114                 ret = modules[modname].modstop(parent)
 115                 del modules[modname]
 116                 return ret
 117         else:
 118                 return modlib.error('already unloaded')
 119
 120 def reloadmod(parent, modname):
 121         if isloaded(modname):
 122                 if modhas(modname, 'modrestart'): modules[modname].modrestart(parent)
 123                 else: modules[modname].modstop(parent)
 124
 125                 try:
 126                         reload(modules[modname])
 127                 except BaseException as e:
 128                         return modlib.error(e)
 129
 130                 if modhas(modname, 'modrestarted'): ret = modules[modname].modrestarted(parent)
 131                 else: ret = modules[modname].modstart(parent)
 132
 133                 return ret
 134         else:
 135                 return load(parent, modname)
 136
 137
 138 def loadall(parent, modlist):
 139         for m in modlist: load(parent, m)
 140 def unloadall(parent, modlist):
 141         for m in modlist: unload(parent, m)
 142 def reloadall(parent, modlist):
 143         for m in modlist: reloadmod(parent, m)