rename field

Author: nxexox

docs/api-guid/fields.md

@@ -333,7 +333,7 @@ class ClassNameField(serializers.Field):
 ### Raising validation errors
 
 Our `ColorField` class above currently does not perform any data validation.
-To indicate invalid data, we should raise a `serializers.ValidationError` or call `self.fail(detail, status=400)`, like so:
+To indicate invalid data, we should raise a `serializers.ValidationError` or call `self.fail_validate(detail, status=400)`, like so:
 ```python
 def to_internal_value(self, data):
     if not isinstance(data, six.text_type):
@@ -347,7 +347,7 @@ def to_internal_value(self, data):
     red, green, blue = [int(col) for col in data.split(',')]
 
     if any([col > 255 or col < 0 for col in (red, green, blue)]):
-        self.fail(detail='Value out of range. Must be between 0 and 255.')
+        self.fail_validate(detail='Value out of range. Must be between 0 and 255.')
 
     return Color(red, green, blue)
 ```

docs/release-notes.md

@@ -9,6 +9,12 @@ Medium version numbers (0.x.0) may include API changes, in line with the [deprec
 Major version numbers (x.0.0) are reserved for substantial project milestones.
 
 
+### 0.3.12
+
+**Date:** [21th January 2020]
+
+* Rename `fail` -> `fail_validate` in fields.
+
 ### 0.3.11
 
 **Date:** [21th January 2020]

rest_framework/__init__.py

@@ -8,7 +8,7 @@
          __/ |
         |___/
 """
-VERSION = (0, 3, 11)
+VERSION = (0, 3, 12)
 
 __title__ = 'Python-Rest-Framework'
 __author__ = 'Deys Timofey'

rest_framework/serializers/fields.py

@@ -158,7 +158,7 @@ def get_validators(self):
         """
         return self.default_validators[:]
 
-    def fail(self, detail=None, status=400):
+    def fail_validate(self, detail=None, status=400):
         """
         We throw a normal error if custom validation error.
 

tests/test_fields.py

@@ -279,15 +279,15 @@ def test_fail_field_validation(self):
                 'test-test', e.detail
             )
 
-    def test_fail(self):
+    def test_fail_validate(self):
         """
         Testing fail method.
 
         """
         field = self.field_class(**self.create_params())
         detail = {'error': 'test'}
         try:
-            field.fail(detail=detail)
+            field.fail_validate(detail=detail)
             self.fail('`.fail()` must throw as exception `ValidationError`.')
         except ValidationError as e:
             self.assertEqual(
@@ -301,7 +301,7 @@ def test_fail(self):
             )
         status = 404
         try:
-            field.fail(detail=detail, status=status)
+            field.fail_validate(detail=detail, status=status)
             self.fail('`.fail()` must throw as exception `ValidationError`.')
         except ValidationError as e:
             self.assertEqual(