ESCatastroLib 0.0.1rc4__tar.gz → 1.0.0__tar.gz

escatastrolib-0.0.1rc4/README.md → escatastrolib-1.0.0/PKG-INFO

@@ -1,3 +1,33 @@
+Metadata-Version: 2.4
+Name: ESCatastroLib
+Version: 1.0.0
+Summary: Una librería de Python para consultar los datos del Catastro COMO OBJETOS. Incluye información geográfica.
+Project-URL: Documentation, https://github.com/IvanitiX/ESCatastroLib#readme
+Project-URL: Issues, https://github.com/IvanitiX/ESCatastroLib/issues
+Project-URL: Source, https://github.com/IvanitiX/ESCatastroLib
+Author-email: "Iván V.R" <IvanVR@protonmail.com>
+License: Apache License (2.0)
+License-File: LICENSE
+Keywords: catastro,espana,gis,spain
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Natural Language :: Spanish
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Dist: folium
+Requires-Dist: geopandas<0.14; python_version < '3.9'
+Requires-Dist: geopandas>=0.14; python_version >= '3.9'
+Requires-Dist: geopy
+Requires-Dist: pyarrow<14; python_version < '3.9'
+Requires-Dist: pyarrow>=14; python_version >= '3.9'
+Requires-Dist: requests
+Requires-Dist: shapely<2; python_version < '3.9'
+Requires-Dist: shapely>=2; python_version >= '3.9'
+Requires-Dist: xmltodict
+Description-Content-Type: text/markdown
+
 # ESCatastroLib
 
 La librería ESCatastroLib proporciona una interfaz sencilla para consultar el Catastro de España y obtener información geográfica precisa. Con esta librería, puedes acceder a datos como la ubicación de parcelas, características de construcción y valores geográficos.
@@ -88,6 +118,34 @@ referencia a una MetaParcela.
 * `regiones (list)`: Una lista de regiones en la parcela con una descripción y superficie.
 * `centroide (dict)`:  Las coordenadas del centroide de la parcela. (Latitud y longitud)
 * `geometria (list)`:  Una lista de puntos que representan la geometría de la parcela. (Latitud y longitud)
+* `superficie_total (float)`:  La superficie total de la parcela en metros cuadrados.
+* `superficie_construida (float)`:  La superficie construida en metros cuadrados.
+* `superficie (float)`:  La superficie total de las regiones en metros cuadrados.
+
+**Métodos:**
+
+* `distancias_aristas` (property): Calcula las distancias entre puntos consecutivos de la geometría de la parcela.
+  * Returns: `Optional[List[float]]` - Lista de distancias entre aristas consecutivas en metros, o None si no hay geometría.
+
+* `perimetro` (property): Calcula el perímetro total de la geometría de la parcela.
+  * Returns: `Optional[float]` - Perímetro total en metros, o None si no hay geometría.
+
+* `valor_catastral_urbano_m2(anio: int) -> Optional[float]`: Obtiene el valor catastral por metro cuadrado para parcelas urbanas.
+  * Args: `anio` (int) - Año del valor catastral a consultar.
+  * Returns: Valor catastral en €/m², 0 si es rústica, o None si hay algún error.
+
+* `valor_catastral_rustico_m2(anio: str) -> Optional[Dict]`: Obtiene los valores catastrales de tierras para parcelas rústicas.
+  * Args: `anio` (str) - Año del valor catastral a consultar.
+  * Returns: Diccionario con `region`, `nombre_region` y `modulos_€/ha`, o None si no se encuentran.
+
+* `numero_plantas` (property): Obtiene el número de plantas de un edificio.
+  * Returns: `Dict[str, Any]` con claves `plantas`, `sotanos` y `total`.
+
+* `to_dataframe()`: Convierte la parcela en un GeoDataFrame de GeoPandas.
+* `to_json(filename: Optional[str] = None) -> str`: Convierte la parcela a JSON.
+* `to_csv(filename: Optional[str] = None) -> str`: Convierte la parcela a CSV.
+* `to_shapefile(filename: str)`: Guarda la parcela como Shapefile.
+* `to_parquet(filename: str)`: Guarda la parcela como Parquet.
 
 
 ## Clase MetaParcela

escatastrolib-0.0.1rc4/PKG-INFO → escatastrolib-1.0.0/README.md

