kerykeion 4.26.3__py3-none-any.whl → 5.0.0__py3-none-any.whl

kerykeion/house_comparison/house_comparison_utils.py

@@ -0,0 +1,126 @@
+"""
+House Comparison Utilities
+
+Utility functions for calculating house placement relationships between astrological subjects.
+Provides core calculation logic for determining where points from one subject fall within
+another subject's house system.
+
+Author: Giacomo Battaglia
+Copyright: (C) 2025 Kerykeion Project
+License: AGPL-3.0
+"""
+
+from kerykeion.schemas.kr_models import AstrologicalSubjectModel, PlanetReturnModel, PointInHouseModel
+from kerykeion.schemas.kr_literals import AstrologicalPoint
+from kerykeion.settings.config_constants import DEFAULT_ACTIVE_POINTS
+from kerykeion.utilities import get_planet_house, get_house_number
+from typing import Union
+
+
+def calculate_points_in_reciprocal_houses(
+    point_subject: Union[AstrologicalSubjectModel, PlanetReturnModel],
+    house_subject: Union[AstrologicalSubjectModel, PlanetReturnModel],
+    active_points: list[AstrologicalPoint] = DEFAULT_ACTIVE_POINTS,
+) -> list[PointInHouseModel]:
+    """
+    Calculate house placements of one subject's points within another subject's house system.
+
+    Analyzes where each astrological point from the point_subject falls within the
+    house structure of the house_subject. Creates detailed mapping including both
+    the point's original house position and its projected house placement.
+
+    Args:
+        point_subject: Subject whose astrological points are being analyzed
+        house_subject: Subject whose house system provides the projection framework
+        active_points: List of astrological points to include in the analysis.
+                      Defaults to standard active points configuration.
+
+    Returns:
+        list[PointInHouseModel]: List of point placement models containing detailed
+                                information about each point's house relationships,
+                                including original and projected house positions.
+
+    Note:
+        Only processes points that exist in both the point_subject's active_points
+        and the provided active_points list. Points with None values are skipped.
+
+    Example:
+        >>> points_in_houses = calculate_points_in_reciprocal_houses(
+        ...     natal_chart, partner_chart, ["Sun", "Moon"]
+        ... )
+        >>> sun_placement = points_in_houses[0]  # Assuming Sun is first
+        >>> print(f"Sun falls in house: {sun_placement.projected_house_name}")
+    """
+    points_in_houses: list[PointInHouseModel] = []
+
+    # List of points to consider
+    celestial_points = []
+
+    for point in point_subject.active_points:
+        if point not in active_points:
+            continue
+
+        point_obj = getattr(point_subject, point.lower())
+        if point_obj is not None:
+            celestial_points.append(point_obj)
+
+    # Ordered list of house cusps degrees for house_subject
+    house_cusps = [
+        house_subject.first_house.abs_pos,
+        house_subject.second_house.abs_pos,
+        house_subject.third_house.abs_pos,
+        house_subject.fourth_house.abs_pos,
+        house_subject.fifth_house.abs_pos,
+        house_subject.sixth_house.abs_pos,
+        house_subject.seventh_house.abs_pos,
+        house_subject.eighth_house.abs_pos,
+        house_subject.ninth_house.abs_pos,
+        house_subject.tenth_house.abs_pos,
+        house_subject.eleventh_house.abs_pos,
+        house_subject.twelfth_house.abs_pos,
+    ]
+
+    # Ordered list of house cusps degrees for point_subject
+    point_subject_house_cusps = [
+        point_subject.first_house.abs_pos,
+        point_subject.second_house.abs_pos,
+        point_subject.third_house.abs_pos,
+        point_subject.fourth_house.abs_pos,
+        point_subject.fifth_house.abs_pos,
+        point_subject.sixth_house.abs_pos,
+        point_subject.seventh_house.abs_pos,
+        point_subject.eighth_house.abs_pos,
+        point_subject.ninth_house.abs_pos,
+        point_subject.tenth_house.abs_pos,
+        point_subject.eleventh_house.abs_pos,
+        point_subject.twelfth_house.abs_pos,
+    ]
+
+    # For each point, determine which house it falls in
+    for point in celestial_points:
+        if point is None:
+            continue
+
+        point_degree = point.abs_pos
+        house_name = get_planet_house(point_degree, house_cusps)
+        house_number = get_house_number(house_name)
+
+        # Find which house the point is in its own chart (point_subject)
+        point_owner_house_name = get_planet_house(point_degree, point_subject_house_cusps)
+        point_owner_house_number = get_house_number(point_owner_house_name)
+
+        point_in_house = PointInHouseModel(
+            point_name=point.name,
+            point_degree=point.position,
+            point_sign=point.sign,
+            point_owner_name=point_subject.name,
+            point_owner_house_name=point_owner_house_name,
+            point_owner_house_number=point_owner_house_number,
+            projected_house_number=house_number,
+            projected_house_name=house_name,
+            projected_house_owner_name=house_subject.name,
+        )
+
+        points_in_houses.append(point_in_house)
+
+    return points_in_houses

