meteocatpy 0.0.7

package/meteocatpy/town.py

@@ -0,0 +1,61 @@
+import aiohttp
+from .const import BASE_URL, MUNICIPIS_LIST_URL
+from .exceptions import BadRequestError, ForbiddenError, TooManyRequestsError, InternalServerError, UnknownAPIError
+
+class MeteocatTown:
+    """Clase para interactuar con la lista de municipios de la API de Meteocat."""
+
+    def __init__(self, api_key: str):
+        """
+        Inicializa la clase MeteocatTown.
+
+        Args:
+            api_key (str): Clave de API para autenticar las solicitudes.
+        """
+        self.api_key = api_key
+        self.headers = {
+            "Content-Type": "application/json",
+            "X-Api-Key": self.api_key,
+        }
+
+    async def get_municipis(self):
+        """
+        Obtiene la lista de municipios desde la API de Meteocat.
+
+        Returns:
+            dict: Datos de los municipios.
+        """
+        url = f"{BASE_URL}{MUNICIPIS_LIST_URL}"
+        async with aiohttp.ClientSession() as session:
+            try:
+                async with session.get(url, headers=self.headers) as response:
+                    if response.status == 200:
+                        return await response.json()
+
+                    # Gestionar errores según el código de estado
+                    if response.status == 400:
+                        raise BadRequestError(await response.json())
+                    elif response.status == 403:
+                        error_data = await response.json()
+                        if error_data.get("message") == "Forbidden":
+                            raise ForbiddenError(error_data)
+                        elif error_data.get("message") == "Missing Authentication Token":
+                            raise ForbiddenError(error_data)
+                    elif response.status == 429:
+                        raise TooManyRequestsError(await response.json())
+                    elif response.status == 500:
+                        raise InternalServerError(await response.json())
+                    else:
+                        raise UnknownAPIError(f"Unexpected error {response.status}: {await response.text()}")
+            
+            except aiohttp.ClientError as e:
+                raise UnknownAPIError(
+                    message=f"Error al conectar con la API de Meteocat: {str(e)}",
+                    status_code=0,
+                )
+
+            except Exception as ex:
+                raise UnknownAPIError(
+                    message=f"Error inesperado: {str(ex)}",
+                    status_code=0,
+                )

package/meteocatpy/townstations.py

@@ -0,0 +1,99 @@
+import aiohttp
+from .stations import MeteocatStations  # Importamos la clase MeteocatStations
+from .const import BASE_URL, STATIONS_MUNICIPI_URL
+from .exceptions import (
+    BadRequestError,
+    ForbiddenError,
+    TooManyRequestsError,
+    InternalServerError,
+    UnknownAPIError,
+)
+
+class MeteocatTownStations:
+    """
+    Clase para interactuar con la API de Meteocat y obtener
+    las estaciones representativas de un municipio para una variable específica.
+    """
+
+    def __init__(self, api_key: str):
+        """
+        Inicializa la clase MeteocatTownStations.
+
+        Args:
+            api_key (str): Clave de API para autenticar las solicitudes.
+        """
+        self.api_key = api_key
+        self.headers = {
+            "Content-Type": "application/json",
+            "X-Api-Key": self.api_key,
+        }
+        self.stations_service = MeteocatStations(api_key)  # Instancia de MeteocatStations
+
+    async def get_town_stations(self, town_id: str, variable_id: str):
+        """
+        Obtiene la lista de estaciones representativas para un municipio y una variable específica,
+        enriqueciendo los datos con el nombre de las estaciones.
+
+        Args:
+            codi_municipi (str): Código del municipio.
+            codi_variable (str): Código de la variable.
+
+        Returns:
+            list: Datos de las estaciones representativas con nombres añadidos.
+        """
+        # Obtener la lista completa de estaciones
+        all_stations = await self.stations_service.get_stations()
+
+        # Crear un diccionario para acceder rápidamente a los nombres por código
+        station_names = {station["codi"]: station["nom"] for station in all_stations}
+
+        # URL para obtener las estaciones del municipio y la variable
+        url = f"{BASE_URL}{STATIONS_MUNICIPI_URL}".format(
+            codi_municipi=town_id, codi_variable=variable_id
+        )
+
+        async with aiohttp.ClientSession() as session:
+            try:
+                async with session.get(url, headers=self.headers) as response:
+                    if response.status == 200:
+                        data = await response.json()
+
+                        # Enriquecer el JSON con los nombres de las estaciones
+                        for town in data:
+                            for variable in town.get("variables", []):
+                                for station in variable.get("estacions", []):
+                                    codi = station["codi"]
+                                    station["nom"] = station_names.get(codi, "Nombre desconocido")
+
+                        return data
+
+                    # Gestionar errores según el código de estado
+                    if response.status == 400:
+                        raise BadRequestError(await response.json())
+                    elif response.status == 403:
+                        error_data = await response.json()
+                        if error_data.get("message") == "Forbidden":
+                            raise ForbiddenError(error_data)
+                        elif error_data.get("message") == "Missing Authentication Token":
+                            raise ForbiddenError(error_data)
+                    elif response.status == 429:
+                        raise TooManyRequestsError(await response.json())
+                    elif response.status == 500:
+                        raise InternalServerError(await response.json())
+                    else:
+                        raise UnknownAPIError(
+                            f"Unexpected error {response.status}: {await response.text()}"
+                        )
+
+            except aiohttp.ClientError as e:
+                raise UnknownAPIError(
+                    message=f"Error al conectar con la API de Meteocat: {str(e)}",
+                    status_code=0,
+                )
+
+            except Exception as ex:
+                raise UnknownAPIError(
+                    message=f"Error inesperado: {str(ex)}",
+                    status_code=0,
+                )
+

