APIv3: return permissions expandable field on projects

Add `?expand=permissions` to project list/detail API endpoints.

Related readthedocs/ext-theme#128

readthedocs/api/v3/serializers.py

@@ -12,6 +12,7 @@
 from taggit.serializers import TaggitSerializer, TagListSerializerField
 
 from readthedocs.builds.models import Build, Version
+from readthedocs.core.permissions import AdminPermission
 from readthedocs.core.resolver import Resolver
 from readthedocs.core.utils import slugify
 from readthedocs.core.utils.extend import SettingsOverrideObject
@@ -591,6 +592,14 @@ class ProjectUpdateSerializer(SettingsOverrideObject):
     _default_class = ProjectUpdateSerializerBase
 
 
+class ProjectPermissionSerializer(serializers.Serializer):
+    admin = serializers.SerializerMethodField()
+
+    def get_admin(self, obj):
+        user = self.context.get("request").user
+        return AdminPermission.is_admin(user, obj)
+
+
 class ProjectSerializer(FlexFieldsModelSerializer):
 
     """
@@ -674,6 +683,12 @@ class Meta:
                     "read_only": True,
                 },
             ),
+            "permissions": (
+                ProjectPermissionSerializer,
+                {
+                    "source": "*",
+                },
+            ),
         }
 
     def __init__(self, *args, **kwargs):

readthedocs/api/v3/views.py

@@ -126,6 +126,7 @@ class ProjectsViewSetBase(
         "active_versions.last_build",
         "active_versions.last_build.config",
         "organization",
+        "permissions",
         "teams",
     ]