kerykeion 3.1.1__py3-none-any.whl → 5.1.9__py3-none-any.whl

kerykeion/settings/config_constants.py

@@ -0,0 +1,152 @@
+from kerykeion.schemas.kr_literals import AstrologicalPoint
+from kerykeion.schemas.kr_models import ActiveAspect
+from typing import List
+
+
+DEFAULT_ACTIVE_POINTS: List[AstrologicalPoint] = [
+    "Sun",
+    "Moon",
+    "Mercury",
+    "Venus",
+    "Mars",
+    "Jupiter",
+    "Saturn",
+    "Uranus",
+    "Neptune",
+    "Pluto",
+    # "Mean_North_Lunar_Node",
+    "True_North_Lunar_Node",
+    # "Mean_South_Lunar_Node",
+    "True_South_Lunar_Node",
+    "Chiron",
+    "Mean_Lilith",
+    # "True_Lilith",
+    # "Earth",
+    # "Pholus",
+    # "Ceres",
+    # "Pallas",
+    # "Juno",
+    # "Vesta",
+    # "Eris",
+    # "Sedna",
+    # "Haumea",
+    # "Makemake",
+    # "Ixion",
+    # "Orcus",
+    # "Quaoar",
+    # "Regulus",
+    # "Spica",
+    "Ascendant",
+    "Medium_Coeli",
+    "Descendant",
+    "Imum_Coeli",
+    # "Vertex",
+    # "Anti_Vertex",
+    # "Pars_Fortunae",
+    # "Pars_Spiritus",
+    # "Pars_Amoris",
+    # "Pars_Fidei"
+]
+"""
+Default list of active points in the charts or aspects calculations.
+The full list of points is available in the `schemas.kr_literals.AstrologicalPoint` literal.
+"""
+
+ALL_ACTIVE_POINTS: List[AstrologicalPoint] = [
+    "Sun",
+    "Moon",
+    "Mercury",
+    "Venus",
+    "Mars",
+    "Jupiter",
+    "Saturn",
+    "Uranus",
+    "Neptune",
+    "Pluto",
+    "Mean_North_Lunar_Node",
+    "True_North_Lunar_Node",
+    "Mean_South_Lunar_Node",
+    "True_South_Lunar_Node",
+    "Chiron",
+    "Mean_Lilith",
+    "True_Lilith",
+    "Earth",
+    "Pholus",
+    "Ceres",
+    "Pallas",
+    "Juno",
+    "Vesta",
+    "Eris",
+    "Sedna",
+    "Haumea",
+    "Makemake",
+    "Ixion",
+    "Orcus",
+    "Quaoar",
+    "Regulus",
+    "Spica",
+    "Ascendant",
+    "Medium_Coeli",
+    "Descendant",
+    "Imum_Coeli",
+    "Vertex",
+    "Anti_Vertex",
+    "Pars_Fortunae",
+    "Pars_Spiritus",
+    "Pars_Amoris",
+    "Pars_Fidei"
+]
+"""
+Full list of active points in the charts or aspects calculations.
+The full list of points is available in the `schemas.kr_literals.AstrologicalPoint` literal.
+"""
+
+DEFAULT_ACTIVE_ASPECTS: List[ActiveAspect] = [
+    {"name": "conjunction", "orb": 10},
+    {"name": "opposition", "orb": 10},
+    {"name": "trine", "orb": 8},
+    {"name": "sextile", "orb": 6},
+    {"name": "square", "orb": 5},
+    {"name": "quintile", "orb": 1},
+    # {"name": "semi-sextile", "orb": 1},
+    # {"name": "semi-square", "orb": 1},
+    # {"name": "sesquiquadrate", "orb": 1},
+    # {"name": "biquintile", "orb": 1},
+    # {"name": "quincunx", "orb": 1},
+]
+"""
+Default list of active aspects in the aspects calculations.
+The full list of aspects is available in the `schemas.kr_literals.AspectName` literal.
+"""
+
+ALL_ACTIVE_ASPECTS: List[ActiveAspect] = [
+    {"name": "conjunction", "orb": 10},
+    {"name": "opposition", "orb": 10},
+    {"name": "trine", "orb": 8},
+    {"name": "sextile", "orb": 6},
+    {"name": "square", "orb": 5},
+    {"name": "quintile", "orb": 1},
+    {"name": "semi-sextile", "orb": 1},
+    {"name": "semi-square", "orb": 1},
+    {"name": "sesquiquadrate", "orb": 1},
+    {"name": "biquintile", "orb": 1},
+    {"name": "quincunx", "orb": 1},
+]
+"""
+Full list of active aspects in the charts or aspects calculations.
+The full list of aspects is available in the `schemas.kr_literals.AspectName` literal.
+"""
+
+DISCEPOLO_SCORE_ACTIVE_ASPECTS: List[ActiveAspect] = [
+    {"name": "conjunction", "orb": 8},
+    {"name": "semi-sextile", "orb": 2},
+    {"name": "semi-square", "orb": 2},
+    {"name": "sextile", "orb": 4},
+    {"name": "square", "orb": 5},
+    {"name": "trine", "orb": 7},
+    {"name": "sesquiquadrate", "orb": 2},
+    {"name": "opposition", "orb": 8},
+]
+"""
+List of active aspects with their orbs according to Ciro Discepolo's affinity scoring methodology.
+"""

kerykeion/settings/kerykeion_settings.py

@@ -0,0 +1,51 @@
+"""
+Utilities for loading Kerykeion configuration settings from Python sources.
+
+The translation strings are now stored directly in :mod:`translation_strings`,
+so the loader simply wraps those dictionaries (or any user-provided overrides).
+"""
+
+from __future__ import annotations
+
+from copy import deepcopy
+from typing import Any, Mapping, Optional, cast
+
+from .translation_strings import LANGUAGE_SETTINGS
+
+SettingsSource = Optional[Mapping[str, Any]]
+
+
+def load_settings_mapping(settings_source: Optional[SettingsSource] = None) -> Mapping[str, Any]:
+    """
+    Resolve the configuration mapping from the provided source.
+
+    Args:
+        settings_source (Mapping | None): Optional overrides for the bundled
+            language settings. When provided, keys and nested dictionaries are
+            merged on top of the default values.
+
+    Returns:
+        Mapping[str, Any]: The resolved configuration dictionary.
+    """
+    language_settings = deepcopy(LANGUAGE_SETTINGS)
+
+    if settings_source:
+        overrides = cast(Mapping[str, Any], settings_source)
+        if "language_settings" in overrides:
+            overrides = cast(Mapping[str, Any], overrides["language_settings"])
+        language_settings = _deep_merge(language_settings, overrides)
+
+    return {"language_settings": language_settings}
+
+
+def _deep_merge(base: Mapping[str, Any], overrides: Mapping[str, Any]) -> dict[str, Any]:
+    merged: dict[str, Any] = {key: deepcopy(value) for key, value in base.items()}
+    for key, value in overrides.items():
+        if key in merged and isinstance(merged[key], Mapping) and isinstance(value, Mapping):
+            merged[key] = _deep_merge(cast(Mapping[str, Any], merged[key]), cast(Mapping[str, Any], value))
+        else:
+            merged[key] = deepcopy(value)
+    return merged
+
+# Keep the public surface area explicit for downstream imports.
+__all__ = ["SettingsSource", "load_settings_mapping", "LANGUAGE_SETTINGS"]