Source

django-registration-plus / registration / backends / __init__.py

Full commit
from django.core.exceptions import ImproperlyConfigured


# Python 2.7 has an importlib with import_module; for older Pythons,
# Django's bundled copy provides it.
try: # pragma: no cover
    from importlib import import_module # pragma: no cover
except ImportError: # pragma: no cover
    from django.utils.importlib import import_module # pragma: no cover


def get_backend(path):
    """
    Return an instance of a registration backend, given the dotted
    Python import path (as a string) to the backend class.

    If the backend cannot be located (e.g., because no such module
    exists, or because the module does not contain a class of the
    appropriate name), ``django.core.exceptions.ImproperlyConfigured``
    is raised.
    
    """
    i = path.rfind('.')
    module, attr = path[:i], path[i+1:]
    try:
        mod = import_module(module)
    except ImportError, e:
        raise ImproperlyConfigured('Error loading registration backend %s: "%s"' % (module, e))
    try:
        backend_class = getattr(mod, attr)
    except AttributeError:
        raise ImproperlyConfigured('Module "%s" does not define a registration backend named "%s"' % (module, attr))
    return backend_class()
    

class InvitationException(Exception):
    pass
    

class EmptyBackend(object):
    """
    A skeleton for backends that fit with the views and models provided in 
    this package.
    """
    def invite(self, request, **kwargs):
        raise NotImplementedError
    
    def post_invitation_redirect(self, request, user):
        raise NotImplementedError
    
    def register(self, request, **kwargs):
        raise NotImplementedError # pragma: no cover
    
    def registration_allowed(self, request):
        raise NotImplementedError # pragma: no cover
        
    def get_form_class(self, request):
        raise NotImplementedError # pragma: no cover
        
    def post_registration_redirect(self, request, user):
        raise NotImplementedError # pragma: no cover
    
    def validate(self, request, validation_key):
        raise NotImplementedError
    
    def post_validation_redirect(self, request, user):
        raise NotImplementedError