getopendatafvg 0.2.0__tar.gz

getopendatafvg-0.2.0/.gitignore

@@ -0,0 +1,16 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+build/
+dist/
+.venv/
+venv/
+.pytest_cache/
+.ruff_cache/
+.coverage
+coverage.xml
+htmlcov/
+.mypy_cache/
+.env
+site/

getopendatafvg-0.2.0/CHANGELOG.md

@@ -0,0 +1,114 @@
+# Changelog
+
+All notable changes to getopendatafvg are recorded here. The format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the project
+uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html): 0.x until
+the first stable release, with the public API defined as exactly
+`getopendatafvg.__all__`.
+
+Every public name must appear somewhere in this file:
+`tests/test_public_api.py` fails otherwise. A new export therefore needs an
+entry here in the same change.
+
+## [Unreleased]
+
+## [0.2.0] - 2026-11-11
+
+### Added
+
+- `fetch_known_dataset`, which dispatches a catalog entry to the right
+  client (WFS or portal) so callers no longer branch on `entry.source`.
+- Boundary filtering for portal entries:
+  - through `KnownDataset.geometry_column`, using SoQL `within_box`;
+  - through `KnownDataset.lon_lat_columns` plus `lon_lat_box_clause`, for
+    datasets that store points as numeric longitude/latitude columns.
+- `search_open_data_fvg` and `PortalAsset`, a full-text search over the
+  portal's own catalog. It covers every asset type, including the saved
+  views (`filter`) that `only=dataset` hides.
+- ISTAT:
+  - `fetch_employment_rate` and `FVG_NUTS_AREAS`. The flow has no comune
+    granularity, and it uses the pre-2013 NUTS codes (`ITD4`).
+  - `fetch_tourism_capacity` (down to comune) and `fetch_tourism_flows`
+    (down to province).
+  - `fetch_consumer_price_index` (down to province).
+- `fetch_avalanche_sites` and `AvalancheSite`. These merge the
+  ground-surveyed and photo-interpreted avalanche layers, grouped by site.
+- Catalog grown from 43 to 94 entries:
+  - 32 WFS layers;
+  - 9 portal datasets;
+  - one example entry per municipal budget family;
+  - 7 ARPA FVG air-quality series under a new `aria` category.
+- `docs/upstream-defects.md`, a registry of 19 upstream defects and traps
+  with how each is handled. Tests that pin an entry carry a `quirk`
+  marker, so `pytest -m quirk` runs them, and a test keeps the registry
+  and the markers in step. An opt-in live suite,
+  `tests/test_upstream_defects_live.py`, checks that each defect still
+  exists upstream.
+- An API reference built with MkDocs and mkdocstrings, published to
+  GitHub Pages; CI fails if it does not build cleanly or if a public
+  name is missing from it.
+- A release workflow that publishes to PyPI through trusted publishing
+  when a GitHub release is published, after checking that the tag
+  matches the package version.
+- CI:
+  - Python 3.11–3.13 matrix;
+  - branch coverage with a 95% floor;
+  - a weekly scheduled run of the live catalog checks.
+
+### Changed
+
+- The source distribution now contains only the package, its tests, and
+  the files needed to cite and build it.
+
+### Deprecated
+
+- `fetch_elevation` and `fetch_wikipedia_summary` now emit a
+  `DeprecationWarning` and will be removed in 1.0. Neither is specific to
+  Friuli Venezia Giulia. Use `DemSampler` or Open-Elevation directly in
+  place of the first, and the Wikipedia REST API in place of the second.
+
+### Fixed
+
+- Five catalog entries pointed at the wrong WFS workspace, for example
+  `IDROGRAF:CORSI_ACQUA` instead of `IRDAT:CORSI_ACQUA`.
+
+## [0.1.0] - 2026-09-15
+
+First release of the library, repurposed from an earlier project in this
+repository.
+
+### Added
+
+- Satellite imagery:
+  - `fetch_sentinel2_scene`, `CdseCredentials`, `Band`, `DEFAULT_BANDS`,
+    `Sentinel2Scene`;
+  - `fetch_landsat_scene`, `UsgsCredentials`, `LandsatScene`;
+  - `NoCleanSceneFoundError`;
+  - `sentinel2_scene_date`, `landsat_scene_date`.
+- Indices and rasters: `compute_ndvi`, `compute_nbr`, `compute_lst`,
+  `IndexRaster`, `classify_and_vectorize`, `ClassBreak`, `plot_index`.
+- WFS: `fetch_wfs_features`, `fetch_and_clip_wfs_features`,
+  `clip_to_boundary`.
+- Open Data FVG portal: `fetch_open_data_fvg`, `within_box_clause`.
+- Catalog: `CATALOG`, `KnownDataset`, `list_known_datasets`,
+  `search_known_datasets`, starting with 43 entries.
+- ISTAT SDMX:
+  - `fetch_istat_dataflow`, `fetch_population_series`,
+    `fetch_demographic_balance`, `fetch_demographic_indicators`,
+    `fetch_bank_branches`, `fetch_income_series`;
+  - a client-side rate limit;
+  - the end-period off-by-one correction.
+- OpenStreetMap: `query_overpass`, `fetch_overpass_elements`,
+  `boundary_poly_filter`, `element_point`.
+- Cadastre: `fetch_cadastral_parcels`, `region_parquet_name`.
+- Terrain and geometry:
+  - `DemSampler`, `compute_line_slope`, `compute_line_grade`,
+    `slope_class_for_value`;
+  - `build_coverage_union`, `line_coverage_pct`;
+  - `build_pmtiles`, `TippecanoeNotFoundError`.
+- Other sources: `fetch_historical_weather`, `DailyWeather`,
+  `fetch_elevation`, `fetch_wikipedia_summary`.
+
+[Unreleased]: https://github.com/leoventuroso/getopendatafvg/compare/v0.2.0...HEAD
+[0.2.0]: https://github.com/leoventuroso/getopendatafvg/compare/v0.1.0...v0.2.0
+[0.1.0]: https://github.com/leoventuroso/getopendatafvg/releases/tag/v0.1.0

getopendatafvg-0.2.0/CITATION.cff

@@ -0,0 +1,27 @@
+cff-version: 1.2.0
+message: "If you use this software, please cite it using the metadata below."
+type: software
+title: "getopendatafvg"
+abstract: >-
+  A Python library that extracts open geographic, socio-economic and
+  environmental data for a comune or area of Friuli Venezia Giulia (Italy):
+  the regional WFS GeoServer and Open Data portal, ISTAT statistics,
+  cadastral parcels, OpenStreetMap, and Sentinel-2/Landsat imagery, with
+  documented upstream defects handled and tested against the live services.
+authors:
+  - family-names: Venturoso
+    given-names: Leonardo
+    affiliation: "Fraunhofer Italia Research"
+    orcid: "https://orcid.org/0000-0001-7789-2412"
+version: 0.2.0
+date-released: 2026-11-11
+license: MIT
+repository-code: "https://github.com/leoventuroso/getopendatafvg"
+url: "https://github.com/leoventuroso/getopendatafvg"
+keywords:
+  - open data
+  - Friuli Venezia Giulia
+  - GIS
+  - ISTAT
+  - WFS
+  - remote sensing

getopendatafvg-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Leonardo Venturoso
+
+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.