encode/django-rest-framework
1
1
Fork 0
mirror of https://github.com/encode/django-rest-framework.git synced 2025-07-29 09:30:07 +03:00
Code Issues Packages Projects Releases Wiki Activity

make get_reference public

Browse Source
This commit is contained in:
Alan Crosswell 2020-09-02 11:27:47 -04:00
parent c7ba30825a
commit 3cff589470
No known key found for this signature in database
GPG Key ID: 55819C8ADBD81C72
2 changed files with 16 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
docs/api-guide/schemas.md
View File

@ -313,6 +313,11 @@ Computes the component's name from the serializer.
You may see warnings if your API has duplicate component names. If so you can override `get_component_name()` or pass the `component_name` `__init__()` kwarg (see below) to provide different names. You may see warnings if your API has duplicate component names. If so you can override `get_component_name()` or pass the `component_name` `__init__()` kwarg (see below) to provide different names.
#### `get_reference()`
Returns a reference to the serializer component. This may be useful if you override `get_schema()`.
#### `map_serializer()` #### `map_serializer()`
Maps serializers to their OpenAPI representations. Maps serializers to their OpenAPI representations.

14
rest_framework/schemas/openapi.py
View File

@ -615,7 +615,7 @@ class AutoSchema(ViewInspector):
.format(view.__class__.__name__, method, path)) .format(view.__class__.__name__, method, path))
return None return None
def _get_reference(self, serializer): def get_reference(self, serializer):
return {'$ref': '#/components/schemas/{}'.format(self.get_component_name(serializer))} return {'$ref': '#/components/schemas/{}'.format(self.get_component_name(serializer))}
def get_request_body(self, path, method): def get_request_body(self, path, method):
@ -629,7 +629,7 @@ class AutoSchema(ViewInspector):
if not isinstance(serializer, serializers.Serializer): if not isinstance(serializer, serializers.Serializer):
item_schema = {} item_schema = {}
else: else:
item_schema = self._get_reference(serializer) item_schema = self.get_reference(serializer)
return { return {
'content': { 'content': {
@ -653,7 +653,7 @@ class AutoSchema(ViewInspector):
if not isinstance(serializer, serializers.Serializer): if not isinstance(serializer, serializers.Serializer):
item_schema = {} item_schema = {}
else: else:
item_schema = self._get_reference(serializer) item_schema = self.get_reference(serializer)
if is_list_view(path, method, self.view): if is_list_view(path, method, self.view):
response_schema = { response_schema = {
@ -787,3 +787,11 @@ class AutoSchema(ViewInspector):
RemovedInDRF314Warning, stacklevel=2 RemovedInDRF314Warning, stacklevel=2
) )
return self.allows_filters(path, method) return self.allows_filters(path, method)
def _get_reference(self, serializer):
warnings.warn(
"Method `_get_reference()` has been renamed to `get_reference()`. "
"The old name will be removed in DRF v3.14.",
RemovedInDRF314Warning, stacklevel=2
)
return self.get_reference(serializer)