mirror of
https://github.com/encode/django-rest-framework.git
synced 2024-09-21 11:29:01 +03:00
f7c3220fdb
There is a problem in the current implementation that if one exports docs via `include_docs_urls` he will be using `ROOT_URLCONF` (https://github.com/encode/django-rest-framework/blob/master/rest_framework/schemas/generators.py#L73), which is a big problem, if one is working with subdomains and he has sets of disjoint URLs. This simple fix allows to pass through forgotten `urlconf` parameter.
89 lines
3.0 KiB
Python
89 lines
3.0 KiB
Python
from django.conf.urls import include, url
|
|
|
|
from rest_framework.renderers import (
|
|
CoreJSONRenderer, DocumentationRenderer, SchemaJSRenderer
|
|
)
|
|
from rest_framework.schemas import SchemaGenerator, get_schema_view
|
|
from rest_framework.settings import api_settings
|
|
|
|
|
|
def get_docs_view(
|
|
title=None, description=None, schema_url=None, urlconf=None,
|
|
public=True, patterns=None, generator_class=SchemaGenerator,
|
|
authentication_classes=api_settings.DEFAULT_AUTHENTICATION_CLASSES,
|
|
permission_classes=api_settings.DEFAULT_PERMISSION_CLASSES,
|
|
renderer_classes=None):
|
|
|
|
if renderer_classes is None:
|
|
renderer_classes = [DocumentationRenderer, CoreJSONRenderer]
|
|
|
|
return get_schema_view(
|
|
title=title,
|
|
url=schema_url,
|
|
urlconf=urlconf,
|
|
description=description,
|
|
renderer_classes=renderer_classes,
|
|
public=public,
|
|
patterns=patterns,
|
|
generator_class=generator_class,
|
|
authentication_classes=authentication_classes,
|
|
permission_classes=permission_classes,
|
|
)
|
|
|
|
|
|
def get_schemajs_view(
|
|
title=None, description=None, schema_url=None, urlconf=None,
|
|
public=True, patterns=None, generator_class=SchemaGenerator,
|
|
authentication_classes=api_settings.DEFAULT_AUTHENTICATION_CLASSES,
|
|
permission_classes=api_settings.DEFAULT_PERMISSION_CLASSES):
|
|
renderer_classes = [SchemaJSRenderer]
|
|
|
|
return get_schema_view(
|
|
title=title,
|
|
url=schema_url,
|
|
urlconf=urlconf,
|
|
description=description,
|
|
renderer_classes=renderer_classes,
|
|
public=public,
|
|
patterns=patterns,
|
|
generator_class=generator_class,
|
|
authentication_classes=authentication_classes,
|
|
permission_classes=permission_classes,
|
|
)
|
|
|
|
|
|
def include_docs_urls(
|
|
title=None, description=None, schema_url=None, urlconf=None,
|
|
public=True, patterns=None, generator_class=SchemaGenerator,
|
|
authentication_classes=api_settings.DEFAULT_AUTHENTICATION_CLASSES,
|
|
permission_classes=api_settings.DEFAULT_PERMISSION_CLASSES,
|
|
renderer_classes=None):
|
|
docs_view = get_docs_view(
|
|
title=title,
|
|
description=description,
|
|
schema_url=schema_url,
|
|
urlconf=urlconf,
|
|
public=public,
|
|
patterns=patterns,
|
|
generator_class=generator_class,
|
|
authentication_classes=authentication_classes,
|
|
renderer_classes=renderer_classes,
|
|
permission_classes=permission_classes,
|
|
)
|
|
schema_js_view = get_schemajs_view(
|
|
title=title,
|
|
description=description,
|
|
schema_url=schema_url,
|
|
urlconf=urlconf,
|
|
public=public,
|
|
patterns=patterns,
|
|
generator_class=generator_class,
|
|
authentication_classes=authentication_classes,
|
|
permission_classes=permission_classes,
|
|
)
|
|
urls = [
|
|
url(r'^$', docs_view, name='docs-index'),
|
|
url(r'^schema.js$', schema_js_view, name='schema-js')
|
|
]
|
|
return include((urls, 'api-docs'), namespace='api-docs')
|