meteo-lt-pkg 0.5.2__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/models.py

@@ -2,7 +2,7 @@
 
 from dataclasses import dataclass, field, fields
 from datetime import datetime, timezone
-from typing import List, Optional, Dict, Any, Type
+from typing import Any, Dict, List, Optional, Type
 
 from .const import COUNTY_MUNICIPALITIES
 
@@ -60,6 +60,7 @@ class MeteoWarning:
     category: str = "weather"  # "weather" or "hydro"
     start_time: Optional[str] = None
     end_time: Optional[str] = None
+    instruction: Optional[str] = None
 
 
 @dataclass

meteo_lt/warnings.py

@@ -1,12 +1,12 @@
 """Unified warnings processor for handling weather and hydrological warning-related logic"""
 
 import re
-from datetime import datetime, timezone
-from typing import List, Optional, Dict, Any, Literal
+from datetime import datetime, timedelta, timezone
+from typing import Any, Dict, List, Literal, Optional
 
-from .models import Forecast, MeteoWarning
-from .const import COUNTY_MUNICIPALITIES, WARNINGS_URL, HYDRO_WARNINGS_URL
 from .client import MeteoLtClient
+from .const import COUNTY_MUNICIPALITIES, HYDRO_WARNINGS_URL, WARNINGS_URL
+from .models import Forecast, MeteoWarning
 
 WarningCategory = Literal["weather", "hydro"]
 
@@ -77,20 +77,17 @@ class WarningsProcessor:
         inst_dict = alert.get("instruction", {})
 
         description = desc_dict.get("en") or desc_dict.get("lt", "")
-        instruction = inst_dict.get("en") or inst_dict.get("lt", "")
-
-        full_description = description
-        if instruction:
-            full_description += f"\n\nRecommendations: {instruction}"
+        instruction = inst_dict.get("en") or inst_dict.get("lt", "") or None
 
         return MeteoWarning(
             county=county,
             warning_type=warning_type,
             severity=severity,
-            description=full_description,
+            description=description,
             category=self.category,
             start_time=alert.get("t_from"),
             end_time=alert.get("t_to"),
+            instruction=instruction,
         )
 
     def _warning_affects_area(self, warning: MeteoWarning, administrative_division: str) -> bool:
@@ -112,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
 
@@ -138,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.2.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.2
+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
@@ -212,6 +225,8 @@ async def fetch_warnings():
             print(f"Warning: {warning.warning_type} in {warning.county}")
             print(f"Severity: {warning.severity}")
             print(f"Description: {warning.description}")
+            if warning.instruction:
+                print(f"Instruction: {warning.instruction}")
             print(f"Active: {warning.start_time} to {warning.end_time}")
             print("-" * 50)
 
@@ -243,6 +258,8 @@ async def fetch_hydro_warnings():
             print(f"Hydro Warning: {warning.warning_type} in {warning.county}")
             print(f"Severity: {warning.severity}")
             print(f"Description: {warning.description}")
+            if warning.instruction:
+                print(f"Instruction: {warning.instruction}")
             print("-" * 50)
 
 async def fetch_hydro_warnings_for_area():
@@ -270,6 +287,8 @@ async def fetch_all_warnings():
             print(f"{warning.warning_type} in {warning.county}")
             print(f"Severity: {warning.severity}")
             print(f"Description: {warning.description}")
+            if warning.instruction:
+                print(f"Instruction: {warning.instruction}")
             print("-" * 50)
 
 async def fetch_all_warnings_for_area():
@@ -379,11 +398,14 @@ weather_warning = MeteoWarning(
     warning_type="frost",
     severity="Moderate",
     description="Ground surface frost 0-5 degrees in many places",
+    instruction="Protect sensitive plants and be cautious on roads",  # Optional safety instruction
     category="weather",
     start_time="2024-07-23T12:00:00Z",
     end_time="2024-07-23T18:00:00Z"
 )
 print(f"Warning for {weather_warning.county}: {weather_warning.description}")
+if weather_warning.instruction:
+    print(f"Safety instruction: {weather_warning.instruction}")
 print(f"Category: {weather_warning.category}")  # "weather" or "hydro"
 
 # Hydrological warning example
@@ -392,6 +414,7 @@ hydro_warning = MeteoWarning(
     warning_type="flood",
     severity="High",
     description="High water levels expected",
+    instruction="Avoid low-lying areas and do not attempt to cross flooded roads",  # Optional
     category="hydro",
     start_time="2024-07-23T12:00:00Z",
     end_time="2024-07-24T12:00:00Z"

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.2.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=aUF2K99bxKaLw9bRQkVkM18z44AvhmcvqmtzHXuQnkc,6105
-meteo_lt/utils.py,sha256=VhXWnqfeBdKrncrsIrSwzsiN3Sg4-kDG5v6Yz-PBOLc,1281
-meteo_lt/warnings.py,sha256=XKMCO45_AGjBfXD8NxyYXIel1w1Rm3OP8lkE_tnNKq0,7195
-meteo_lt_pkg-0.5.2.dist-info/licenses/LICENSE,sha256=3IGi6xn6NUdXGvcdwD0MUbhy3Yz5NRnUjJrwKanFAD4,1073
-meteo_lt_pkg-0.5.2.dist-info/METADATA,sha256=P6z7698ZBbUnEiUC9YZxz4mVDRmsdwdKOoc9zpjt0vw,17679
-meteo_lt_pkg-0.5.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-meteo_lt_pkg-0.5.2.dist-info/top_level.txt,sha256=-aEdc9FzHhcIH4_0TNdKNxuvDnS3chKoJy6LK9Ud-G4,9
-meteo_lt_pkg-0.5.2.dist-info/RECORD,,