Add summary field to extend_schema

drf_spectacular/openapi.py

@@ -47,6 +47,10 @@ def get_operation(self, path, path_regex, method, registry: ComponentRegistry):
         self.method = method
 
         operation = {}
+
+        summary = self.get_summary()
+        if summary:
+            operation['summary'] = summary
 
         operation['operationId'] = self.get_operation_id()
         operation['description'] = self.get_description()

drf_spectacular/utils.py

@@ -46,6 +46,7 @@ def __init__(self, name, type=str, location=QUERY, required=False, description='
 
 
 def extend_schema(
+        summary=None,
         operation_id=None,
         parameters=None,
         request=None,
@@ -63,6 +64,7 @@ def extend_schema(
     decorator for the "view" kind. partially or completely overrides what would be
     generated by drf-spectacular.
 
+    :param summary: An optional, string summary, intended to apply to all operations in this path.
     :param operation_id: replaces the auto-generated operation_id. make sure there
         are no naming collisions.
     :param parameters: list of additional or replacement parameters added to the
@@ -122,6 +124,10 @@ def get_operation(self, path, path_regex, method, registry):
                     return operation
                 return super().get_operation(path, path_regex, method, registry)
 
+            def get_summary(self):
+                if summary and is_in_scope(self):
+                    return summary
+
             def get_operation_id(self):
                 if operation_id and is_in_scope(self):
                     return operation_id