solarmoonpy 1.0.3__py3-none-any.whl → 1.0.4__py3-none-any.whl

solarmoonpy/moon.py

@@ -374,4 +374,54 @@ def moon_elongation(date_utc: date) -> float:
     jc = julianday_to_juliancentury(jd)
     lambda_m, _, _, _ = _moon_ecliptic_position(jd)
     lambda_s = sun_apparent_long(jc)
-    return _normalize_angle(lambda_m - lambda_s)
+    return _normalize_angle(lambda_m - lambda_s)
+
+def get_moon_phase_name(d: date) -> str:
+    """Determina el nombre de la fase lunar para la fecha dada."""
+    percentage = illuminated_percentage(d)
+    elongation = moon_elongation(d)
+
+    # Determinar nombre intermedio basado en elongación y porcentaje iluminado
+    is_waxing = elongation < 180.0  # <180° creciente, >=180° menguante
+    if percentage < 50.0:
+        phase_name = "waxing_crescent" if is_waxing else "waning_crescent"
+    else:
+        phase_name = "waxing_gibbous" if is_waxing else "waning_gibbous"
+
+    # Verificar fases primarias exactas y override si corresponde
+    last_new = find_last_phase_exact(d, 0.0)
+    if last_new and last_new.date() == d:
+        return "new_moon"
+    elif percentage < 1.0:  # Backup para luna nueva cercana
+        return "new_moon"
+
+    last_first = find_last_phase_exact(d, 90.0)
+    if last_first and last_first.date() == d:
+        return "first_quarter"
+
+    last_full = find_last_phase_exact(d, 180.0)
+    if last_full and last_full.date() == d:
+        return "full_moon"
+    elif percentage > 99.0:  # Backup para luna llena cercana
+        return "full_moon"
+
+    last_last = find_last_phase_exact(d, 270.0)
+    if last_last and last_last.date() == d:
+        return "last_quarter"
+
+    return phase_name
+
+def get_lunation_duration(date_utc: date) -> str:
+    """Calcula la duración exacta de la lunación actual (desde la última luna nueva hasta la siguiente)."""
+    last_new = find_last_phase_exact(date_utc, 0.0)
+    # Buscar la siguiente luna nueva: empezar ~25 días después (buffer seguro)
+    search_date = (last_new + timedelta(days=25)).date()
+    next_new = find_last_phase_exact(search_date + timedelta(days=10), 0.0)  # Buffer para asegurar el cruce
+    if next_new <= last_new:
+        next_new = find_last_phase_exact(search_date + timedelta(days=35), 0.0)  # Seguridad extra si falla
+    duration = next_new - last_new
+    days = duration.days
+    secs = duration.seconds
+    hours = secs // 3600
+    minutes = (secs % 3600) // 60
+    return f"{days} days {hours} hours {minutes} minutes"

solarmoonpy/version.py

@@ -1,2 +1,2 @@
 # version.py
-__version__ = "1.0.3"
+__version__ = "1.0.4"

{solarmoonpy-1.0.3.dist-info → solarmoonpy-1.0.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: solarmoonpy
-Version: 1.0.3
+Version: 1.0.4
 Summary: Precise solar and lunar calculations for astronomical applications
 Author-email: figorr <jdcuartero@yahoo.es>
 License:                                  Apache License
@@ -221,6 +221,9 @@ License-File: LICENSE
 Dynamic: license-file
 
 # ☀️🌙 solarmoonpy
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+![Version](https://img.shields.io/pypi/v/solarmoonpy)
+
 Solar and moon calculations for Meteocat Home Assistant integration.
 
 **solarmoonpy** is a Python library that provides accurate calculations of solar and lunar positions, specifically designed to integrate with Home Assistant and Meteocat data. 
@@ -229,7 +232,7 @@ This project enables you to obtain information such as sunrise, sunset, moon pha
 
 ## 🚀 Features
 
-- ☀️ Solar position calculations (sunrise, sunset, zenith, etc.).
+- ☀️ Solar position calculations (sunrise, sunset, noon, etc.).
 - 🌙 Moon phase and position calculations.
 - Integration with meteorological data from Meteocat.
 - Compatible with Home Assistant for automations based on solar and lunar events.

solarmoonpy-1.0.4.dist-info/RECORD

@@ -0,0 +1,10 @@
+solarmoonpy/__init__.py,sha256=cS0ZjePNX75usK8mgvbk_uguVpXRixqZU4zjrEtg42c,722
+solarmoonpy/location.py,sha256=CcIAlghZ6QQKiQXygfaAs4aBN_7ANfoszabZycIPY30,10312
+solarmoonpy/moon.py,sha256=vaa2LX1O5wtf0Aw6YqA4O81C0rj987bzAnRonmJGUj0,19715
+solarmoonpy/sun.py,sha256=dleHQWXzjnqtPAZr9ONdXiZvTVWvdW6gW775A2ASsNk,8937
+solarmoonpy/version.py,sha256=4GueiH6X-r8Q74Jb_Q5RthVTiWWIAi41JPOadHGhAhw,35
+solarmoonpy-1.0.4.dist-info/licenses/LICENSE,sha256=HrhfyXIkWY2tGFK11kg7vPCqhgh5DcxleloqdhrpyMY,11558
+solarmoonpy-1.0.4.dist-info/METADATA,sha256=NArTJopTV0wOosJWGDHkMz5Va8Mgg8ZvWXhxbAlbmUs,15023
+solarmoonpy-1.0.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+solarmoonpy-1.0.4.dist-info/top_level.txt,sha256=egsoDe9E0QEu5GfAA5jSvy_3qTCWMLMe_Kh3gnM6-dY,12
+solarmoonpy-1.0.4.dist-info/RECORD,,

solarmoonpy-1.0.3.dist-info/RECORD

@@ -1,10 +0,0 @@
-solarmoonpy/__init__.py,sha256=cS0ZjePNX75usK8mgvbk_uguVpXRixqZU4zjrEtg42c,722
-solarmoonpy/location.py,sha256=CcIAlghZ6QQKiQXygfaAs4aBN_7ANfoszabZycIPY30,10312
-solarmoonpy/moon.py,sha256=SSa4pwUX-r70NSg2Fv3TSAnoyMAdTq2vQ8JRZqDBONo,17587
-solarmoonpy/sun.py,sha256=dleHQWXzjnqtPAZr9ONdXiZvTVWvdW6gW775A2ASsNk,8937
-solarmoonpy/version.py,sha256=pUPSnwcgDgNwpkrUxTeExM60u3Bsk0wjaFqQSDBlYhg,35
-solarmoonpy-1.0.3.dist-info/licenses/LICENSE,sha256=HrhfyXIkWY2tGFK11kg7vPCqhgh5DcxleloqdhrpyMY,11558
-solarmoonpy-1.0.3.dist-info/METADATA,sha256=hxP0bZCAu8rYVR56CqxsCt4mCkCFKC81XPEgj-CXDis,14850
-solarmoonpy-1.0.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-solarmoonpy-1.0.3.dist-info/top_level.txt,sha256=egsoDe9E0QEu5GfAA5jSvy_3qTCWMLMe_Kh3gnM6-dY,12
-solarmoonpy-1.0.3.dist-info/RECORD,,