dfb-weather 0.1.0__tar.gz

dfb_weather-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fribus Danila
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

dfb_weather-0.1.0/PKG-INFO

@@ -0,0 +1,97 @@
+Metadata-Version: 2.5
+Name: dfb-weather
+Version: 0.1.0
+Summary: Библиотека для получения данных о погоде через API Open-Meteo и определения геолокации по IP
+Project-URL: Homepage, https://github.com/DFB000
+Author-email: Fribus Danila <dbfribus4@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.8
+Requires-Dist: requests>=2.25.0
+Description-Content-Type: text/markdown
+
+# dfb-weather
+
+Библиотека для быстрого и удобного получения текущих данных о погоде через бесплатное API **Open-Meteo** с автоматическим определением местоположения по IP-адресу.
+
+## 🚀 Особенности
+
+* 🌍 **Автоматическая геолокация**: Если координаты не переданы, библиотека сама определит ваше местоположение (город) по IP-адресу через сервис `ip-api.com`.
+* ⚡ **Чистые данные**: Никакого мусора в ответах — только нужная информация (температура, влажность, давление, ветер, облачность).
+* 🌡️ **Адаптация под СНГ**: Давление автоматически переводится из гектопаскалей (hPa) в привычные **мм рт. ст.**, а скорость ветра отдается в **м/с**.
+* 🛠️ **Безопасность**: Защита от изменений структуры сторонних API — данные парсятся строго по ключам, а не через слепую распаковку.
+
+## 📦 Установка
+
+Пока библиотека находится в разработке, вы можете установить её локально из папки проекта:
+
+```bash
+pip install .
+```
+
+## 🛠️ Быстрый старт
+
+### 1. Автоматическое определение погоды по IP
+
+Вам не нужно искать свои координаты — библиотека сделает это за вас:
+
+```python
+from dfb_weather import Weather
+
+# Создаем объект погоды
+weather = Weather()
+
+# Обновляем данные (координаты определятся по вашему IP)
+if weather.update():
+    # Получаем данные в виде удобного словаря
+    data = weather.to_dict()
+    
+    print(f"Погода на время: {data['time']}")
+    print(f"Температура: {data['temperature']} °C (ощущается как {data['apparent_temperature']} °C)")
+    print(f"Влажность: {data['relative_humidity']}%")
+    print(f"Давление: {data['surface_pressure']} мм рт. ст.")
+    print(f"Ветер: {data['wind_speed']} м/с")
+else:
+    print("Не удалось получить данные о погоде.")
+```
+
+### 2. Запрос погоды по конкретным координатам
+
+Если вы знаете точную широту и долготу (например, для Москвы — `55.7558, 37.6173`):
+
+```python
+from dfb_weather import Weather
+
+weather = Weather()
+
+# Передаем координаты кортежем (latitude, longitude)
+if weather.update(lat_lon=(55.7558, 37.6173)):
+    print(f"Температура в Москве: {weather.temperature} °C")
+```
+
+## 📋 Описание возвращаемых данных
+
+Метод `weather.to_dict()` возвращает словарь со следующими полями:
+
+| Ключ | Описание | Единицы измерения |
+| :--- | :--- | :--- |
+| `time` | Время замера данных на сервере | Текстовый формат (`YYYY-MM-DDTHH:MM`) |
+| `temperature` | Фактическая температура воздуха на высоте 2 метров | Градусы Цельсия (`°C`) |
+| `apparent_temperature` | Ощущаемая температура с учетом ветра и влажности | Градусы Цельсия (`°C`) |
+| `relative_humidity` | Относительная влажность воздуха | Проценты (`%`) |
+| `precipitation` | Общий объем осадков (дождь/снег) за последний час | Миллиметры (`мм`) |
+| `wind_speed` | Скорость движения воздушных масс (ветер) | Метры в секунду (`м/с`) |
+| `cloud_cover` | Степень покрытия неба облаками | Проценты (от `0%` до `100%`) |
+| `surface_pressure` | Атмосферное давление на уровне земли | Миллиметры ртутного столба (`мм рт. ст.`) |
+
+## 🔒 Требования и зависимости
+
+* **Python**: `>= 3.8`
+* **Библиотеки**: `requests>=2.25.0`
+
+## 📄 Лицензия
+
+Проект распространяется под лицензией MIT. Подробнее см. в файле `LICENSE`.
+
+---
+👨‍💻 **Автор**: [Fribus Danila](https://github.com/DFB000) (dbfribus4@gmail.com)

dfb_weather-0.1.0/README.md

@@ -0,0 +1,85 @@
+# dfb-weather
+
+Библиотека для быстрого и удобного получения текущих данных о погоде через бесплатное API **Open-Meteo** с автоматическим определением местоположения по IP-адресу.
+
+## 🚀 Особенности
+
+* 🌍 **Автоматическая геолокация**: Если координаты не переданы, библиотека сама определит ваше местоположение (город) по IP-адресу через сервис `ip-api.com`.
+* ⚡ **Чистые данные**: Никакого мусора в ответах — только нужная информация (температура, влажность, давление, ветер, облачность).
+* 🌡️ **Адаптация под СНГ**: Давление автоматически переводится из гектопаскалей (hPa) в привычные **мм рт. ст.**, а скорость ветра отдается в **м/с**.
+* 🛠️ **Безопасность**: Защита от изменений структуры сторонних API — данные парсятся строго по ключам, а не через слепую распаковку.
+
+## 📦 Установка
+
+Пока библиотека находится в разработке, вы можете установить её локально из папки проекта:
+
+```bash
+pip install .
+```
+
+## 🛠️ Быстрый старт
+
+### 1. Автоматическое определение погоды по IP
+
+Вам не нужно искать свои координаты — библиотека сделает это за вас:
+
+```python
+from dfb_weather import Weather
+
+# Создаем объект погоды
+weather = Weather()
+
+# Обновляем данные (координаты определятся по вашему IP)
+if weather.update():
+    # Получаем данные в виде удобного словаря
+    data = weather.to_dict()
+    
+    print(f"Погода на время: {data['time']}")
+    print(f"Температура: {data['temperature']} °C (ощущается как {data['apparent_temperature']} °C)")
+    print(f"Влажность: {data['relative_humidity']}%")
+    print(f"Давление: {data['surface_pressure']} мм рт. ст.")
+    print(f"Ветер: {data['wind_speed']} м/с")
+else:
+    print("Не удалось получить данные о погоде.")
+```
+
+### 2. Запрос погоды по конкретным координатам
+
+Если вы знаете точную широту и долготу (например, для Москвы — `55.7558, 37.6173`):
+
+```python
+from dfb_weather import Weather
+
+weather = Weather()
+
+# Передаем координаты кортежем (latitude, longitude)
+if weather.update(lat_lon=(55.7558, 37.6173)):
+    print(f"Температура в Москве: {weather.temperature} °C")
+```
+
+## 📋 Описание возвращаемых данных
+
+Метод `weather.to_dict()` возвращает словарь со следующими полями:
+
+| Ключ | Описание | Единицы измерения |
+| :--- | :--- | :--- |
+| `time` | Время замера данных на сервере | Текстовый формат (`YYYY-MM-DDTHH:MM`) |
+| `temperature` | Фактическая температура воздуха на высоте 2 метров | Градусы Цельсия (`°C`) |
+| `apparent_temperature` | Ощущаемая температура с учетом ветра и влажности | Градусы Цельсия (`°C`) |
+| `relative_humidity` | Относительная влажность воздуха | Проценты (`%`) |
+| `precipitation` | Общий объем осадков (дождь/снег) за последний час | Миллиметры (`мм`) |
+| `wind_speed` | Скорость движения воздушных масс (ветер) | Метры в секунду (`м/с`) |
+| `cloud_cover` | Степень покрытия неба облаками | Проценты (от `0%` до `100%`) |
+| `surface_pressure` | Атмосферное давление на уровне земли | Миллиметры ртутного столба (`мм рт. ст.`) |
+
+## 🔒 Требования и зависимости
+
+* **Python**: `>= 3.8`
+* **Библиотеки**: `requests>=2.25.0`
+
+## 📄 Лицензия
+
+Проект распространяется под лицензией MIT. Подробнее см. в файле `LICENSE`.
+
+---
+👨‍💻 **Автор**: [Fribus Danila](https://github.com/DFB000) (dbfribus4@gmail.com)

dfb_weather-0.1.0/pyproject.toml

@@ -0,0 +1,24 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "dfb-weather"
+version = "0.1.0"
+description = "Библиотека для получения данных о погоде через API Open-Meteo и определения геолокации по IP"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.8"
+authors = [
+    { name = "Fribus Danila", email = "dbfribus4@gmail.com" }
+]
+dependencies = [
+    "requests>=2.25.0"
+]
+
+
+[project.urls]
+Homepage = "https://github.com/DFB000"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/dfb_weather"]

dfb_weather-0.1.0/src/dfb_weather/__init__.py

@@ -0,0 +1,3 @@
+from .core import Weather, get_coordinates_by_ip
+
+__all__ = ["Weather", "get_coordinates_by_ip"]

dfb_weather-0.1.0/src/dfb_weather/core.py

@@ -0,0 +1,82 @@
+import requests
+
+def get_coordinates_by_ip() -> tuple[float, float] | None:
+    try:
+        url = "http://ip-api.com/json/"
+        res = requests.get(url, timeout=3, headers={"User-Agent": "Mozilla/5.0"})
+        if res.status_code == 200:
+            data = res.json()
+            lat, lon = data.get("lat"), data.get("lon")
+            if lat is not None and lon is not None:
+                return lat, lon
+    except requests.RequestException:
+        pass
+    return None
+
+
+class Weather:
+    BASE_URL = "https://api.open-meteo.com/v1/forecast"
+
+    def __init__(self):
+        self.time = None
+        self.temperature = None
+        self.apparent_temperature = None
+        self.relative_humidity = None
+        self.precipitation = None
+        self.wind_speed = None
+        self.cloud_cover = None
+        self.surface_pressure = None
+
+    def update(self, lat_lon: tuple[float | int, float | int] = None) -> bool:
+        if not lat_lon:
+            lat_lon = get_coordinates_by_ip()
+
+        if not lat_lon:
+            return False
+
+        lat, lon = lat_lon
+        params = {
+            "latitude": lat,
+            "longitude": lon,
+            "current": "temperature_2m,apparent_temperature,relative_humidity_2m,precipitation,wind_speed_10m,cloud_cover,surface_pressure",
+            "wind_speed_unit": "ms",
+            "timezone": "auto",
+        }
+
+        try:
+            res = requests.get(self.BASE_URL, params=params, timeout=5)
+            if res.status_code != 200:
+                return False
+
+            current = res.json().get("current", {})
+            if not current:
+                return False
+
+            self.time = current.get("time")
+            self.temperature = current.get("temperature_2m")
+            self.apparent_temperature = current.get("apparent_temperature")
+            self.relative_humidity = current.get("relative_humidity_2m")
+            self.precipitation = current.get("precipitation")
+            self.wind_speed = current.get("wind_speed_10m")
+            self.cloud_cover = current.get("cloud_cover")
+
+            pressure = current.get("surface_pressure")
+            if pressure is not None:
+                self.surface_pressure = round(pressure * 0.75006, 1)
+
+            return True
+
+        except requests.RequestException:
+            return False
+
+    def to_dict(self) -> dict:
+        return {
+            "time": self.time,
+            "temperature": self.temperature,
+            "apparent_temperature": self.apparent_temperature,
+            "relative_humidity": self.relative_humidity,
+            "precipitation": self.precipitation,
+            "wind_speed": self.wind_speed,
+            "cloud_cover": self.cloud_cover,
+            "surface_pressure": self.surface_pressure,
+        }