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:
"""
A settings object, that allows API settings to be accessed as properties.
For example:
A settings object that allows REST Framework settings to be accessed as
properties. For example:
from rest_framework.settings import api_settings
print(api_settings.DEFAULT_RENDERER_CLASSES)
Any setting with string import paths will be automatically resolved
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):
if user_settings: