add source attribute to fields

Author: nxexox

docs/api-guid/fields.md

@@ -43,6 +43,29 @@ A list of validator functions which should be applied to the incoming field inpu
 
 A dictionary of error codes to error messages.
 
+###`source`
+
+The name of the field object with which the serializer field is associated. By default, the field name of the serializer = the name of the field of the object being serialized. This field changes this behavior.
+
+**Example:**
+```python
+from rest_framework import serializers
+
+class Model(object):
+    field = 10
+
+class StandardSerializer(serializers.Serializer):
+    field = serializers.IntegerField()
+
+class SourceFieldSerializer(serializers.Serializer):
+    new_field = serializers.IntegerField(source='field')
+
+print(StandardSerializer(instance=Model()).data)
+# {'field': 10}
+print(SourceFieldSerializer(instance=Model()).data)
+# {'new_field': 10}
+```
+
 ---
 
 # Fields

docs/release-notes.md

@@ -8,13 +8,18 @@ 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.4
+
+**Date:** [22th Jule 2019]
+
+* Added [`source`][SourceFieldAttribute] attribute for base fields class.
+
 ### 0.3.3
 
 **Date:** [22th Jule 2019]
 
 * Finish fix setup.py config. Change travis config, codecov config.
 
-
 ### 0.3.2
 
 **Date:** [22th Jule 2019]
@@ -118,6 +123,7 @@ Major version numbers (x.0.0) are reserved for substantial project milestones.
 * Push to Open Source community.
 
 
+[SourceFieldAttribute]: api-guid/fields#source
 [BaseViews]: api-guid/views/views
 [ViewsMixins]: api-guid/views/mixins
 [ViewsPaginations]: api-guid/views/paginations

rest_framework/__init__.py

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

rest_framework/serializers/fields.py

@@ -71,7 +71,8 @@ class Field(object):
     }
     default_validators = []  # Default validators for field.
 
-    def __init__(self, required=True, default=None, label=None, validators=None, error_messages=None):
+    def __init__(self, required=True, default=None, label=None, validators=None,
+                 error_messages=None, source=None):
         """
         Base field.
 
@@ -80,10 +81,12 @@ def __init__(self, required=True, default=None, label=None, validators=None, err
         :param str label: Field name.
         :param list validators: Validators for field.
         :param dict error_messages: Dictionary with custom error description.
+        :param str source: Source field_name, if field_name object other in serializer.
 
         """
         self.label = label
         self.default = default
+        self.source = source
         self.required = bool(required) if self.default is None else False
         # Added validator for check on required field.
         self._src_validators = validators
@@ -220,7 +223,7 @@ def _get_field_name(self):
         :rtype: str
 
         """
-        return self.field_name
+        return self.source or self.field_name
 
     def _get_attribute(self, instance):
         """