kerykeion/kr_types/__init__.py

@@ -1,10 +1,70 @@
 # -*- coding: utf-8 -*-
 """
-    This is part of Kerykeion (C) 2025 Giacomo Battaglia
+Backward compatibility module for Kerykeion v4.x imports.
+
+DEPRECATED: This module will be removed in Kerykeion v6.0.
+Please update your imports:
+    OLD: from kerykeion.kr_types import ...
+    NEW: from kerykeion.schemas import ...
 """
+import warnings
+
+# Issue deprecation warning when this module is imported
+warnings.warn(
+    "The 'kerykeion.kr_types' module is deprecated and will be removed in v6.0. "
+    "Please update your imports to use 'kerykeion.schemas' instead.",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+# Re-export everything from schemas for backward compatibility
+from kerykeion.schemas import *  # noqa: F401, F403
+from kerykeion.schemas.kerykeion_exception import *  # noqa: F401, F403
+from kerykeion.schemas.kr_literals import *  # noqa: F401, F403
+from kerykeion.schemas.kr_models import *  # noqa: F401, F403
+from kerykeion.schemas.settings_models import *  # noqa: F401, F403
+from kerykeion.schemas.chart_template_model import *  # noqa: F401, F403
 
-from .kerykeion_exception import KerykeionException
-from .kr_literals import *
-from .kr_models import *
-from .chart_types import ChartTemplateDictionary
-from .settings_models import KerykeionSettingsModel
+__all__ = [
+    # Re-export from schemas
+    "KerykeionException",
+    # kr_literals
+    "ZodiacType",
+    "Sign",
+    "SignNumbers",
+    "AspectMovementType",
+    "Houses",
+    "HouseNumbers",
+    "AstrologicalPoint",
+    "Element",
+    "Quality",
+    "ChartType",
+    "PointType",
+    "LunarPhaseEmoji",
+    "LunarPhaseName",
+    "SiderealMode",
+    "HousesSystemIdentifier",
+    "PerspectiveType",
+    "SignsEmoji",
+    "KerykeionChartTheme",
+    "KerykeionChartLanguage",
+    "RelationshipScoreDescription",
+    "CompositeChartType",
+    "AspectName",
+    # kr_models
+    "AstrologicalSubjectModel",
+    "CompositeSubjectModel",
+    "KerykeionPointModel",
+    "AspectModel",
+    "ActiveAspect",
+    "SingleChartAspectsModel",
+    "DualChartAspectsModel",
+    "ElementDistributionModel",
+    "QualityDistributionModel",
+    "SingleChartDataModel",
+    "DualChartDataModel",
+    # settings_models
+    "KerykeionSettingsModel",
+    # chart_template_model
+    "ChartTemplateModel",
+]

kerykeion/kr_types/chart_template_model.py

@@ -0,0 +1,20 @@
+# -*- coding: utf-8 -*-
+"""
+Backward compatibility module for chart_template_model.
+
+DEPRECATED: This module will be removed in Kerykeion v6.0.
+Please update your imports:
+    OLD: from kerykeion.kr_types.chart_template_model import ...
+    NEW: from kerykeion.schemas.chart_template_model import ...
+"""
+import warnings
+
+warnings.warn(
+    "The 'kerykeion.kr_types.chart_template_model' module is deprecated and will be removed in v6.0. "
+    "Please update your imports to use 'kerykeion.schemas.chart_template_model' instead.",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+# Re-export everything from schemas.chart_template_model for backward compatibility
+from kerykeion.schemas.chart_template_model import *  # noqa: F401, F403

kerykeion/kr_types/kerykeion_exception.py

@@ -1,14 +1,20 @@
 # -*- coding: utf-8 -*-
 """
-    This is part of Kerykeion (C) 2025 Giacomo Battaglia
-"""
+Backward compatibility module for kerykeion_exception.
 
+DEPRECATED: This module will be removed in Kerykeion v6.0.
+Please update your imports:
+    OLD: from kerykeion.kr_types.kerykeion_exception import ...
+    NEW: from kerykeion.schemas.kerykeion_exception import ...
+"""
+import warnings
 
-class KerykeionException(Exception):
-    """
-    Custom Kerykeion Exception
-    """
+warnings.warn(
+    "The 'kerykeion.kr_types.kerykeion_exception' module is deprecated and will be removed in v6.0. "
+    "Please update your imports to use 'kerykeion.schemas.kerykeion_exception' instead.",
+    DeprecationWarning,
+    stacklevel=2,
+)
 
-    def __init__(self, message):
-        # Call the base class constructor with the parameters it needs
-        super().__init__(message)
+# Re-export everything from schemas.kerykeion_exception for backward compatibility
+from kerykeion.schemas.kerykeion_exception import *  # noqa: F401, F403

kerykeion/kr_types/kr_literals.py

@@ -1,138 +1,20 @@
 # -*- coding: utf-8 -*-
 """
-This is part of Kerykeion (C) 2025 Giacomo Battaglia
-"""
-from typing import Literal
-
-
-ZodiacType = Literal["Tropic", "Sidereal"]
-"""Literal type for Zodiac Types"""
-
-
-Sign = Literal["Ari", "Tau", "Gem", "Can", "Leo", "Vir", "Lib", "Sco", "Sag", "Cap", "Aqu", "Pis"]
-"""Literal type for Zodiac Signs"""
-
-
-SignNumbers = Literal[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11]
-"""Literal type for Zodiac Sign Numbers, the signs are numbered in order starting from Aries (0) to Pis (11)"""
-
-
-Houses = Literal["First_House", "Second_House", "Third_House", "Fourth_House", "Fifth_House", "Sixth_House", "Seventh_House", "Eighth_House", "Ninth_House", "Tenth_House", "Eleventh_House", "Twelfth_House"]
-"""Literal type for Houses"""
-
-
-HouseNumbers = Literal[1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12]
-"""Literal type for House Numbers, starting from the First House (1) to the Twelfth House (12)"""
-
-
-Planet = Literal["Sun", "Moon", "Mercury", "Venus", "Mars", "Jupiter", "Saturn", "Uranus", "Neptune", "Pluto", "Mean_Node", "True_Node", "Mean_South_Node", "True_South_Node", "Chiron", "Mean_Lilith"]
-"""Literal type for Planets"""
-
-AxialCusps = Literal["Ascendant", "Medium_Coeli", "Descendant", "Imum_Coeli"]
-"""Literal type for Axial Cusps"""
-
-
-Element = Literal["Air", "Fire", "Earth", "Water"]
-"""Literal type for Elements"""
-
-
-Quality = Literal["Cardinal", "Fixed", "Mutable"]
-"""Literal type for Qualities"""
-
-
-ChartType = Literal["Natal", "ExternalNatal", "Synastry", "Transit", "Composite"]
-"""Literal type for Chart Types"""
-
-
-PointType = Literal["Planet", "House", "AxialCusps"]
-"""Literal type for Point Types"""
-
+Backward compatibility module for kr_literals.
 
-LunarPhaseEmoji = Literal["🌑", "🌒", "🌓", "🌔", "🌕", "🌖", "🌗", "🌘"]
-"""Literal type for Lunar Phases Emoji"""
-
-
-LunarPhaseName = Literal["New Moon", "Waxing Crescent", "First Quarter", "Waxing Gibbous", "Full Moon", "Waning Gibbous", "Last Quarter", "Waning Crescent"]
-"""Literal type for Lunar Phases Name"""
-
-
-SiderealMode = Literal["FAGAN_BRADLEY", "LAHIRI", "DELUCE", "RAMAN", "USHASHASHI", "KRISHNAMURTI", "DJWHAL_KHUL", "YUKTESHWAR", "JN_BHASIN", "BABYL_KUGLER1", "BABYL_KUGLER2", "BABYL_KUGLER3", "BABYL_HUBER", "BABYL_ETPSC", "ALDEBARAN_15TAU", "HIPPARCHOS", "SASSANIAN", "J2000", "J1900", "B1950"]
-"""Literal type for Sidereal Modes, as known as Ayanamsa"""
-
-
-HousesSystemIdentifier = Literal["A", "B", "C", "D", "F", "H", "I", "i", "K", "L", "M", "N", "O", "P", "Q", "R", "S", "T", "U", "V", "W", "X", "Y"]
-"""
-Literal type for Houses Systems:
-
-A = equal
-B = Alcabitius
-C = Campanus
-D = equal (MC)
-F = Carter poli-equ.
-H = horizon/azimut
-I = Sunshine
-i = Sunshine/alt.
-K = Koch
-L = Pullen SD
-M = Morinus
-N = equal/1=Aries
-O = Porphyry
-P = Placidus
-Q = Pullen SR
-R = Regiomontanus
-S = Sripati
-T = Polich/Page
-U = Krusinski-Pisa-Goelzer
-V = equal/Vehlow
-W = equal/whole sign
-X = axial rotation system/Meridian houses
-Y = APC houses
-
-Usually the standard is Placidus (P)
-"""
-
-
-PerspectiveType = Literal["Apparent Geocentric", "Heliocentric", "Topocentric", "True Geocentric"]
-"""
-Literal type for perspective types.
-- "Apparent Geocentric": Earth-centered, apparent positions.
-- "Heliocentric": Sun-centered.
-- "Topocentric": Observer's location on Earth's surface.
-- "True Geocentric": Earth-centered, true positions.
-
-Usually the standard is "Apparent Geocentric"
+DEPRECATED: This module will be removed in Kerykeion v6.0.
+Please update your imports:
+    OLD: from kerykeion.kr_types.kr_literals import ...
+    NEW: from kerykeion.schemas.kr_literals import ...
 """
+import warnings
 
+warnings.warn(
+    "The 'kerykeion.kr_types.kr_literals' module is deprecated and will be removed in v6.0. "
+    "Please update your imports to use 'kerykeion.schemas.kr_literals' instead.",
+    DeprecationWarning,
+    stacklevel=2,
+)
 
-SignsEmoji = Literal["♈️", "♉️", "♊️", "♋️", "♌️", "♍️", "♎️", "♏️", "♐️", "♑️", "♒️", "♓️"]
-"""Literal type for Zodiac Signs Emoji"""
-
-KerykeionChartTheme = Literal["light", "dark", "dark-high-contrast", "classic"]
-"""Literal type for Kerykeion Chart Themes"""
-
-
-KerykeionChartLanguage = Literal["EN", "FR", "PT", "IT", "CN", "ES", "RU", "TR", "DE", "HI"]
-"""Literal type for Kerykeion Chart Languages"""
-
-
-RelationshipScoreDescription = Literal["Minimal", "Medium", "Important", "Very Important", "Exceptional", "Rare Exceptional"]
-"""Literal type for Relationship Score Description"""
-
-
-CompositeChartType = Literal["Midpoint"]
-"""Literal type for Composite Chart Types"""
-
-AspectName = Literal[
-    "conjunction",
-    "semi-sextile",
-    "semi-square",
-    "sextile",
-    "quintile",
-    "square",
-    "trine",
-    "sesquiquadrate",
-    "biquintile",
-    "quincunx",
-    "opposition"
-]
-"""Literal type for all the available aspects names"""
+# Re-export everything from schemas.kr_literals for backward compatibility
+from kerykeion.schemas.kr_literals import *  # noqa: F401, F403