meteo-lt-pkg 0.5.3__py3-none-any.whl → 0.6.0__py3-none-any.whl

meteo_lt/api.py

@@ -67,7 +67,7 @@ class MeteoLtAPI:
 
         return await self.get_forecast(place_code, include_warnings=True)
 
-    async def get_forecast(self, place_code: str, include_warnings: bool = False) -> Forecast:
+    async def get_forecast(self, place_code: str, include_warnings: bool = True) -> Forecast:
         """Retrieves forecast data from API"""
         forecast = await self.client.fetch_forecast(place_code)
 

meteo_lt/warnings.py

@@ -1,7 +1,7 @@
 """Unified warnings processor for handling weather and hydrological warning-related logic"""
 
 import re
-from datetime import datetime, timezone
+from datetime import datetime, timedelta, timezone
 from typing import Any, Dict, List, Literal, Optional
 
 from .client import MeteoLtClient
@@ -109,10 +109,7 @@ class WarningsProcessor:
         return False
 
     def enrich_forecast_with_warnings(self, forecast: Forecast, warnings: List[MeteoWarning]) -> None:
-        """Enrich forecast timestamps with relevant warnings
-
-        All warnings (weather and hydro) are added to 'warnings' attribute
-        """
+        """Enrich forecast timestamps with relevant warnings"""
         if not warnings:
             return
 
@@ -135,27 +132,26 @@ class WarningsProcessor:
     def _get_warnings_for_timestamp(self, timestamp_str: str, warnings: List[MeteoWarning]) -> List[MeteoWarning]:
         """Get warnings that are active for a specific timestamp"""
         try:
-            timestamp = datetime.fromisoformat(timestamp_str).replace(tzinfo=timezone.utc)
-            applicable_warnings = []
-
-            for warning in warnings:
-                if not warning.start_time or not warning.end_time:
-                    continue
+            timestamp = datetime.fromisoformat(timestamp_str).astimezone(timezone.utc)
+        except (ValueError, AttributeError):
+            return []
 
-                try:
-                    start_time = datetime.fromisoformat(warning.start_time.replace("Z", "+00:00"))
-                    end_time = datetime.fromisoformat(warning.end_time.replace("Z", "+00:00"))
+        # Forecast timestamp represents an hour starting at this time
+        hour_start = timestamp
+        hour_end = timestamp + timedelta(hours=1)
 
-                    # Check if timestamp falls within warning period
-                    if start_time <= timestamp <= end_time:
-                        applicable_warnings.append(warning)
+        applicable_warnings = []
 
-                except (ValueError, AttributeError):
-                    # Skip warnings with invalid time formats
-                    continue
+        for warning in warnings:
+            try:
+                start_time = datetime.fromisoformat(warning.start_time).astimezone(timezone.utc)
+                end_time = datetime.fromisoformat(warning.end_time).astimezone(timezone.utc)
+            except (ValueError, AttributeError, TypeError):
+                continue
 
-            return applicable_warnings
+            # Check if warning period overlaps with the hour
+            # Warning overlaps if it starts before hour ends AND ends after hour starts
+            if start_time < hour_end and end_time > hour_start:
+                applicable_warnings.append(warning)
 
-        except (ValueError, AttributeError):
-            # Return empty list if timestamp parsing fails
-            return []
+        return applicable_warnings

