2012-10-11 10:03:12 +00:00
|
|
|
# -*- coding: iso-8859-1 -*-
|
2012-10-11 16:02:29 +00:00
|
|
|
# Copyright (C) 2012 Bastian Kleineidam
|
|
|
|
"""
|
|
|
|
Functions to load plugin modules.
|
|
|
|
"""
|
2012-10-11 10:03:12 +00:00
|
|
|
import os
|
2012-11-19 20:20:50 +00:00
|
|
|
import importlib
|
2012-10-11 10:03:12 +00:00
|
|
|
|
2012-10-11 16:02:29 +00:00
|
|
|
|
2012-11-19 20:20:50 +00:00
|
|
|
def get_modules(folder='plugins'):
|
|
|
|
"""Find all valid modules in the plugins subdirectory. A valid module
|
2012-10-11 10:03:12 +00:00
|
|
|
must have a .py extension, and is importable.
|
|
|
|
@return: all loaded valid modules
|
|
|
|
@rtype: iterator of module
|
|
|
|
"""
|
2012-11-19 20:20:50 +00:00
|
|
|
dirname = os.path.join(os.path.dirname(__file__), folder)
|
|
|
|
for modname in get_importable_modules(dirname):
|
2012-10-11 10:03:12 +00:00
|
|
|
try:
|
2012-11-19 20:20:50 +00:00
|
|
|
name ="..%s.%s" % (folder, modname)
|
|
|
|
yield importlib.import_module(name, __name__)
|
2012-10-11 10:03:12 +00:00
|
|
|
except StandardError, msg:
|
2012-11-19 20:20:50 +00:00
|
|
|
print "ERROR: could not load module %s: %s" % (modname, msg)
|
2012-10-11 10:03:12 +00:00
|
|
|
|
|
|
|
|
|
|
|
def get_importable_modules(folder):
|
|
|
|
"""Find all module files in the given folder that end witn '.py' and
|
|
|
|
don't start with an underscore.
|
2012-11-19 20:20:50 +00:00
|
|
|
@return module names
|
2012-10-11 10:03:12 +00:00
|
|
|
@rtype: iterator of string
|
|
|
|
"""
|
2012-10-11 12:45:06 +00:00
|
|
|
for fname in sorted(os.listdir(folder)):
|
2012-10-11 10:03:12 +00:00
|
|
|
if fname.endswith('.py') and not fname.startswith('_'):
|
2012-11-19 20:20:50 +00:00
|
|
|
yield fname[:-3]
|
2012-10-11 10:03:12 +00:00
|
|
|
|
|
|
|
|
|
|
|
def get_plugins(modules, classobj):
|
|
|
|
"""Find all scrapers in all modules.
|
|
|
|
@param modules: the modules to search
|
|
|
|
@ptype modules: iterator of modules
|
|
|
|
@return: found scrapers
|
|
|
|
@rytpe: iterator of class objects
|
|
|
|
"""
|
|
|
|
for module in modules:
|
|
|
|
for plugin in get_module_plugins(module, classobj):
|
|
|
|
yield plugin
|
|
|
|
|
|
|
|
|
|
|
|
def get_module_plugins(module, classobj):
|
|
|
|
"""Return all subclasses of _BasicScraper in the module.
|
|
|
|
If the module defines __all__, only those entries will be searched,
|
|
|
|
otherwise all objects not starting with '_' will be searched.
|
|
|
|
"""
|
|
|
|
try:
|
|
|
|
names = module.__all__
|
|
|
|
except AttributeError:
|
|
|
|
names = [x for x in vars(module) if not x.startswith('_')]
|
2012-10-11 12:45:06 +00:00
|
|
|
for name in sorted(names):
|
2012-10-11 10:03:12 +00:00
|
|
|
try:
|
|
|
|
obj = getattr(module, name)
|
|
|
|
except AttributeError:
|
|
|
|
continue
|
|
|
|
try:
|
|
|
|
if issubclass(obj, classobj):
|
|
|
|
yield obj
|
|
|
|
except TypeError:
|
|
|
|
continue
|