'Verifies that the current recorset holds a single record. Raises
an exception otherwise.'

def ensure_one(self):

    if (len(self) == 1):
        return self
    raise ValueError(('Expected    singleton:    %s' % self))
