Description

########### django-load ########### Module and object loader utilities for Django. ******** Features ******** * Load all modules from all installed apps with a given name. * Load all modules from all installed apps with a given name and iterate over them. * Load an object from a module using a middleware classes like import path. * Unittested (see http://ci.django-cms.org/job/django-load/) * Documented (see http://django-load.readthedocs.org) ******** Examples ******** For full API documentation, please refer to http://django-load.readthedocs.org. Let's assume your app wants to load all ``plugins.py`` files from the installed apps, to allow those apps to extend your application. You can achieve this like this:: from django_load.core import load load('plugins') Now let's say you want to do the same, but actually do something with those modules, more specific, find all objects in those modules, that are subclasses of ``BasePlugin`` and call our ``do_something`` function with those objects:: from django_load.core import iterload for module in iterload('plugins'): for name in dir(module): obj = getattr(module, name) if issubclass(obj, BasePlugin): do_something(obj) You could also have a setting called ``MY_APP_PLUGINS`` which contains import paths similar to ``MIDDLEWARE_CLASSES``. You want to load those plugins and call the ``do_something`` function with them:: from django_load.core import iterload_objects from django.conf import settings for obj in iterload_object(settings.MY_APP_PLUGINS): do_something(obj) If you only want to load a single object, you can do that too. Let's say you want to load ``MyObject`` from the ``mypackage.mymodule`` module:: from django_load.core import load_object obj = load_object('mypackage.mymodule.MyObject')