X-Git-Url: https://git.stderr.nl/gitweb?p=matthijs%2Fupstream%2Fdjango-ldapdb.git;a=blobdiff_plain;f=ldapdb%2Fmodels%2Fbase.py;h=85353460ef1661e64283f54db73f20de27875ca1;hp=11b03d66710bfa62f2ae67cbd0c8ae81b43637b5;hb=HEAD;hpb=fe6e3af37054aa100679acf8236e17cc45c883a1 diff --git a/ldapdb/models/base.py b/ldapdb/models/base.py index 11b03d6..8535346 100644 --- a/ldapdb/models/base.py +++ b/ldapdb/models/base.py @@ -1,121 +1,229 @@ # -*- coding: utf-8 -*- # # django-ldapdb -# Copyright (C) 2009 Bolloré telecom +# Copyright (c) 2009-2011, Bolloré telecom +# All rights reserved. +# # See AUTHORS file for a full list of contributors. # -# This program is free software: you can redistribute it and/or modify -# it under the terms of the GNU General Public License as published by -# the Free Software Foundation, either version 3 of the License, or -# (at your option) any later version. +# Redistribution and use in source and binary forms, with or without modification, +# are permitted provided that the following conditions are met: +# +# 1. Redistributions of source code must retain the above copyright notice, +# this list of conditions and the following disclaimer. +# +# 2. Redistributions in binary form must reproduce the above copyright +# notice, this list of conditions and the following disclaimer in the +# documentation and/or other materials provided with the distribution. # -# 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 General Public License for more details. +# 3. Neither the name of Bolloré telecom nor the names of its contributors +# may be used to endorse or promote products derived from this software +# without specific prior written permission. # -# You should have received a copy of the GNU General Public License -# along with this program. If not, see . +# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND +# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED +# WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE +# DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR +# ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES +# (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; +# LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON +# ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS +# SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. # -# -*- coding: utf-8 -*- - import ldap import logging import django.db.models +from django.db import connections, router +from django.db.models import signals -from granadilla.db import connection as ldap_connection -from granadilla.db.query import QuerySet - -class ModelBase(django.db.models.base.ModelBase): - """ - Metaclass for all LDAP models. - """ - def __new__(cls, name, bases, attrs): - attr_meta = attrs.get('Meta', None) - if attr_meta: - dn = attr_meta._dn - object_classes = attr_meta._object_classes - - super_new = super(ModelBase, cls).__new__ - new_class = super_new(cls, name, bases, attrs) +import ldapdb +import fields - # patch manager to use our own QuerySet class - def get_query_set(): - return QuerySet(new_class) - new_class.objects.get_query_set = get_query_set - new_class._default_manager.get_query_set = get_query_set - - if attr_meta: - new_class._meta.dn = dn - new_class._meta.object_classes = attr_meta._object_classes - - return new_class +# Dict containing +object_classes = {} class Model(django.db.models.base.Model): """ Base class for all LDAP models. """ - __metaclass__ = ModelBase + dn = django.db.models.fields.CharField(max_length=200) + + # meta-data + base_dn = None + search_scope = ldap.SCOPE_SUBTREE + object_classes = ['top'] - def __init__(self, dn=None, *args, **kwargs): - self.dn = dn + def __init__(self, *args, **kwargs): super(Model, self).__init__(*args, **kwargs) + self.saved_pk = self.pk + + def build_rdn(self): + """ + Build the Relative Distinguished Name for this entry. + """ + bits = [] + for field in self._meta.fields: + if field.db_column and field.primary_key: + bits.append("%s=%s" % (field.db_column, getattr(self, field.name))) + if not len(bits): + raise Exception("Could not build Distinguished Name") + return '+'.join(bits) def build_dn(self): """ Build the Distinguished Name for this entry. """ - for field in self._meta.local_fields: - if field.primary_key: - return "%s=%s,%s" % (field.db_column, getattr(self, field.name), self._meta.dn) + return "%s,%s" % (self.build_rdn(), self.base_dn) raise Exception("Could not build Distinguished Name") - def delete(self): + def delete(self, using=None): """ Delete this entry. """ + using = using or router.db_for_write(self.__class__, instance=self) + connection = connections[using] logging.debug("Deleting LDAP entry %s" % self.dn) - ldap_connection.delete_s(self.dn) - - def save(self): - # create a new entry + connection.delete_s(self.dn) + signals.post_delete.send(sender=self.__class__, instance=self) + + def save(self, using=None): + """ + Saves the current instance. + """ + using = using or router.db_for_write(self.__class__, instance=self) + connection = connections[using] if not self.dn: - entry = [('objectClass', self._meta.object_classes)] + # create a new entry + record_exists = False + entry = [('objectClass', self.object_classes)] new_dn = self.build_dn() - for field in self._meta.local_fields: + for field in self._meta.fields: if not field.db_column: continue value = getattr(self, field.name) if value: - entry.append((field.db_column, value)) + entry.append((field.db_column, field.get_db_prep_save(value, connection=connection))) logging.debug("Creating new LDAP entry %s" % new_dn) - ldap_connection.add_s(new_dn, entry) - + connection.add_s(new_dn, entry) + # update object self.dn = new_dn - return - - # update an existing entry - modlist = [] - orig = self.__class__.objects.get(pk=self.pk) - for field in self._meta.local_fields: - if not field.db_column: - continue - old_value = getattr(orig, field.name, None) - new_value = getattr(self, field.name, None) - if old_value != new_value: - if new_value: - modlist.append((ldap.MOD_REPLACE, field.db_column, new_value)) - elif old_value: - modlist.append((ldap.MOD_DELETE, field.db_column, None)) - - if len(modlist): - logging.debug("Modifying existing LDAP entry %s" % self.dn) - ldap_connection.modify_s(self.dn, modlist) + else: - logging.debug("No changes to be saved to LDAP entry %s" % self.dn) + # update an existing entry + record_exists = True + modlist = [] + modlist.append((ldap.MOD_REPLACE, 'objectClass', [x.encode(connection.charset) for x in self.object_classes])) + orig = self.__class__.objects.get(pk=self.saved_pk) + for field in self._meta.fields: + if not field.db_column: + continue + old_value = getattr(orig, field.name, None) + new_value = getattr(self, field.name, None) + if old_value != new_value: + if new_value: + modlist.append((ldap.MOD_REPLACE, field.db_column, field.get_db_prep_save(new_value, connection=connection))) + elif old_value: + modlist.append((ldap.MOD_DELETE, field.db_column, None)) + + if len(modlist): + # handle renaming + new_dn = self.build_dn() + if new_dn != self.dn: + logging.debug("Renaming LDAP entry %s to %s" % (self.dn, new_dn)) + connection.rename_s(self.dn, self.build_rdn()) + self.dn = new_dn + + logging.debug("Modifying existing LDAP entry %s" % self.dn) + connection.modify_s(self.dn, modlist) + else: + logging.debug("No changes to be saved to LDAP entry %s" % self.dn) + + # done + self.saved_pk = self.pk + signals.post_save.send(sender=self.__class__, instance=self, created=(not record_exists)) + + def add_object_class(self, oc): + """ + Add an extra object class to this object. The added objectclass + must be defined as a subclass of ObjectClass. This changes the + type of this object to add the fields of the new + objectclass. + + The objectclass passed can be a string naming the objectclass, + or an ObjectClass subclass. + """ + + # The new class is a subclass of Model + bases = [Model] + list(Model.__bases__) + + object_classes = self.__class__.object_classes + object_classes.append(oc) + + dict_ = { + # Copy the module from Model + '__module__': Model.__module__, + # Generate some documentation + '__doc__': 'Automatically generated class for LDAP objects with objectclasses: ' + (', '.join(object_classes)), + # Add a class variable containing the object_classes + 'object_classes': object_classes, + # Copy the base_dn from the old class + 'base_dn': self.__class__.base_dn, + } + + # Add all current fields, but leave out fields that Model + # already has (these will be added by Django later, since we + # make the new class a subclass of Model). + dict_.update([(f.name, f) for f in self._meta.fields if not f in Model._meta.fields]) + + # If the passed object class is a string, resolve it to an + # ObjectClass object. + if (isinstance(oc, basestring)): + oc = ObjectClass.object_classes[oc] + + # Copy all fields (e.g., subclasses of Field) from the new + # ObjectClass + for k,v in oc.__dict__.items(): + if isinstance(v, django.db.models.fields.Field): + dict_[k] = v + + # Generate a name for the class (gotta have something...) + name = '_'.join(object_classes) + + # And finally, generate the type + self.__class__ = type(name, tuple(bases), dict_) + + # TODO: remove_object_class + + @classmethod + def scoped(base_class, base_dn): + """ + Returns a copy of the current class with a different base_dn. + """ + import new + import re + suffix = re.sub('[=,]', '_', base_dn) + name = "%s_%s" % (base_class.__name__, str(suffix)) + new_class = new.classobj(name, (base_class,), {'base_dn': base_dn, '__module__': base_class.__module__}) + return new_class + + class Meta: + abstract = True + +class ObjectClass(object): + """ + Superclass for LDAP objectclass descriptors. + """ + + # Mapping from objectclass name (string) to the ObjectClass subclass + # that describes it. Used when loading items from the database or + # when adding object classes. + # + # TODO: Automatically fill this list from a fancy metaclass + object_classes = {}