Normal, Regex and Email properties

.gitignore

@@ -13,3 +13,4 @@ development.env
 .idea
 .python-version
 .ropeproject
+\#*\#

neomodel/__init__.py

@@ -7,6 +7,7 @@
         CardinalityViolation, ZeroOrMore, OneOrMore, ZeroOrOne, One)
 from .properties import (StringProperty, IntegerProperty, AliasProperty,
         FloatProperty, BooleanProperty, DateTimeProperty, DateProperty,
+        NormalProperty, RegexProperty, EmailProperty,
         JSONProperty, ArrayProperty)
 from .exception import InflateError, DeflateError, UniqueProperty, MultipleNodesReturned
 from .signals import SIGNAL_SUPPORT

neomodel/properties.py

@@ -1,6 +1,7 @@
 from .exception import InflateError, DeflateError, RequiredProperty
 from datetime import datetime, date
 import os
+import re
 import types
 import pytz
 import json
@@ -143,6 +144,76 @@ def is_indexed(self):
         return self.unique_index or self.index
 
 
+class NormalProperty(Property):
+    """Base class for normalized properties.
+
+    Normalized properties are those that use the same normalization
+    method to inflate or deflate.
+
+    """
+
+    @validator
+    def inflate(self, value):
+        return self.normalize(value)
+
+    @validator
+    def deflate(self, value):
+        return self.normalize(value)
+
+    def default_value(self):
+        default = super(NormalProperty, self).default_value()
+        return self.normalize(default)
+
+    def normalize(self, value):
+        raise NotImplementedError('Specialize normalize method')
+
+
+class RegexProperty(NormalProperty):
+    """Validates a normal property using a regular expression."""
+
+    expression = None
+    """Can be overriden in subclasses.
+
+    This helps quickly defining your own expression in case you want
+    to extend :py:class:`RegexProperty`.
+
+    """
+
+    def __init__(self, expression=None, **kwargs):
+        """Initializes new property with an expression.
+
+        :param str expression: regular expression validating this property
+
+        If no `expression` is given, then
+        :py:attr:`RegexProperty.expression` is used instead, which is
+        `None` by default, except if :py:class:`RegexProperty` is
+        extended.
+
+        """
+        super(RegexProperty, self).__init__(**kwargs)
+        actual_re = expression or self.expression
+        if actual_re is None:
+            raise ValueError('expression is undefined')
+        self.expression = actual_re
+
+    def normalize(self, value):
+        normal = unicode(value)
+        if not re.match(self.expression, normal):
+            raise ValueError(
+                '{0!r} does not matches {1!r}'.format(
+                    value,
+                    self.expression,
+                )
+            )
+        return normal
+
+
+class EmailProperty(RegexProperty):
+    """Suitable for email addresses."""
+
+    expression = r'[^@]+@[^@]+\.[^@]+'
+
+
 class StringProperty(Property):
     def __init__(self, **kwargs):
         super(StringProperty, self).__init__(**kwargs)