Source code for oscar.models.fields

from django.core.exceptions import ImproperlyConfigured
from django.db.models.fields import CharField, DecimalField
from django.utils import six
from django.utils.translation import ugettext_lazy as _
from phonenumber_field.modelfields import PhoneNumberField

from oscar.core import validators
from oscar.forms import fields
from oscar.models.fields.autoslugfield import AutoSlugField

AutoSlugField = AutoSlugField
PhoneNumberField = PhoneNumberField


# https://github.com/django/django/blob/64200c14e0072ba0ffef86da46b2ea82fd1e019a/django/db/models/fields/subclassing.py#L31-L44
[docs]class Creator(object): """ A placeholder class that provides a way to set the attribute on the model. """ def __init__(self, field): self.field = field def __get__(self, obj, type=None): if obj is None: return self return obj.__dict__[self.field.name] def __set__(self, obj, value): obj.__dict__[self.field.name] = self.field.to_python(value)
class ExtendedURLField(CharField): description = _("URL") def __init__(self, verbose_name=None, name=None, verify_exists=None, **kwargs): kwargs['max_length'] = kwargs.get('max_length', 200) CharField.__init__(self, verbose_name, name, **kwargs) # 'verify_exists' was deprecated in Django 1.4. To ensure backwards # compatibility, it is still accepted here, but only passed # on to the parent class if it was specified. self.verify_exists = verify_exists if verify_exists is not None: validator = validators.ExtendedURLValidator( verify_exists=verify_exists) else: validator = validators.ExtendedURLValidator() self.validators.append(validator) def formfield(self, **kwargs): # As with CharField, this will cause URL validation to be performed # twice. defaults = { 'form_class': fields.ExtendedURLField, 'verify_exists': self.verify_exists } defaults.update(kwargs) return super(ExtendedURLField, self).formfield(**defaults) def deconstruct(self): """ deconstruct() is needed by Django's migration framework """ name, path, args, kwargs = super(ExtendedURLField, self).deconstruct() # Add verify_exists to kwargs if it's not the default value. if self.verify_exists is not None: kwargs['verify_exists'] = self.verify_exists # We have a default value for max_length; remove it in that case if self.max_length == 200: del kwargs['max_length'] return name, path, args, kwargs
[docs]class PositiveDecimalField(DecimalField): """ A simple subclass of ``django.db.models.fields.DecimalField`` that restricts values to be non-negative. """ def formfield(self, **kwargs): return super(PositiveDecimalField, self).formfield(min_value=0)
[docs]class UppercaseCharField(CharField): """ A simple subclass of ``django.db.models.fields.CharField`` that restricts all text to be uppercase. Defined with the with_metaclass helper so that to_python is called https://docs.djangoproject.com/en/1.6/howto/custom-model-fields/#the-subfieldbase-metaclass # NOQA """ def contribute_to_class(self, cls, name, **kwargs): super(UppercaseCharField, self).contribute_to_class( cls, name, **kwargs) setattr(cls, self.name, Creator(self)) def from_db_value(self, value, expression, connection, context): return self.to_python(value) def to_python(self, value): val = super(UppercaseCharField, self).to_python(value) if isinstance(val, six.string_types): return val.upper() else: return val
[docs]class NullCharField(CharField): """ CharField that stores '' as None and returns None as '' Useful when using unique=True and forms. Implies null==blank==True. When a ModelForm with a CharField with null=True gets saved, the field will be set to '': https://code.djangoproject.com/ticket/9590 This breaks usage with unique=True, as '' is considered equal to another field set to ''. """ description = "CharField that stores '' as None and returns None as ''" def __init__(self, *args, **kwargs): if not kwargs.get('null', True) or not kwargs.get('blank', True): raise ImproperlyConfigured( "NullCharField implies null==blank==True") kwargs['null'] = kwargs['blank'] = True super(NullCharField, self).__init__(*args, **kwargs) def contribute_to_class(self, cls, name, **kwargs): super(NullCharField, self).contribute_to_class(cls, name, **kwargs) setattr(cls, self.name, Creator(self)) def from_db_value(self, value, expression, connection, context): return self.to_python(value) def to_python(self, value): val = super(NullCharField, self).to_python(value) return val if val is not None else u'' def get_prep_value(self, value): prepped = super(NullCharField, self).get_prep_value(value) return prepped if prepped != u"" else None
[docs] def deconstruct(self): """ deconstruct() is needed by Django's migration framework """ name, path, args, kwargs = super(NullCharField, self).deconstruct() del kwargs['null'] del kwargs['blank'] return name, path, args, kwargs