Add note that APISettings is an internal class (#7144)

This commit is contained in:
Ryan P Kilby 2020-01-15 02:52:29 -08:00 committed by Tom Christie
parent 442a206502
commit 5f3f2ef106

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: