Merge pull request #5 from dymmond/feature/settings_module

Add reload optional for settings

docs/release-notes.md

@@ -1,8 +1,17 @@
 # Release Notes
 
+## 1.0.5
+
+### Added
+
+- `reload_settings` allowing to reset the internals of the default global settings.
+- `configure` allowing to set a new global lazy settings.
+
 ## 1.0.4
 
-- Fix global settings reference.
+### Fixed
+
+- Global settings reference.
 
 ## 1.0.3
 

dymmond_settings/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "1.0.4"
+__version__ = "1.0.5"
 
 from .base import Settings
 from .conf import settings

dymmond_settings/conf.py

@@ -1,4 +1,5 @@
 import os
+from functools import lru_cache
 from typing import TYPE_CHECKING, Any, Optional, Type
 
 from dymmond_settings.functional import LazyObject, empty
@@ -11,6 +12,17 @@
 ENVIRONMENT_VARIABLE = os.environ.get(OVERRIDE_VARIABLE) or "SETTINGS_MODULE"
 
 
+@lru_cache
+def reload_settings() -> Type["Settings"]:
+ """
+ Reloads the global settings.
+ """
+ settings_module: str = os.environ.get(ENVIRONMENT_VARIABLE, "dymmond_settings.base.Settings")
+ settings: Type["Settings"] = import_string(settings_module)
+
+ return settings
+
+
 class LazySettings(LazyObject):
  """
  A lazy proxy for either global application settings or a custom settings object.
@@ -24,17 +36,22 @@ def _setup(self, name: Optional[str] = None) -> None:
  is used the first time settings are needed, if the user hasn't
  configured settings manually.
  """
- settings_module: str = os.environ.get(
- ENVIRONMENT_VARIABLE, "dymmond_settings.base.Settings"
- )
 
- settings: Type["Settings"] = import_string(settings_module)
+ settings: Type["Settings"] = reload_settings()
 
  for setting, _ in settings().dict().items():
  assert setting.islower(), "%s should be in lower case." % setting
 
  self._wrapped = settings()
 
+ def configure(self, override_settings: "LazySettings") -> None:
+ """
+ Making sure the settings are overriden by the settings
+ provided by a given application and therefore use it as the application
+ global.
+ """
+ self._wrapped = override_settings
+
  def __repr__(self: "LazySettings") -> str:
  # Hardcode the class name as otherwise it yields 'Settings'.
  if self._wrapped is empty: