Deprecate APIView.initial() in favor of APIView.initialize().

rest_framework/views.py

@@ -224,7 +224,7 @@ class APIView(View):
                        negotiator=self.get_content_negotiator(),
                        parser_context=parser_context)
 
-    def initial(self, request, *args, **kwargs):
+    def initialize(self, request, *args, **kwargs):
         """
         Runs anything that needs to occur prior to calling the method handler.
         """
@@ -239,6 +239,11 @@ class APIView(View):
         neg = self.perform_content_negotiation(request)
         request.accepted_renderer, request.accepted_media_type = neg
 
+    def initial(self, request, *args, **kwargs):
+        raise DeprecationWarning("Call to deprecated method APIView.initial()."
+                                 " Please use APIView.initialize() instead.")
+        return self.initialize(request, *args, **kwargs)
+
     def finalize_response(self, request, response, *args, **kwargs):
         """
         Returns the final response object.
@@ -312,7 +317,7 @@ class APIView(View):
         self.headers = self.default_response_headers  # deprecate?
 
         try:
-            self.initial(request, *args, **kwargs)
+            self.initialize(request, *args, **kwargs)
 
             # Get the appropriate handler method
             if request.method.lower() in self.http_method_names: