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

@@ -13,6 +13,7 @@
 
 from readthedocs.builds.constants import LATEST, STABLE
 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
@@ -715,6 +716,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):
 
     """
@@ -798,6 +807,12 @@ class Meta:
                     "read_only": True,
                 },
             ),
+            "permissions": (
+                ProjectPermissionSerializer,
+                {
+                    "source": "*",
+                },
+            ),
         }
 
     def __init__(self, *args, **kwargs):

readthedocs/api/v3/views.py

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