@@ -1,31 +1,3 @@
-Metadata-Version: 2.4
-Name: ESCatastroLib
-Version: 0.0.1rc4
-Summary: Una librería de Python para consultar los datos del Catastro COMO OBJETOS. Incluye información geográfica.
-Project-URL: Documentation, https://github.com/IvanitiX/ESCatastroLib#readme
-Project-URL: Issues, https://github.com/IvanitiX/ESCatastroLib/issues
-Project-URL: Source, https://github.com/IvanitiX/ESCatastroLib
-Author-email: "Iván V.R" <IvanVR@protonmail.com>
-License: Apache License (2.0)
-License-File: LICENSE
-Keywords: catastro,espana,gis,spain
-Classifier: Development Status :: 3 - Alpha
-Classifier: Framework :: Pytest
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Natural Language :: Spanish
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Topic :: Software Development :: Build Tools
-Requires-Dist: folium
-Requires-Dist: geopandas
-Requires-Dist: pyarrow
-Requires-Dist: pytest
-Requires-Dist: requests
-Requires-Dist: shapely
-Requires-Dist: xmltodict
-Description-Content-Type: text/markdown
-
 # ESCatastroLib
 
 La librería ESCatastroLib proporciona una interfaz sencilla para consultar el Catastro de España y obtener información geográfica precisa. Con esta librería, puedes acceder a datos como la ubicación de parcelas, características de construcción y valores geográficos.
@@ -116,6 +88,34 @@ referencia a una MetaParcela.
 * `regiones (list)`: Una lista de regiones en la parcela con una descripción y superficie.
 * `centroide (dict)`:  Las coordenadas del centroide de la parcela. (Latitud y longitud)
 * `geometria (list)`:  Una lista de puntos que representan la geometría de la parcela. (Latitud y longitud)
+* `superficie_total (float)`:  La superficie total de la parcela en metros cuadrados.
+* `superficie_construida (float)`:  La superficie construida en metros cuadrados.
+* `superficie (float)`:  La superficie total de las regiones en metros cuadrados.
+
+**Métodos:**
+
+* `distancias_aristas` (property): Calcula las distancias entre puntos consecutivos de la geometría de la parcela.
+  * Returns: `Optional[List[float]]` - Lista de distancias entre aristas consecutivas en metros, o None si no hay geometría.
+
+* `perimetro` (property): Calcula el perímetro total de la geometría de la parcela.
+  * Returns: `Optional[float]` - Perímetro total en metros, o None si no hay geometría.
+
+* `valor_catastral_urbano_m2(anio: int) -> Optional[float]`: Obtiene el valor catastral por metro cuadrado para parcelas urbanas.
+  * Args: `anio` (int) - Año del valor catastral a consultar.
+  * Returns: Valor catastral en €/m², 0 si es rústica, o None si hay algún error.
+
+* `valor_catastral_rustico_m2(anio: str) -> Optional[Dict]`: Obtiene los valores catastrales de tierras para parcelas rústicas.
+  * Args: `anio` (str) - Año del valor catastral a consultar.
+  * Returns: Diccionario con `region`, `nombre_region` y `modulos_€/ha`, o None si no se encuentran.
+
+* `numero_plantas` (property): Obtiene el número de plantas de un edificio.
+  * Returns: `Dict[str, Any]` con claves `plantas`, `sotanos` y `total`.
+
+* `to_dataframe()`: Convierte la parcela en un GeoDataFrame de GeoPandas.
+* `to_json(filename: Optional[str] = None) -> str`: Convierte la parcela a JSON.
+* `to_csv(filename: Optional[str] = None) -> str`: Convierte la parcela a CSV.
+* `to_shapefile(filename: str)`: Guarda la parcela como Shapefile.
+* `to_parquet(filename: str)`: Guarda la parcela como Parquet.
 
 
 ## Clase MetaParcela

escatastrolib-1.0.0/TODO_Python314_Compatibility.md

@@ -0,0 +1,40 @@
+# TODO: Python 3.8-3.14 Compatibility Update
+
+## Objective
+Update the ESCatastroLib library to be compatible with Python versions 3.8 through 3.14.
+
+## Tasks
+
+### 1. Update pyproject.toml
+- [x] Add "3.14" to the test matrix under `[tool.hatch.envs.test.matrix]`
+- [ ] Ensure all dependencies support Python 3.8-3.14 range
+
+### 2. Code Review and Updates
+- [x] Review `src/escatastrolib/models/InfoCatastral.py` for deprecated patterns
+- [x] Review `src/escatastrolib/utils/utils.py` for deprecated patterns
+- [x] Check for any `list(dict.values())[0]` patterns that may need updating
+- [x] Verify `typing` imports are compatible with all Python versions
+
+### 3. Testing
+- [x] Verify the library can be imported successfully
+- [x] Run existing tests to ensure compatibility
+- [x] Check for any deprecation warnings
+
+### 4. Documentation
+- [ ] Update README.md if needed
+- [ ] Verify classifiers in pyproject.toml are accurate
+
+## Notes
+- Must maintain backward compatibility with Python 3.8
+- Python 3.14 may have stricter type checking and deprecation warnings
+- Some patterns may work but trigger deprecation warnings
+
+## Progress
+- [x] Analyzed codebase structure
+- [x] Reviewed pyproject.toml configuration
+- [x] Reviewed main source files for potential compatibility issues
+- [x] Implemented updates for Python 3.14 compatibility
+- [x] Updated pyproject.toml to include Python 3.14 in test matrix
+- [x] Verified library imports successfully
+- [x] Ran tests to verify compatibility
+

