kerykeion 4.24.7__py3-none-any.whl → 4.25.1__py3-none-any.whl

kerykeion/utilities.py

@@ -1,4 +1,4 @@
-from kerykeion.kr_types import KerykeionPointModel, KerykeionException, ZodiacSignModel, AstrologicalSubjectModel
+from kerykeion.kr_types import KerykeionPointModel, KerykeionException, ZodiacSignModel, AstrologicalSubjectModel, LunarPhaseModel
 from kerykeion.kr_types.kr_literals import LunarPhaseEmoji, LunarPhaseName, PointType, Planet, Houses, AxialCusps
 from typing import Union, get_args, TYPE_CHECKING
 import logging
@@ -318,3 +318,75 @@ def get_available_astrological_points_list(subject: Union["AstrologicalSubject",
         planets_absolute_position_list.append(subject[axis.lower()])
 
     return planets_absolute_position_list
+
+
+def circular_mean(first_position: Union[int, float], second_position: Union[int, float]) -> float:
+    """
+    Computes the circular mean of two astrological positions (e.g., house cusps, planets).
+
+    This function ensures that positions crossing 0° Aries (360°) are correctly averaged,
+    avoiding errors that occur with simple linear means.
+
+    Args:
+        position1 (Union[int, float]): First position in degrees (0-360).
+        position2 (Union[int, float]): Second position in degrees (0-360).
+
+    Returns:
+        float: The circular mean position in degrees (0-360).
+    """
+    x = (math.cos(math.radians(first_position)) + math.cos(math.radians(second_position))) / 2
+    y = (math.sin(math.radians(first_position)) + math.sin(math.radians(second_position))) / 2
+    mean_position = math.degrees(math.atan2(y, x))
+
+    # Ensure the result is within 0-360°
+    if mean_position < 0:
+        mean_position += 360
+
+    return mean_position
+
+
+def calculate_moon_phase(moon_abs_pos: float, sun_abs_pos: float) -> LunarPhaseModel:
+    """
+    Calculate the lunar phase based on the positions of the moon and sun.
+
+    Args:
+    - moon_abs_pos (float): The absolute position of the moon.
+    - sun_abs_pos (float): The absolute position of the sun.
+
+    Returns:
+    - dict: A dictionary containing the lunar phase information.
+    """
+    # Initialize moon_phase and sun_phase to None in case of an error
+    moon_phase, sun_phase = None, None
+
+    # Calculate the anti-clockwise degrees between the sun and moon
+    degrees_between = (moon_abs_pos - sun_abs_pos) % 360
+
+    # Calculate the moon phase (1-28) based on the degrees between the sun and moon
+    step = 360.0 / 28.0
+    moon_phase = int(degrees_between // step) + 1
+
+    # Define the sun phase steps
+    sunstep = [
+        0, 30, 40, 50, 60, 70, 80, 90, 120, 130, 140, 150, 160, 170, 180,
+        210, 220, 230, 240, 250, 260, 270, 300, 310, 320, 330, 340, 350
+    ]
+
+    # Calculate the sun phase (1-28) based on the degrees between the sun and moon
+    for x in range(len(sunstep)):
+        low = sunstep[x]
+        high = sunstep[x + 1] if x < len(sunstep) - 1 else 360
+        if low <= degrees_between < high:
+            sun_phase = x + 1
+            break
+
+    # Create a dictionary with the lunar phase information
+    lunar_phase_dictionary = {
+        "degrees_between_s_m": degrees_between,
+        "moon_phase": moon_phase,
+        "sun_phase": sun_phase,
+        "moon_emoji": get_moon_emoji_from_phase_int(moon_phase),
+        "moon_phase_name": get_moon_phase_name_from_phase_int(moon_phase)
+    }
+
+    return LunarPhaseModel(**lunar_phase_dictionary)

{kerykeion-4.24.7.dist-info → kerykeion-4.25.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: kerykeion
-Version: 4.24.7
+Version: 4.25.1
 Summary: A python library for astrology.
 Home-page: https://www.kerykeion.net/
 License: AGPL-3.0
@@ -71,7 +71,7 @@ The core goal of this project is to provide a simple and easy approach to astrol
 
 Here's an example of a birthchart:
 
-![Kanye Birth Chart](https://www.kerykeion.net/docs/assets/img/examples/birth-chart.svg)
+![John Lenon Chart](https://raw.githubusercontent.com/g-battaglia/kerykeion/refs/heads/master/tests/charts/svg/John%20Lennon%20-%20Dark%20Theme%20-%20Natal%20Chart.svg)
 
 ## Web API
 

{kerykeion-4.24.7.dist-info → kerykeion-4.25.1.dist-info}/RECORD

@@ -1,43 +1,44 @@
 LICENSE,sha256=UTLH8EdbAsgQei4PA2PnBCPGLSZkq5J-dhkyJuXgWQU,34273
-kerykeion/__init__.py,sha256=XtKNBNSVsQ-PAbnJfNUcw-femdF4NgQqohMtM0cRH18,639
+kerykeion/__init__.py,sha256=5uWwosgfy16r2g4pl6TJsee8Nz5-UTrpyrH1KTgfvc8,702
 kerykeion/aspects/__init__.py,sha256=9kx_Rx1NJx5SM7nDCSbI79S1neZ3c-q2NvQr-S6A9PY,292
 kerykeion/aspects/aspects_utils.py,sha256=Ej-E7Uvfi8x_ydP9dOhzhCp2uSpvX67T_VXuOjEKdoQ,3071
-kerykeion/aspects/natal_aspects.py,sha256=LHSorTAMLry-0KJWRZ0QQCBiRbuYnZkoIEFVwaAG-e0,6585
+kerykeion/aspects/natal_aspects.py,sha256=YAhf8Dqkx9kouealIzPae0VNK77P9-9oQhJw6dYXqo0,6661
 kerykeion/aspects/synastry_aspects.py,sha256=5vU8yJgAGRyVBoKvRpsg-0AcQg-imOzH91tvDM_RUNQ,5044
-kerykeion/astrological_subject.py,sha256=pzy9Fipg-ywCk5bZoGoA8bhs4M2r2JZBWoC3ZxHQrQ8,38245
+kerykeion/astrological_subject.py,sha256=643axkLtIVPkOOTHhB4InHYn3XVEOBZdXLS9B-N7kSQ,36451
 kerykeion/charts/__init__.py,sha256=i9NMZ7LdkllPlqQSi1or9gTobHbROGDKmJhBDO4R0mA,128
-kerykeion/charts/charts_utils.py,sha256=Oai_hlWIDjZ9MDs2werutMblOZqklf5FMl3l5oPN70w,42132
+kerykeion/charts/charts_utils.py,sha256=TGmya60LMswUvQMi6irJWaboK6QRWCZ52wv5FMgaUT8,40424
 kerykeion/charts/draw_planets.py,sha256=Uty3zpWYMQZvvK7ZHhlmynCHeL8DIN3qL2ifnBXVciM,17393
-kerykeion/charts/kerykeion_chart_svg.py,sha256=DbtfKA3ieM56YTSTBV3i1bd5zhDlsDyYafHRci6C_jw,46006
+kerykeion/charts/kerykeion_chart_svg.py,sha256=JPsNV7AAwYY1tQ8jNnc0TKEGXY-l-Ez3-Z632QcbR90,51221
 kerykeion/charts/templates/aspect_grid_only.xml,sha256=ZiBVeToVmCA8QxYlB_cfnsAO1NNeQAnJ_6rIYkr4F58,70091
-kerykeion/charts/templates/chart.xml,sha256=yr13hN0xsxvMQpVb9cMMK86lxrqy_PxGuOzj-4jdM4E,73733
+kerykeion/charts/templates/chart.xml,sha256=2p2LNNib9MfZiq521tFoEUwOBEN6KlbKOY4ZINdf7Dc,74985
 kerykeion/charts/templates/wheel_only.xml,sha256=E0JCxcnjTjxuaomw7PQEc_3xRVErj1y2hIOGTrShuhc,71304
 kerykeion/charts/themes/classic.css,sha256=-b6XllAZmqUDjBwDtIkfzfI3Wtc8AImuGMpfAQ_2wa0,3552
 kerykeion/charts/themes/dark-high-contrast.css,sha256=9tdyFC-4Ytnv4lrVwKnOjZJ0YNgbRrP_HNnfJRlnbn0,6099
 kerykeion/charts/themes/dark.css,sha256=ml2lnzQVuS5DhCdoeUrDmMv9kB1nNceRt7hHbOHSbjM,6099
 kerykeion/charts/themes/light.css,sha256=ALf5U8tQsb6ky0N9R7ZLOHDrfKEXNM-sBR3JIRxFrCI,6092
+kerykeion/composite_subject_factory.py,sha256=3wyY03mefF9OPfeFyV7Ck4BIq8oY-kSqkHi4f8Ap9B0,8049
 kerykeion/enums.py,sha256=nPXgP_ocsRnRno5H-yunZy3fp-hLZ9aYRaUb-2gBdvw,1199
 kerykeion/ephemeris_data.py,sha256=Cd5TK5nTkFHYU6bkLKjZRfiU4_6AgsWGcwBDrBHKrQk,8096
 kerykeion/fetch_geonames.py,sha256=e66Nh6yq9A4VjnuvVSiV1TW1IkJ9m3Q2LKPWrkOGgO0,4764
 kerykeion/kr_types/__init__.py,sha256=jshJOccCQcYZuoOvrILRZH6imy4RBvKpFPujlNLFyGE,295
-kerykeion/kr_types/chart_types.py,sha256=zO8pVFgklRFX60BS__CWAkFZ70v9ThKX2z1js-s1fQA,1986
+kerykeion/kr_types/chart_types.py,sha256=EFXTddX1wwTzbLSDKw_ipg4tbOihTKPEnn2T9ooFSig,2123
 kerykeion/kr_types/kerykeion_exception.py,sha256=kE1y0K0rmuz32b4K_ZppSsZ59I2Get0ZkvOkTE5HejI,314
-kerykeion/kr_types/kr_literals.py,sha256=UDTgG6Hoe2378WzLpobCpYy1gLcHulbiamP8l3_GgFw,4225
-kerykeion/kr_types/kr_models.py,sha256=bDV_xULcg8vdI40fFjcmMMPnSicHK0potZkEdQINHB4,4722
-kerykeion/kr_types/settings_models.py,sha256=D2a3PugfPKgx1_-oNsFPecxgdO0RiJlzacLxG6rQNaY,11779
+kerykeion/kr_types/kr_literals.py,sha256=b1JEgByA8-PWtkM8TdkNb2aePr8dUApI-OH3ciulJF8,4327
+kerykeion/kr_types/kr_models.py,sha256=N7VhwxcMkXMjn5UNArleuxZ684woJzBjvvNC1CF7ttg,6824
+kerykeion/kr_types/settings_models.py,sha256=kIq8If9rjnDhLUZ4y68fl0xcHTQoI9kbbny8NegPtsY,10968
 kerykeion/relationship_score/__init__.py,sha256=cLaEBQXQBfyRkv0OaS3ceLROzvWcvKXWiRq0PS6LDjY,114
 kerykeion/relationship_score/relationship_score.py,sha256=lJkSbHw9nOUaPMrPxqcGhnVQIwAgI52K8BQzXXswb6A,6504
-kerykeion/relationship_score/relationship_score_factory.py,sha256=NbQZ7jh2-7CGk83NWA8lfkJszT1uZAQQH9KtaUhdAo8,10962
+kerykeion/relationship_score/relationship_score_factory.py,sha256=wVdVomy_WlIvIvidnsf5a7jEZA8HJV8m8E3E_gia2yY,8651
 kerykeion/report.py,sha256=snqnrJzb89q2ixL74qS9ksvzNSh_WXtZ_haBOIvHYeY,2814
 kerykeion/settings/__init__.py,sha256=QQNFCl7sgN27MKaVscqtpPk10HGz4wZS3I_7KEGMaVA,69
 kerykeion/settings/config_constants.py,sha256=OUi28L2l8s09Df3GHiQUiBZuTjOdfL4A5zSRNqBRHc8,1255
 kerykeion/settings/kerykeion_settings.py,sha256=7GCGUzcctEg5uyWlzRk2YIotJSkCZDOVAo_CXwgMeK4,2934
-kerykeion/settings/kr.config.json,sha256=01xm7VOmGxMa86VM8VL8giYmnDTkfo2aE9qjIfIouM0,21113
+kerykeion/settings/kr.config.json,sha256=5ktsoMnuhY9eUpQHC8oNmRZqPC7Lt3ILgOucKQvsJkQ,42059
 kerykeion/sweph/README.md,sha256=L7FtNAJTWtrZNGKa8MX87SjduFYPYxwWhaI5fmtzNZo,73
 kerykeion/sweph/seas_18.se1,sha256=X9nCqhZU43wJpq61WAdueVQJt9xL2UjrwPqn1Kdoa1s,223002
-kerykeion/utilities.py,sha256=vuEDWs5Htl2zi6_3flLvlAsFC9YT9LaOQDpRirFf3Cg,11160
-kerykeion-4.24.7.dist-info/LICENSE,sha256=UTLH8EdbAsgQei4PA2PnBCPGLSZkq5J-dhkyJuXgWQU,34273
-kerykeion-4.24.7.dist-info/METADATA,sha256=G2rliphV4dNmNQELo_0TuLfJxCRb0qXn_hRe3QezRYE,17722
-kerykeion-4.24.7.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
-kerykeion-4.24.7.dist-info/entry_points.txt,sha256=5SmANYscFDDTdeovHvGQ-cnj0hdFvGoxPaWLCpyDFnQ,49
-kerykeion-4.24.7.dist-info/RECORD,,
+kerykeion/utilities.py,sha256=6TQpxENYDMacH4CsRJGJ4rmoV2Pn7pmQc8MTOUR2CSg,13824
+kerykeion-4.25.1.dist-info/LICENSE,sha256=UTLH8EdbAsgQei4PA2PnBCPGLSZkq5J-dhkyJuXgWQU,34273
+kerykeion-4.25.1.dist-info/METADATA,sha256=PQnqq2_2emnyReIYrR2P7io4x0WRQ3EFwftDiGA6cvc,17802
+kerykeion-4.25.1.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
+kerykeion-4.25.1.dist-info/entry_points.txt,sha256=5SmANYscFDDTdeovHvGQ-cnj0hdFvGoxPaWLCpyDFnQ,49
+kerykeion-4.25.1.dist-info/RECORD,,