solarmoonpy 0.1.0__tar.gz → 1.0.0__tar.gz

{solarmoonpy-0.1.0 → solarmoonpy-1.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: solarmoonpy
-Version: 0.1.0
+Version: 1.0.0
 Summary: Precise solar and lunar calculations for astronomical applications
 Author-email: figorr <jdcuartero@yahoo.es>
 License:                                  Apache License
@@ -220,5 +220,18 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Dynamic: license-file
 
-# solarmoonpy
-solar and moon calculations
+# ☀️🌙 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. 
+
+This project enables you to obtain information such as sunrise, sunset, moon phases, and more, for advanced automations in your home automation system.
+
+## 🚀 Features
+
+- ☀️ Solar position calculations (sunrise, sunset, zenith, etc.).
+- 🌙 Moon phase and position calculations.
+- Integration with meteorological data from Meteocat.
+- Compatible with Home Assistant for automations based on solar and lunar events.
+- Lightweight, easy to use, and well-documented.
+- Configurable for different geographic locations.

solarmoonpy-1.0.0/README.md

@@ -0,0 +1,15 @@
+# ☀️🌙 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. 
+
+This project enables you to obtain information such as sunrise, sunset, moon phases, and more, for advanced automations in your home automation system.
+
+## 🚀 Features
+
+- ☀️ Solar position calculations (sunrise, sunset, zenith, etc.).
+- 🌙 Moon phase and position calculations.
+- Integration with meteorological data from Meteocat.
+- Compatible with Home Assistant for automations based on solar and lunar events.
+- Lightweight, easy to use, and well-documented.
+- Configurable for different geographic locations.

{solarmoonpy-0.1.0 → solarmoonpy-1.0.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "solarmoonpy"
-version = "0.1.0"
+version = "1.0.0"
 description = "Precise solar and lunar calculations for astronomical applications"
 readme = "README.md"
 authors = [{ name = "figorr", email = "jdcuartero@yahoo.es" }]

{solarmoonpy-0.1.0 → solarmoonpy-1.0.0}/solarmoonpy/__init__.py

@@ -9,11 +9,12 @@ https://github.com/figorr/solarmoonpy
 
 # solarmoonpy/__init__.py
 from .version import __version__
-from .moon import moon_phase, moon_rise_set, illuminated_percentage, moon_distance, moon_angular_diameter
+from .moon import moon_phase, moon_day, moon_rise_set, illuminated_percentage, moon_distance, moon_angular_diameter
 from .location import Location, LocationInfo
 
 __all__ = [
-    "moon_phase", 
+    "moon_phase",
+    "moon_day", 
     "moon_rise_set", 
     "illuminated_percentage", 
     "moon_distance", 

{solarmoonpy-0.1.0 → solarmoonpy-1.0.0}/solarmoonpy/moon.py

@@ -40,6 +40,58 @@ def moon_phase(date_utc: date) -> float:
     # Promedio ponderado: favorece cálculo preciso, pero usa aproximado como respaldo
     return round(0.9 * precise_phase + 0.1 * approx_phase, 6)
 
+def moon_day(date_utc: date, tol_hours: float = 0.01) -> int:
+    """
+    Calcula el día lunar 0–29 usando la última luna nueva exacta calculada por elongación.
+    Usa el fin del día UTC para alinear con convenciones de timeanddate/NASA (etiqueta el día con la fase si ocurre en él).
+    tol_hours: precisión en horas.
+    """
+    dt = datetime(date_utc.year, date_utc.month, date_utc.day, 23, 59, tzinfo=timezone.utc)
+
+    def elongation(t: datetime) -> float:
+        jd = julianday(t.date()) + (t.hour + t.minute/60 + t.second/3600)/24
+        jc = julianday_to_juliancentury(jd)
+        lambda_m, _, _, _ = _moon_ecliptic_position(jd)
+        lambda_s = sun_apparent_long(jc)
+        diff = (lambda_m - lambda_s) % 360.0
+        if diff > 180:
+            diff -= 360
+        return diff
+
+    # Buscar la última luna nueva antes de la fecha
+    step = timedelta(hours=6)
+    t_back = dt
+    prev_el = elongation(t_back)
+    for _ in range(int(30*24/6)):
+        t_back -= step
+        el = elongation(t_back)
+        if prev_el > 0 >= el:  # cruce 0 hacia abajo indica luna nueva
+            break
+        prev_el = el
+
+    # Refinar el momento exacto con bisección
+    low = t_back
+    high = t_back + step
+    while (high - low).total_seconds() / 3600 > tol_hours:
+        mid = low + (high - low)/2
+        if elongation(mid) > 0:
+            high = mid
+        else:
+            low = mid
+    last_new_moon = low + (high - low)/2
+
+    # Edad lunar en días
+    age_days = (dt - last_new_moon).total_seconds() / 86400.0
+
+    # Día lunar: 0–29, redondeado correctamente
+    if age_days < 0:
+        day = 0
+    else:
+        day = int(math.floor(age_days))
+        if day > 29:
+            day = 29
+    return day
+
 def illuminated_percentage(date_utc: date) -> float:
     """
     Calcula el porcentaje de luna iluminada para una fecha UTC (versión precisa).

solarmoonpy-1.0.0/solarmoonpy/version.py

@@ -0,0 +1,2 @@
+# version.py
+__version__ = "1.0.0"

{solarmoonpy-0.1.0 → solarmoonpy-1.0.0}/solarmoonpy.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: solarmoonpy
-Version: 0.1.0
+Version: 1.0.0
 Summary: Precise solar and lunar calculations for astronomical applications
 Author-email: figorr <jdcuartero@yahoo.es>
 License:                                  Apache License
@@ -220,5 +220,18 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Dynamic: license-file
 
-# solarmoonpy
-solar and moon calculations
+# ☀️🌙 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. 
+
+This project enables you to obtain information such as sunrise, sunset, moon phases, and more, for advanced automations in your home automation system.
+
+## 🚀 Features
+
+- ☀️ Solar position calculations (sunrise, sunset, zenith, etc.).
+- 🌙 Moon phase and position calculations.
+- Integration with meteorological data from Meteocat.
+- Compatible with Home Assistant for automations based on solar and lunar events.
+- Lightweight, easy to use, and well-documented.
+- Configurable for different geographic locations.

solarmoonpy-0.1.0/README.md

@@ -1,2 +0,0 @@
-# solarmoonpy
-solar and moon calculations

solarmoonpy-0.1.0/solarmoonpy/version.py

@@ -1,2 +0,0 @@
-# version.py
-__version__ = "0.1.0"