Add note that APISettings is an internal class

This commit is contained in:
Ryan P Kilby 2020-01-15 01:15:50 -08:00
parent 442a206502
commit 1f773b9329

View File

@ -182,14 +182,19 @@ def import_from_string(val, setting_name):
class APISettings: class APISettings:
""" """
A settings object, that allows API settings to be accessed as properties. A settings object that allows REST Framework settings to be accessed as
For example: properties. For example:
from rest_framework.settings import api_settings from rest_framework.settings import api_settings
print(api_settings.DEFAULT_RENDERER_CLASSES) print(api_settings.DEFAULT_RENDERER_CLASSES)
Any setting with string import paths will be automatically resolved Any setting with string import paths will be automatically resolved
and return the class, rather than the string literal. and return the class, rather than the string literal.
Note:
This is an internal class that is only compatible with settings namespaced
under the REST_FRAMEWORK name. It is not intended to be used by 3rd-party
apps, and test helpers like `override_settings` may not work as expected.
""" """
def __init__(self, user_settings=None, defaults=None, import_strings=None): def __init__(self, user_settings=None, defaults=None, import_strings=None):
if user_settings: if user_settings: