# GisBR — QGIS plugin metadata

[general]
name=GisBR
qgisMinimumVersion=3.16
description=Load official Brazilian spatial data (IBGE/IPEA geobr + censobr) and run a municipal Master Plan diagnostic in QGIS, using only the native QGIS API.
version=0.4.3
author=Diego Camargo
email=dg.camargo@proton.me
supportsQt6=True

about=GisBR brings the "one line -> one layer" access of the geobr/censobr packages (IPEA) into QGIS as a Processing provider, using only the native QGIS/Qt API and the Python standard library (no geopandas/requests/pandas). Phase 1: legacy GeoPackage backend (geobr v1.7.0), fully native. Phase 2: Parquet backend (geobr v2.0.0) read via the GDAL Parquet driver or a pyarrow fallback, plus a join with census tables from censobr. On top of the geobr mirror, GisBR adds a municipal Master Plan diagnostic: a dock panel (state -> municipality) that loads official layers organized in 8 axes (transport, sanitation, demography, environment, education, health, urban, administrative) from WFS and ArcGIS REST services, clipped to the municipality polygon and saved to a local GeoPackage, with an optional Esri World Imagery satellite basemap. Data in SIRGAS 2000 / EPSG:4674. Licensed under GPL-3.0.

tracker=https://github.com/d-camargo/gisbr/issues
repository=https://github.com/d-camargo/gisbr
homepage=https://github.com/d-camargo/gisbr

hasProcessingProvider=yes

changelog=
    0.4.3
    - Fix: two error handlers discarded their exception silently. Failing to
      remove the cached metadata file when refreshing the catalog, and failing
      to read the local Overpass cache while falling back to it, are now
      reported with the underlying cause instead of being swallowed.
    - No functional change: the 0.4.2 SSL fix is unchanged and ships here.
    0.4.2
    - Fix (SSL on freshly installed Windows/OSGeo4W): downloads failed with
      "unable to find issuer certificate" because the bundled CA material only
      covered the IPEA server and was only injected in the geobr downloader.
      The plugin now ships the self-signed roots used by the GitHub mirror,
      SICAR, ANA/SNIRH, INDE, SGB, IBAMA, Overpass and the satellite basemap.
    - The certificate injection moved to a single module (core/ssl_support.py)
      and is now applied to the WFS, ArcGIS REST and Overpass connectors, plus
      the default SSL configuration used by the XYZ basemap.
    - Certificates are only added as trust anchors; no verification setting is
      ever relaxed.
    - Network failures now report the host and the underlying error instead of
      a generic message.
    0.4.1
    - Fix (QGIS 4.x / Qt6): the cache directory lookup used the unscoped
      QStandardPaths.CacheLocation enum, which raises on PyQt6 and made the
      municipality list fail with "geobr catalog unavailable". The enum is now
      scoped, and the same fix was applied to the Overpass network error check.
    - The catalog error message now appends the real underlying exception
      instead of only showing the generic connection hint.
    - The metadata cache path is resolved defensively, so a cache failure falls
      back to the bundled offline CSV instead of aborting.
    - Declares supportsQt6 so Qt6 builds of QGIS offer the plugin.
    0.4.0
    - Added explicit QGIS 4.x compatibility
    0.3.2
    - New: municipal OSM road network via Overpass — links + nodes topology,
      persisted to the municipality GeoPackage, with the same skip-if-exists
      behavior as the WFS/ArcGIS sources.
    - Robust error handling for Overpass fetches (network errors, invalid
      JSON responses, per-source timeout honored).
    - Fix: SSL certificate failure when loading IPEA metadata on Windows,
      with a safe fallback.
    - First non-experimental release.
    0.3.1
    - Packaging: exclude the scratch/ research scripts from the published zip
      (they used urllib/ssl/xml and were flagged by the repository security scan).
      No change to plugin behavior.
    0.3.0
    - Master Plan diagnostic: dock panel (state -> municipality) that loads
      official layers by axis into a local GeoPackage.
    - New connectors: WFS (CQL_FILTER) and ArcGIS REST (where=), plus an Esri
      World Imagery satellite basemap.
    - 29-source declarative catalog across 8 axes; server-side filter by
      municipality with client-side clip to the municipality polygon.
    0.2.0
    - Phase 2: Parquet backend (geobr v2.0.0) with 28 read_*_v2 algorithms.
    - censobr integration: join_censo joins geobr census tracts with census tables.
    - Parquet read via the GDAL driver or a pyarrow fallback (driver-independent).
    - 55 algorithms total (26 v1 + 28 v2 + join_censo).
    0.1.0
    - Initial release (Phase 1): Processing provider with the legacy GPKG v1.7.0 backend.
    - read_country, read_region, read_state, read_municipality, read_census_tract,
      read_weighting_area, read_metro_area, read_biomes and more.
    - On-disk cache and mirror fallback (IPEA -> GitHub).
    - Fully PyQGIS + stdlib, no external dependencies.

tags=brazil,brasil,ibge,ipea,geobr,censobr,boundaries,census,municipios,vector
category=Vector
icon=icon.png
experimental=False
deprecated=False
server=False
qgisMaximumVersion=4.99
