mirror of
https://github.com/graphql-python/graphene-django.git
synced 2024-11-22 17:47:12 +03:00
3058118e8f
* Update Django's main branch name * Add Python 3.9 to tox * Update base gh action versions * Add Django 3.2 to tests * Remove redundant Django 1.11 references * Update setup.py for new Django and Python versions
141 lines
4.5 KiB
Python
141 lines
4.5 KiB
Python
"""
|
|
Settings for Graphene are all namespaced in the GRAPHENE setting.
|
|
For example your project's `settings.py` file might look like this:
|
|
GRAPHENE = {
|
|
'SCHEMA': 'my_app.schema.schema'
|
|
'MIDDLEWARE': (
|
|
'graphene_django.debug.DjangoDebugMiddleware',
|
|
)
|
|
}
|
|
This module provides the `graphene_settings` object, that is used to access
|
|
Graphene settings, checking for user settings first, then falling
|
|
back to the defaults.
|
|
"""
|
|
from __future__ import unicode_literals
|
|
|
|
from django.conf import settings
|
|
from django.test.signals import setting_changed
|
|
|
|
import importlib # Available in Python 3.1+
|
|
|
|
|
|
# Copied shamelessly from Django REST Framework
|
|
|
|
DEFAULTS = {
|
|
"SCHEMA": None,
|
|
"SCHEMA_OUTPUT": "schema.json",
|
|
"SCHEMA_INDENT": 2,
|
|
"MIDDLEWARE": (),
|
|
# Set to True if the connection fields must have
|
|
# either the first or last argument
|
|
"RELAY_CONNECTION_ENFORCE_FIRST_OR_LAST": False,
|
|
# Max items returned in ConnectionFields / FilterConnectionFields
|
|
"RELAY_CONNECTION_MAX_LIMIT": 100,
|
|
"CAMELCASE_ERRORS": True,
|
|
# Set to True to enable v2 naming convention for choice field Enum's
|
|
"DJANGO_CHOICE_FIELD_ENUM_V2_NAMING": False,
|
|
"DJANGO_CHOICE_FIELD_ENUM_CUSTOM_NAME": None,
|
|
# Use a separate path for handling subscriptions.
|
|
"SUBSCRIPTION_PATH": None,
|
|
# By default GraphiQL headers editor tab is enabled, set to False to hide it
|
|
# This sets headerEditorEnabled GraphiQL option, for details go to
|
|
# https://github.com/graphql/graphiql/tree/main/packages/graphiql#options
|
|
"GRAPHIQL_HEADER_EDITOR_ENABLED": True,
|
|
"ATOMIC_MUTATIONS": False,
|
|
}
|
|
|
|
if settings.DEBUG:
|
|
DEFAULTS["MIDDLEWARE"] += ("graphene_django.debug.DjangoDebugMiddleware",)
|
|
|
|
# List of settings that may be in string import notation.
|
|
IMPORT_STRINGS = ("MIDDLEWARE", "SCHEMA")
|
|
|
|
|
|
def perform_import(val, setting_name):
|
|
"""
|
|
If the given setting is a string import notation,
|
|
then perform the necessary import or imports.
|
|
"""
|
|
if val is None:
|
|
return None
|
|
elif isinstance(val, str):
|
|
return import_from_string(val, setting_name)
|
|
elif isinstance(val, (list, tuple)):
|
|
return [import_from_string(item, setting_name) for item in val]
|
|
return val
|
|
|
|
|
|
def import_from_string(val, setting_name):
|
|
"""
|
|
Attempt to import a class from a string representation.
|
|
"""
|
|
try:
|
|
# Nod to tastypie's use of importlib.
|
|
parts = val.split(".")
|
|
module_path, class_name = ".".join(parts[:-1]), parts[-1]
|
|
module = importlib.import_module(module_path)
|
|
return getattr(module, class_name)
|
|
except (ImportError, AttributeError) as e:
|
|
msg = "Could not import '%s' for Graphene setting '%s'. %s: %s." % (
|
|
val,
|
|
setting_name,
|
|
e.__class__.__name__,
|
|
e,
|
|
)
|
|
raise ImportError(msg)
|
|
|
|
|
|
class GrapheneSettings(object):
|
|
"""
|
|
A settings object, that allows API settings to be accessed as properties.
|
|
For example:
|
|
from graphene_django.settings import settings
|
|
print(settings.SCHEMA)
|
|
Any setting with string import paths will be automatically resolved
|
|
and return the class, rather than the string literal.
|
|
"""
|
|
|
|
def __init__(self, user_settings=None, defaults=None, import_strings=None):
|
|
if user_settings:
|
|
self._user_settings = user_settings
|
|
self.defaults = defaults or DEFAULTS
|
|
self.import_strings = import_strings or IMPORT_STRINGS
|
|
|
|
@property
|
|
def user_settings(self):
|
|
if not hasattr(self, "_user_settings"):
|
|
self._user_settings = getattr(settings, "GRAPHENE", {})
|
|
return self._user_settings
|
|
|
|
def __getattr__(self, attr):
|
|
if attr not in self.defaults:
|
|
raise AttributeError("Invalid Graphene setting: '%s'" % attr)
|
|
|
|
try:
|
|
# Check if present in user settings
|
|
val = self.user_settings[attr]
|
|
except KeyError:
|
|
# Fall back to defaults
|
|
val = self.defaults[attr]
|
|
|
|
# Coerce import strings into classes
|
|
if attr in self.import_strings:
|
|
val = perform_import(val, attr)
|
|
|
|
# Cache the result
|
|
setattr(self, attr, val)
|
|
return val
|
|
|
|
|
|
graphene_settings = GrapheneSettings(None, DEFAULTS, IMPORT_STRINGS)
|
|
|
|
|
|
def reload_graphene_settings(*args, **kwargs):
|
|
global graphene_settings
|
|
setting, value = kwargs["setting"], kwargs["value"]
|
|
if setting == "GRAPHENE":
|
|
graphene_settings = GrapheneSettings(value, DEFAULTS, IMPORT_STRINGS)
|
|
|
|
|
|
setting_changed.connect(reload_graphene_settings)
|