372 lines
11 KiB
Python
372 lines
11 KiB
Python
from __future__ import annotations
|
|
|
|
import sys
|
|
|
|
from abc import ABCMeta
|
|
from inspect import getmembers, isclass, isdatadescriptor
|
|
from os import environ
|
|
from pathlib import Path
|
|
from typing import Any, Callable, Dict, Optional, Sequence, Union
|
|
from warnings import filterwarnings
|
|
|
|
from sanic.constants import LocalCertCreator
|
|
from sanic.errorpages import DEFAULT_FORMAT, check_error_format
|
|
from sanic.helpers import Default, _default
|
|
from sanic.http import Http
|
|
from sanic.log import error_logger
|
|
from sanic.utils import load_module_from_file_location, str_to_bool
|
|
|
|
|
|
if sys.version_info >= (3, 8):
|
|
from typing import Literal
|
|
|
|
FilterWarningType = Union[
|
|
Literal["default"],
|
|
Literal["error"],
|
|
Literal["ignore"],
|
|
Literal["always"],
|
|
Literal["module"],
|
|
Literal["once"],
|
|
]
|
|
else:
|
|
FilterWarningType = str
|
|
|
|
SANIC_PREFIX = "SANIC_"
|
|
|
|
|
|
DEFAULT_CONFIG = {
|
|
"_FALLBACK_ERROR_FORMAT": _default,
|
|
"ACCESS_LOG": False,
|
|
"AUTO_EXTEND": True,
|
|
"AUTO_RELOAD": False,
|
|
"EVENT_AUTOREGISTER": False,
|
|
"DEPRECATION_FILTER": "once",
|
|
"FORWARDED_FOR_HEADER": "X-Forwarded-For",
|
|
"FORWARDED_SECRET": None,
|
|
"GRACEFUL_SHUTDOWN_TIMEOUT": 15.0, # 15 sec
|
|
"INSPECTOR": False,
|
|
"INSPECTOR_HOST": "localhost",
|
|
"INSPECTOR_PORT": 6457,
|
|
"INSPECTOR_TLS_KEY": _default,
|
|
"INSPECTOR_TLS_CERT": _default,
|
|
"INSPECTOR_API_KEY": "",
|
|
"KEEP_ALIVE_TIMEOUT": 5, # 5 seconds
|
|
"KEEP_ALIVE": True,
|
|
"LOCAL_CERT_CREATOR": LocalCertCreator.AUTO,
|
|
"LOCAL_TLS_KEY": _default,
|
|
"LOCAL_TLS_CERT": _default,
|
|
"LOCALHOST": "localhost",
|
|
"MOTD": True,
|
|
"MOTD_DISPLAY": {},
|
|
"NOISY_EXCEPTIONS": False,
|
|
"PROXIES_COUNT": None,
|
|
"REAL_IP_HEADER": None,
|
|
"REQUEST_BUFFER_SIZE": 65536, # 64 KiB
|
|
"REQUEST_MAX_HEADER_SIZE": 8192, # 8 KiB, but cannot exceed 16384
|
|
"REQUEST_ID_HEADER": "X-Request-ID",
|
|
"REQUEST_MAX_SIZE": 100000000, # 100 megabytes
|
|
"REQUEST_TIMEOUT": 60, # 60 seconds
|
|
"RESPONSE_TIMEOUT": 60, # 60 seconds
|
|
"TLS_CERT_PASSWORD": "",
|
|
"TOUCHUP": _default,
|
|
"USE_UVLOOP": _default,
|
|
"WEBSOCKET_MAX_SIZE": 2**20, # 1 megabyte
|
|
"WEBSOCKET_PING_INTERVAL": 20,
|
|
"WEBSOCKET_PING_TIMEOUT": 20,
|
|
}
|
|
|
|
|
|
class DescriptorMeta(ABCMeta):
|
|
def __init__(cls, *_):
|
|
cls.__setters__ = {name for name, _ in getmembers(cls, cls._is_setter)}
|
|
|
|
@staticmethod
|
|
def _is_setter(member: object):
|
|
return isdatadescriptor(member) and hasattr(member, "setter")
|
|
|
|
|
|
class Config(dict, metaclass=DescriptorMeta):
|
|
ACCESS_LOG: bool
|
|
AUTO_EXTEND: bool
|
|
AUTO_RELOAD: bool
|
|
EVENT_AUTOREGISTER: bool
|
|
DEPRECATION_FILTER: FilterWarningType
|
|
FORWARDED_FOR_HEADER: str
|
|
FORWARDED_SECRET: Optional[str]
|
|
GRACEFUL_SHUTDOWN_TIMEOUT: float
|
|
INSPECTOR: bool
|
|
INSPECTOR_HOST: str
|
|
INSPECTOR_PORT: int
|
|
INSPECTOR_TLS_KEY: Union[Path, str, Default]
|
|
INSPECTOR_TLS_CERT: Union[Path, str, Default]
|
|
INSPECTOR_API_KEY: str
|
|
KEEP_ALIVE_TIMEOUT: int
|
|
KEEP_ALIVE: bool
|
|
LOCAL_CERT_CREATOR: Union[str, LocalCertCreator]
|
|
LOCAL_TLS_KEY: Union[Path, str, Default]
|
|
LOCAL_TLS_CERT: Union[Path, str, Default]
|
|
LOCALHOST: str
|
|
MOTD: bool
|
|
MOTD_DISPLAY: Dict[str, str]
|
|
NOISY_EXCEPTIONS: bool
|
|
PROXIES_COUNT: Optional[int]
|
|
REAL_IP_HEADER: Optional[str]
|
|
REQUEST_BUFFER_SIZE: int
|
|
REQUEST_MAX_HEADER_SIZE: int
|
|
REQUEST_ID_HEADER: str
|
|
REQUEST_MAX_SIZE: int
|
|
REQUEST_TIMEOUT: int
|
|
RESPONSE_TIMEOUT: int
|
|
SERVER_NAME: str
|
|
TLS_CERT_PASSWORD: str
|
|
TOUCHUP: Union[Default, bool]
|
|
USE_UVLOOP: Union[Default, bool]
|
|
WEBSOCKET_MAX_SIZE: int
|
|
WEBSOCKET_PING_INTERVAL: int
|
|
WEBSOCKET_PING_TIMEOUT: int
|
|
|
|
def __init__(
|
|
self,
|
|
defaults: Optional[
|
|
Dict[str, Union[str, bool, int, float, None]]
|
|
] = None,
|
|
env_prefix: Optional[str] = SANIC_PREFIX,
|
|
keep_alive: Optional[bool] = None,
|
|
*,
|
|
converters: Optional[Sequence[Callable[[str], Any]]] = None,
|
|
):
|
|
defaults = defaults or {}
|
|
super().__init__({**DEFAULT_CONFIG, **defaults})
|
|
self._configure_warnings()
|
|
|
|
self._converters = [str, str_to_bool, float, int]
|
|
|
|
if converters:
|
|
for converter in converters:
|
|
self.register_type(converter)
|
|
|
|
if keep_alive is not None:
|
|
self.KEEP_ALIVE = keep_alive
|
|
|
|
if env_prefix != SANIC_PREFIX:
|
|
if env_prefix:
|
|
self.load_environment_vars(env_prefix)
|
|
else:
|
|
self.load_environment_vars(SANIC_PREFIX)
|
|
|
|
self._configure_header_size()
|
|
self._check_error_format()
|
|
self._init = True
|
|
|
|
def __getattr__(self, attr: Any):
|
|
try:
|
|
return self[attr]
|
|
except KeyError as ke:
|
|
raise AttributeError(f"Config has no '{ke.args[0]}'")
|
|
|
|
def __setattr__(self, attr: str, value: Any) -> None:
|
|
self.update({attr: value})
|
|
|
|
def __setitem__(self, attr: str, value: Any) -> None:
|
|
self.update({attr: value})
|
|
|
|
def update(self, *other: Any, **kwargs: Any) -> None:
|
|
kwargs.update({k: v for item in other for k, v in dict(item).items()})
|
|
setters: Dict[str, Any] = {
|
|
k: kwargs.pop(k)
|
|
for k in {**kwargs}.keys()
|
|
if k in self.__class__.__setters__
|
|
}
|
|
|
|
for key, value in setters.items():
|
|
try:
|
|
super().__setattr__(key, value)
|
|
except AttributeError:
|
|
...
|
|
|
|
super().update(**kwargs)
|
|
for attr, value in {**setters, **kwargs}.items():
|
|
self._post_set(attr, value)
|
|
|
|
def _post_set(self, attr, value) -> None:
|
|
if self.get("_init"):
|
|
if attr in (
|
|
"REQUEST_MAX_HEADER_SIZE",
|
|
"REQUEST_BUFFER_SIZE",
|
|
"REQUEST_MAX_SIZE",
|
|
):
|
|
self._configure_header_size()
|
|
|
|
if attr == "LOCAL_CERT_CREATOR" and not isinstance(
|
|
self.LOCAL_CERT_CREATOR, LocalCertCreator
|
|
):
|
|
self.LOCAL_CERT_CREATOR = LocalCertCreator[
|
|
self.LOCAL_CERT_CREATOR.upper()
|
|
]
|
|
elif attr == "DEPRECATION_FILTER":
|
|
self._configure_warnings()
|
|
|
|
@property
|
|
def FALLBACK_ERROR_FORMAT(self) -> str:
|
|
if isinstance(self._FALLBACK_ERROR_FORMAT, Default):
|
|
return DEFAULT_FORMAT
|
|
return self._FALLBACK_ERROR_FORMAT
|
|
|
|
@FALLBACK_ERROR_FORMAT.setter
|
|
def FALLBACK_ERROR_FORMAT(self, value):
|
|
self._check_error_format(value)
|
|
if (
|
|
not isinstance(self._FALLBACK_ERROR_FORMAT, Default)
|
|
and value != self._FALLBACK_ERROR_FORMAT
|
|
):
|
|
error_logger.warning(
|
|
"Setting config.FALLBACK_ERROR_FORMAT on an already "
|
|
"configured value may have unintended consequences."
|
|
)
|
|
self._FALLBACK_ERROR_FORMAT = value
|
|
|
|
def _configure_header_size(self):
|
|
Http.set_header_max_size(
|
|
self.REQUEST_MAX_HEADER_SIZE,
|
|
self.REQUEST_BUFFER_SIZE - 4096,
|
|
self.REQUEST_MAX_SIZE,
|
|
)
|
|
|
|
def _configure_warnings(self):
|
|
filterwarnings(
|
|
self.DEPRECATION_FILTER,
|
|
category=DeprecationWarning,
|
|
module=r"sanic.*",
|
|
)
|
|
|
|
def _check_error_format(self, format: Optional[str] = None):
|
|
check_error_format(format or self.FALLBACK_ERROR_FORMAT)
|
|
|
|
def load_environment_vars(self, prefix=SANIC_PREFIX):
|
|
"""
|
|
Looks for prefixed environment variables and applies them to the
|
|
configuration if present. This is called automatically when Sanic
|
|
starts up to load environment variables into config. Environment
|
|
variables should start with the defined prefix and should only
|
|
contain uppercase letters.
|
|
|
|
It will automatically hydrate the following types:
|
|
|
|
- ``int``
|
|
- ``float``
|
|
- ``bool``
|
|
|
|
Anything else will be imported as a ``str``. If you would like to add
|
|
additional types to this list, you can use
|
|
:meth:`sanic.config.Config.register_type`. Just make sure that they
|
|
are registered before you instantiate your application.
|
|
|
|
.. code-block:: python
|
|
|
|
class Foo:
|
|
def __init__(self, name) -> None:
|
|
self.name = name
|
|
|
|
|
|
config = Config(converters=[Foo])
|
|
app = Sanic(__name__, config=config)
|
|
|
|
`See user guide re: config
|
|
<https://sanicframework.org/guide/deployment/configuration.html>`__
|
|
"""
|
|
for key, value in environ.items():
|
|
if not key.startswith(prefix) or not key.isupper():
|
|
continue
|
|
|
|
_, config_key = key.split(prefix, 1)
|
|
|
|
for converter in reversed(self._converters):
|
|
try:
|
|
self[config_key] = converter(value)
|
|
break
|
|
except ValueError:
|
|
pass
|
|
|
|
def update_config(self, config: Union[bytes, str, dict, Any]):
|
|
"""
|
|
Update app.config.
|
|
|
|
.. note::
|
|
|
|
Only upper case settings are considered
|
|
|
|
You can upload app config by providing path to py file
|
|
holding settings.
|
|
|
|
.. code-block:: python
|
|
|
|
# /some/py/file
|
|
A = 1
|
|
B = 2
|
|
|
|
.. code-block:: python
|
|
|
|
config.update_config("${some}/py/file")
|
|
|
|
Yes you can put environment variable here, but they must be provided
|
|
in format: ``${some_env_var}``, and mark that ``$some_env_var`` is
|
|
treated as plain string.
|
|
|
|
You can upload app config by providing dict holding settings.
|
|
|
|
.. code-block:: python
|
|
|
|
d = {"A": 1, "B": 2}
|
|
config.update_config(d)
|
|
|
|
You can upload app config by providing any object holding settings,
|
|
but in such case config.__dict__ will be used as dict holding settings.
|
|
|
|
.. code-block:: python
|
|
|
|
class C:
|
|
A = 1
|
|
B = 2
|
|
|
|
config.update_config(C)
|
|
|
|
`See user guide re: config
|
|
<https://sanicframework.org/guide/deployment/configuration.html>`__
|
|
"""
|
|
|
|
if isinstance(config, (bytes, str, Path)):
|
|
config = load_module_from_file_location(location=config)
|
|
|
|
if not isinstance(config, dict):
|
|
cfg = {}
|
|
if not isclass(config):
|
|
cfg.update(
|
|
{
|
|
key: getattr(config, key)
|
|
for key in config.__class__.__dict__.keys()
|
|
}
|
|
)
|
|
|
|
config = dict(config.__dict__)
|
|
config.update(cfg)
|
|
|
|
config = dict(filter(lambda i: i[0].isupper(), config.items()))
|
|
|
|
self.update(config)
|
|
|
|
load = update_config
|
|
|
|
def register_type(self, converter: Callable[[str], Any]) -> None:
|
|
"""
|
|
Allows for adding custom function to cast from a string value to any
|
|
other type. The function should raise ValueError if it is not the
|
|
correct type.
|
|
"""
|
|
if converter in self._converters:
|
|
error_logger.warning(
|
|
f"Configuration value converter '{converter.__name__}' has "
|
|
"already been registered"
|
|
)
|
|
return
|
|
self._converters.append(converter)
|