feat(api): show admins of group

docs/api.rst

@@ -524,6 +524,7 @@ Groups
     :>json array components: link to associated components; see :http:get:`/api/components/(string:project)/(string:component)/`
     :>json array componentlists: link to associated componentlist; see :http:get:`/api/component-lists/(str:slug)/`
     :>json str defining_project: link to the defining project, used for :ref:`manage-acl`; see :http:get:`/api/projects/(string:project)/`
+    :>json array admins: link to associated administrators; see :http:get:`/api/users/(str:username)/`
 
     **Example JSON data:**
 
@@ -550,6 +551,9 @@ Groups
             "componentlist": "http://example.com/api/component-lists/new/",
             "components": [
                 "http://example.com/api/components/demo/weblate/"
+            ],
+            "admins": [
+                "http://example.com/api/users/exampleusername/"
             ]
         }
 

docs/changes.rst

@@ -9,6 +9,7 @@ Weblate 5.14.1
 
 * Document using Valkey in :ref:`celery` and :ref:`production-cache`.
 * Added HTTP environment overview in :ref:`manage-performance`.
+* :http:get:`/api/groups/` now includes ``admins``.
 
 .. rubric:: Bug fixes
 

weblate/api/serializers.py

@@ -98,7 +98,7 @@
         super().__init__(**kwargs)
         self.lookup_field = lookup_field
 
     def get_url(self, obj, view_name, request: AuthenticatedHttpRequest, format):  # noqa: A002
         """
         Given an object, return the URL that hyperlinks to the object.
 
@@ -377,7 +377,7 @@
     )
 
     id = serializers.IntegerField(read_only=True)
     user = serializers.HyperlinkedRelatedField(
         read_only=True, view_name="api:user-detail", lookup_field="username"
     )
 
@@ -446,7 +446,7 @@
         many=True,
         read_only=True,
     )
     componentlists = serializers.HyperlinkedRelatedField(
         view_name="api:componentlist-detail",
         lookup_field="slug",
         many=True,
@@ -464,6 +464,12 @@
         queryset=Project.objects.none(),
         required=False,
     )
+    admins = serializers.HyperlinkedRelatedField(
+        view_name="api:user-detail",
+        lookup_field="username",
+        many=True,
+        read_only=True,
+    )
 
     class Meta:
         model = Group
@@ -480,6 +486,7 @@
             "componentlists",
             "components",
             "enforced_2fa",
+            "admins",
         )
         extra_kwargs = {  # noqa: RUF012
             "url": {"view_name": "api:group-detail", "lookup_field": "id"},
@@ -488,7 +495,7 @@
     def __init__(self, *args, **kwargs) -> None:
         super().__init__(*args, **kwargs)
         user = self.context["request"].user
         self.fields["defining_project"].queryset = user.managed_projects
 
 
 class ProjectSerializer(serializers.ModelSerializer[Project]):
@@ -565,7 +572,7 @@
     def get_attribute(self, instance):
         if instance.linked_component:
             instance = instance.linked_component
         return getattr(instance, self.source)
 
 
 class RepoField(LinkedField):
@@ -750,7 +757,7 @@
             project = kwargs["context"]["project"]
 
         if project is not None:
             self.fields["category"].queryset = project.category_set.all()
 
     def validate_enforced_checks(self, value):
         if not isinstance(value, list):
@@ -1052,7 +1059,7 @@
         if data["conflicts"] == "replace-approved" and not (
             denied := user.has_perm("unit.review", obj)
         ):
             raise serializers.ValidationError({"conflicts": denied.reason})
 
         if not (denied := check_upload_method_permissions(user, obj, data["method"])):
             hint = "Check your permissions or use different translation object."
@@ -1194,7 +1201,7 @@
         read_only_fields = ("project",)
 
 
 class UnitLabelsSerializer(serializers.RelatedField, LabelSerializer):
     def get_queryset(self):
         """
         List of available labels for an unit.
@@ -1244,7 +1251,7 @@
     language_code = serializers.CharField(
         source="translation.language.code", read_only=True
     )
     source_unit = serializers.HyperlinkedRelatedField(
         read_only=True, view_name="api:unit-detail"
     )
     source = PluralField()