package/meteocatpy/variables.py

@@ -0,0 +1,74 @@
+import aiohttp
+from diskcache import Cache
+from .const import BASE_URL, VARIABLES_URL
+from .exceptions import BadRequestError, ForbiddenError, TooManyRequestsError, InternalServerError, UnknownAPIError
+
+class MeteocatVariables:
+    """Clase para interactuar con la lista de variables de la API de Meteocat."""
+
+    _cache = Cache(".meteocat_cache")  # Directorio donde se guardará la caché
+
+    def __init__(self, api_key: str):
+        """
+        Inicializa la clase MeteocatVariables.
+
+        Args:
+            api_key (str): Clave de API para autenticar las solicitudes.
+        """
+        self.api_key = api_key
+        self.headers = {
+            "Content-Type": "application/json",
+            "X-Api-Key": self.api_key,
+        }
+
+    async def get_variables(self, force_update=False):
+        """
+        Obtiene la lista de variables desde la API de Meteocat. Usa la caché si está disponible.
+
+        Args:
+            force_update (bool): Si es True, fuerza la actualización desde la API.
+
+        Returns:
+            list: Datos de las variables.
+        """
+        # Verificar si las variables están en caché y no se solicita actualización forzada
+        if not force_update and "variables" in self._cache:
+            return self._cache["variables"]
+
+        # Hacer la solicitud a la API para obtener las variables
+        url = f"{BASE_URL}{VARIABLES_URL}"
+        async with aiohttp.ClientSession() as session:
+            try:
+                async with session.get(url, headers=self.headers) as response:
+                    if response.status == 200:
+                        variables = await response.json()
+                        self._cache["variables"] = variables  # Guardar en caché
+                        return variables
+
+                    # Gestionar errores según el código de estado
+                    if response.status == 400:
+                        raise BadRequestError(await response.json())
+                    elif response.status == 403:
+                        error_data = await response.json()
+                        if error_data.get("message") == "Forbidden":
+                            raise ForbiddenError(error_data)
+                        elif error_data.get("message") == "Missing Authentication Token":
+                            raise ForbiddenError(error_data)
+                    elif response.status == 429:
+                        raise TooManyRequestsError(await response.json())
+                    elif response.status == 500:
+                        raise InternalServerError(await response.json())
+                    else:
+                        raise UnknownAPIError(f"Unexpected error {response.status}: {await response.text()}")
+            
+            except aiohttp.ClientError as e:
+                raise UnknownAPIError(
+                    message=f"Error al conectar con la API de Meteocat: {str(e)}",
+                    status_code=0,
+                )
+
+            except Exception as ex:
+                raise UnknownAPIError(
+                    message=f"Error inesperado: {str(ex)}",
+                    status_code=0,
+                )

package/meteocatpy/version.py

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

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "meteocatpy",
+  "version": "0.0.7",
+  "description": "[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\r [![Python version compatibility](https://img.shields.io/pypi/pyversions/meteocatpy)](https://pypi.org/project/meteocatpy)\r [![pipeline status](https://gitlab.com/figorr/meteocatpy/badges/master/pipeline.svg)](https://gitlab.com/figorr/meteocatpy/commits/master)",
+  "main": "index.js",
+  "directories": {
+    "example": "examples",
+    "test": "tests"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "devDependencies": {
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/exec": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^11.0.1",
+    "semantic-release": "^24.2.0"
+  }
+}