escatastrolib-1.0.0/TODO_Refactorizacion.md

@@ -0,0 +1,34 @@
+# TODO: Refactorización de InfoCatastral.py
+
+## Objetivo
+Refactorizar el archivo `src/escatastrolib/models/InfoCatastral.py` para mejorar:
+- Eliminación de código duplicado entre `ParcelaCatastral` y `MetaParcela`
+- Mejor manejo de errores
+- Type hints en todos los métodos
+- Docstrings mejorados
+
+## Cambios de Nomenclatura
+- `BaseParcela` → `ParcelaHelper`
+- `_make_api_request` → `_llamar_a_api`
+
+## Estado Actual (Actualizado: 2024)
+- ✅ Fase 1: Extracción de funcionalidades comunes - COMPLETADA
+- ✅ Fase 2: Refactorización de ParcelaCatastral - COMPLETADA
+- ✅ Fase 3: Refactorización de MetaParcela - COMPLETADA
+- ✅ Fase 4: Validación - COMPLETADA (10 tests pasan)
+- ✅ Fase 5: Type Hints y Docstrings Faltantes - COMPLETADA
+  - ✅ `__create_regions()` - type hints y docstring agregados
+  - ✅ `__create_geometry()` - type hints y docstring agregados, usa `_llamar_a_api()`
+  - ✅ `distancias_aristas` - type hints agregados (`Optional[List[float]]`)
+  - ✅ `perimetro` - type hints agregados (`Optional[float]`)
+  - ✅ `valor_catastral_urbano_m2()` - type hints agregados, usa `_llamar_a_api()`
+  - ✅ `numero_plantas` - type hints y docstring mejorados
+  - ✅ `valor_catastral_rustico_m2()` - type hints en parámetro
+
+## Tests
+- ✅ Todos los 10 tests pasan sin regresiones
+
+## Notas
+- Mantener compatibilidad con la API existente
+- No cambiar la firma pública de los métodos
+

{escatastrolib-0.0.1rc4 → escatastrolib-1.0.0}/pyproject.toml

@@ -19,17 +19,27 @@ classifiers = [
     "Topic :: Software Development :: Build Tools",
     "License :: OSI Approved :: Apache Software License",
     "Operating System :: OS Independent",
-    "Natural Language :: Spanish",
-    "Framework :: Pytest",
+    "Natural Language :: Spanish"
 ]
+
 dependencies = [
-    "geopandas",
-    "shapely",
-    "pyarrow",
-    "pytest",
-    "requests",
-    "xmltodict",
-    "folium"
+  # comunes (siempre)
+  "requests",
+  "xmltodict",
+  "folium",
+  "geopy",
+
+  # --- shapely ---
+  "shapely<2; python_version<'3.9'",
+  "shapely>=2; python_version>='3.9'",
+
+  # --- geopandas ---
+  "geopandas<0.14; python_version<'3.9'",
+  "geopandas>=0.14; python_version>='3.9'",
+
+  # --- pyarrow ---
+  "pyarrow<14; python_version<'3.9'",
+  "pyarrow>=14; python_version>='3.9'",
 ]
 
 
@@ -45,11 +55,17 @@ path = "src/escatastrolib/__about__.py"
 extra-dependencies = [
   "mypy>=1.0.0",
 ]
+
 [tool.hatch.envs.types.scripts]
 check = "mypy --install-types --non-interactive {args:src/escatastrolib tests}"
 
-[[tool.hatch.envs.test.matrix]]
-python = ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13"]
+[tool.hatch.envs.hatch-test]
+dependencies = [
+  "pytest",
+]
+
+[[tool.hatch.envs.hatch-test.matrix]]
+python = ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
 
 [tool.coverage.run]
 source_pkgs = ["escatastrolib", "tests"]
@@ -69,3 +85,4 @@ exclude_lines = [
   "if __name__ == .__main__.:",
   "if TYPE_CHECKING:",
 ]
+

{escatastrolib-0.0.1rc4 → escatastrolib-1.0.0}/src/escatastrolib/__about__.py

@@ -1,4 +1,4 @@
 # SPDX-FileCopyrightText: 2025-present Iván V.R <IvanVR@protonmail.com>
 #
 # SPDX-License-Identifier: MIT
-__version__ = '0.0.1rc4'
+__version__ = '1.0.0'