{meteo_lt_pkg-0.5.3.dist-info → meteo_lt_pkg-0.6.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: meteo_lt-pkg
-Version: 0.5.3
+Version: 0.6.0
 Summary: A library to fetch weather data from api.meteo.lt
 Author-email: Brunas <brunonas@gmail.com>
 Project-URL: Homepage, https://github.com/Brunas/meteo_lt-pkg
@@ -9,7 +9,7 @@ Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Development Status :: 4 - Beta
-Requires-Python: >=3.10
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: aiohttp>=3.13
@@ -37,6 +37,11 @@ Dynamic: license-file
 
 MeteoLt-Pkg is a Python library designed to fetch weather data from [`api.meteo.lt`](https://api.meteo.lt/). This library provides convenient methods to interact with the API and obtain weather forecasts and related data. Please visit for more information.
 
+## Requirements
+
+- Python 3.11 or higher
+- aiohttp 3.13 or higher
+
 ## Installation
 
 You can install the package using pip:
@@ -153,7 +158,7 @@ To get the weather forecast for a specific place:
 ```python
 async def fetch_forecast():
     async with MeteoLtAPI() as api:
-        # Get forecast for Vilnius
+        # Get forecast for Vilnius (warnings included by default)
         forecast = await api.get_forecast("vilnius")
 
         # Current conditions
@@ -162,6 +167,12 @@ async def fetch_forecast():
         print(f"Feels like: {current.apparent_temperature}°C")
         print(f"Condition: {current.condition_code}")
 
+        # Check for warnings (automatically included)
+        if current.warnings:
+            print(f"\nActive warnings: {len(current.warnings)}")
+            for warning in current.warnings:
+                print(f"- {warning.warning_type}: {warning.severity}")
+
         # Future forecasts
         print(f"\nNext 24 hours:")
         for timestamp in forecast.forecast_timestamps[:24]:
@@ -170,6 +181,8 @@ async def fetch_forecast():
 asyncio.run(fetch_forecast())
 ```
 
+> **NOTE**: Weather and hydrological warnings are automatically included in forecast data by default. To exclude warnings, use `get_forecast(place_code, include_warnings=False)`.
+
 > **NOTE**: `current_conditions` is the current hour record from the `forecast_timestamps` array. Also, `forecast_timestamps` array has past time records filtered out due to `api.meteo.lt` not doing that automatically.
 
 ### Fetching Weather Forecast with Warnings

meteo_lt_pkg-0.6.0.dist-info/RECORD

@@ -0,0 +1,12 @@
+meteo_lt/__init__.py,sha256=3Ef5fihtzaxsRcygINTnNdQI9W_9JULe6ycyeRw8bN8,452
+meteo_lt/api.py,sha256=Zjp_HHEyxKlrySFyBsszdpToHOeGDh-HacsBZoXJnG8,5068
+meteo_lt/client.py,sha256=R4lfX9_m-x7Va7IcU6d3rxAE0plOg2gD4NJ9gqtIVvg,5189
+meteo_lt/const.py,sha256=w0eEOss0YbTJzNdpfocrd5DZ7pFSwR3aQ-uMfNttvag,2791
+meteo_lt/models.py,sha256=ENQmWFZMQmXhHIddoAuC7givYbXIlu58v_pI8iACR4o,6143
+meteo_lt/utils.py,sha256=VhXWnqfeBdKrncrsIrSwzsiN3Sg4-kDG5v6Yz-PBOLc,1281
+meteo_lt/warnings.py,sha256=tHoXRIxlxntXqP6XyU9qyG0nzcdjAxuRmcRDPwcr6-U,7015
+meteo_lt_pkg-0.6.0.dist-info/licenses/LICENSE,sha256=3IGi6xn6NUdXGvcdwD0MUbhy3Yz5NRnUjJrwKanFAD4,1073
+meteo_lt_pkg-0.6.0.dist-info/METADATA,sha256=LEds1ZWvATaad6IB21-XltyrtlEmdQ8YzZJfb5n5bIY,18804
+meteo_lt_pkg-0.6.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+meteo_lt_pkg-0.6.0.dist-info/top_level.txt,sha256=-aEdc9FzHhcIH4_0TNdKNxuvDnS3chKoJy6LK9Ud-G4,9
+meteo_lt_pkg-0.6.0.dist-info/RECORD,,

meteo_lt_pkg-0.5.3.dist-info/RECORD

@@ -1,12 +0,0 @@
-meteo_lt/__init__.py,sha256=3Ef5fihtzaxsRcygINTnNdQI9W_9JULe6ycyeRw8bN8,452
-meteo_lt/api.py,sha256=GQDhDnTj3cx1hokt5188NnGz8FVDJHJDJXGm_fXxop8,5069
-meteo_lt/client.py,sha256=R4lfX9_m-x7Va7IcU6d3rxAE0plOg2gD4NJ9gqtIVvg,5189
-meteo_lt/const.py,sha256=w0eEOss0YbTJzNdpfocrd5DZ7pFSwR3aQ-uMfNttvag,2791
-meteo_lt/models.py,sha256=ENQmWFZMQmXhHIddoAuC7givYbXIlu58v_pI8iACR4o,6143
-meteo_lt/utils.py,sha256=VhXWnqfeBdKrncrsIrSwzsiN3Sg4-kDG5v6Yz-PBOLc,1281
-meteo_lt/warnings.py,sha256=aD28RAlD-6vQdnJHNNkDBW3QkP23Dt0mgJ97A3iWRqo,7101
-meteo_lt_pkg-0.5.3.dist-info/licenses/LICENSE,sha256=3IGi6xn6NUdXGvcdwD0MUbhy3Yz5NRnUjJrwKanFAD4,1073
-meteo_lt_pkg-0.5.3.dist-info/METADATA,sha256=vmWdE8zOaWpCtTWRpKOBvPojy6Ru3RThzzjTqC55ZE4,18261
-meteo_lt_pkg-0.5.3.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-meteo_lt_pkg-0.5.3.dist-info/top_level.txt,sha256=-aEdc9FzHhcIH4_0TNdKNxuvDnS3chKoJy6LK9Ud-G4,9
-meteo_lt_pkg-0.5.3.dist-info/RECORD,,