Catch APIException in doc generation

The documentation generator calls view.get_serializer() in order to
inspect it for documentation generation. However, if get_serializer()
throws an APIException (e.g. PermissionDenied), it doesn't get caught at
the call site, but instead propagates up and aborts the entire view.
With the try/except in this commit, the documentation generator instead
gratiously ignores that particular view and moves on to the next one
instead. Practical concequences of this commit is that the docs no
longer break if any view's get_serializer(..) throws an APIException.

Author: sigvef

rest_framework/schemas/inspectors.py

@@ -10,6 +10,7 @@
 from django.utils.encoding import force_text, smart_text
 from django.utils.translation import ugettext_lazy as _
 
+from rest_framework import exceptions
 from rest_framework import serializers
 from rest_framework.compat import coreapi, coreschema, uritemplate, urlparse
 from rest_framework.settings import api_settings
@@ -285,7 +286,10 @@ def get_serializer_fields(self, path, method):
         if not hasattr(view, 'get_serializer'):
             return []
 
-        serializer = view.get_serializer()
+        try:
+            serializer = view.get_serializer()
+        except exceptions.APIException:
+            serializer = None
 
         if isinstance(serializer, serializers.ListSerializer):
             return [