PyGeoFetch 1.0.8__tar.gz → 1.0.9__tar.gz

{pygeofetch-1.0.8 → pygeofetch-1.0.9}/CHANGELOG.md

@@ -1,9 +1,9 @@
 # Changelog
 
 All notable changes to PyGeoFetch are documented here.
-Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.8/).
+Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.9/).
 
-## [1.0.8] — 2026-07-12
+## [1.0.9] — 2026-07-12
 
 ### Added
 - Federated search across 22+ satellite data providers

{pygeofetch-1.0.8/pygeofetch.egg-info → pygeofetch-1.0.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pygeofetch
-Version: 1.0.8
+Version: 1.0.9
 Summary: Universal satellite data pipeline — unified access to 22+ providers
 Author: PyGeoFetch Contributors
 License: MIT License
@@ -85,9 +85,9 @@ Dynamic: license-file
 
 <div align="center">
 
-<!-- <img src="https://appiahkubis14.github.io/portfolio/logo/samuel_logo_dark.svg" alt="PyGeoFetch Logo" width="200"/> -->
+<!-- <img src="https://appiahkubis14.github.io/portfolio/logo/samuel_logo_dark.svg" alt="pygeofetch Logo" width="200"/> -->
 
-# PyGeoFetch 🛰️
+# pygeofetch 🛰️
 
 [![PyPI version](https://badge.fury.io/py/pygeofetch.svg)](https://pypi.org/project/pygeofetch/)
 [![Python Versions](https://img.shields.io/pypi/pyversions/pygeofetch.svg)](https://pypi.org/project/pygeofetch/)
@@ -103,9 +103,9 @@ Dynamic: license-file
 
 ## 📖 Introduction
 
-PyGeoFetch is a **production-ready satellite data acquisition and processing framework** that provides unified, authenticated access to 22+ Earth observation repositories — including Sentinel, Landsat, Planet, Maxar, Airbus, Copernicus, USGS, NASA, JAXA, and more — through a single consistent CLI and Python API.
+pygeofetch is a **production-ready satellite data acquisition and processing framework** that provides unified, authenticated access to 22+ Earth observation repositories — including Sentinel, Landsat, Planet, Maxar, Airbus, Copernicus, USGS, NASA, JAXA, and more — through a single consistent CLI and Python API.
 
-The package abstracts away the authentication complexity, API fragmentation, and format inconsistencies of individual satellite providers, and adds a complete geospatial processing engine on top. PyGeoFetch provides six core capabilities:
+The package abstracts away the authentication complexity, API fragmentation, and format inconsistencies of individual satellite providers, and adds a complete geospatial processing engine on top. pygeofetch provides six core capabilities:
 
 1. **Authenticated access** to 22+ providers, with secure credential storage via system keyring (macOS Keychain, Windows Credential Manager, Linux Secret Service).
 2. **Unified federated search** across all providers, returning standardized STAC 1.0 GeoJSON, GeoParquet, or CSV results sortable by cloud cover, date, or relevance score.
@@ -122,7 +122,7 @@ Accessing satellite data at scale is surprisingly fragmented. Each provider —
 
 Existing tools address parts of this problem: EODAG supports several providers but lacks pipeline orchestration and commercial coverage; `pystac-client` handles STAC-compliant endpoints only; `sentinelsat` is Sentinel-specific. No single tool covers the full breadth of providers, processing, and automation needed for operational geospatial workflows.
 
-| Feature | PyGeoFetch | EODAG | pystac-client | satpy | sentinelsat |
+| Feature | pygeofetch | EODAG | pystac-client | satpy | sentinelsat |
 |---|---|---|---|---|---|
 | **Providers** | **22+** | 10+ | STAC only | Limited | Sentinel only |
 | **Processing Engine** | ✅ Full | ❌ | ❌ | Partial | ❌ |
@@ -233,26 +233,26 @@ Existing tools address parts of this problem: EODAG supports several providers b
 
 ```bash
 # Core — free providers work immediately, no extras needed
-pip install PyGeoFetch
+pip install pygeofetch
 
 # + Raster/vector processing (rasterio, geopandas, shapely)
-pip install "PyGeoFetch[geo]"
+pip install "pygeofetch[geo]"
 
 # + Cloud provider S3 access
-pip install "PyGeoFetch[cloud]"
+pip install "pygeofetch[cloud]"
 
 # + Cron scheduling
-pip install "PyGeoFetch[schedule]"
+pip install "pygeofetch[schedule]"
 
 # Everything
-pip install "PyGeoFetch[all]"
+pip install "pygeofetch[all]"
 ```
 
 **Requirements:** Python 3.9+
 
 Verify your installation:
 ```bash
-PyGeoFetch doctor
+pygeofetch doctor
 # ✓ Python 3.11   ✓ httpx   ✓ pydantic   ✓ rich
 # ✓ AWS Earth Search: HTTP 200
 # ✓ Planetary Computer: HTTP 200
@@ -267,12 +267,12 @@ PyGeoFetch doctor
 
 ```bash
 # Add credentials (free providers need no credentials at all)
-PyGeoFetch auth add usgs --username USER --password PASS
-PyGeoFetch auth add copernicus --username email@example.com --password PASS
-PyGeoFetch auth add planet --api-key YOUR_KEY
+pygeofetch auth add usgs --username USER --password PASS
+pygeofetch auth add copernicus --username email@example.com --password PASS
+pygeofetch auth add planet --api-key YOUR_KEY
 
 # Search (free — no login)
-PyGeoFetch search run \
+pygeofetch search run \
     --bbox "-74.1,40.6,-73.7,40.9" \
     --start-date 2024-01-01 \
     --cloud-cover 0-15 \
@@ -281,7 +281,7 @@ PyGeoFetch search run \
     --output results.geojson
 
 # Download with band selection
-PyGeoFetch download run \
+pygeofetch download run \
     --from-search results.geojson \
     --output ./data/ \
     --parallel 4 \
@@ -289,7 +289,7 @@ PyGeoFetch download run \
     --max-items 3
 
 # Download with full post-processing chain
-PyGeoFetch download run \
+pygeofetch download run \
     --from-search results.geojson \
     --output ./data/ \
     --parallel 4 \
@@ -301,11 +301,11 @@ PyGeoFetch download run \
 
 ```python
 from pathlib import Path
-from pygeofetch import PyGeoFetch
+from pygeofetch import pygeofetch
 from pygeofetch.models.search_query import SearchQuery, BoundingBox
 from pygeofetch.models.download_task import DownloadOptions
 
-client = PyGeoFetch()
+client = pygeofetch()
 
 # Credentials
 client.add_credentials("usgs",       username="user", password="pass")
@@ -400,18 +400,18 @@ steps:
 
 ```bash
 # Validate without running
-PyGeoFetch proc-pipeline validate weekly-sentinel2.yaml
+pygeofetch proc-pipeline validate weekly-sentinel2.yaml
 
 # Run once
-PyGeoFetch proc-pipeline run weekly-sentinel2.yaml --input scene.tif
+pygeofetch proc-pipeline run weekly-sentinel2.yaml --input scene.tif
 
 # Schedule (recurring)
-PyGeoFetch pipeline schedule weekly-sentinel2.yaml --name "ndvi-weekly"
+pygeofetch pipeline schedule weekly-sentinel2.yaml --name "ndvi-weekly"
 
 # Generate a starter template
-PyGeoFetch proc-pipeline template ndvi
-PyGeoFetch proc-pipeline template flood_map
-PyGeoFetch proc-pipeline template change_detection
+pygeofetch proc-pipeline template ndvi
+pygeofetch proc-pipeline template flood_map
+pygeofetch proc-pipeline template change_detection
 ```
 
 ---
@@ -420,25 +420,25 @@ PyGeoFetch proc-pipeline template change_detection
 
 ```
 SYSTEM
-  PyGeoFetch doctor                     diagnose installation + connectivity
-  PyGeoFetch status [--json]            provider and cache overview
-  PyGeoFetch version
+  pygeofetch doctor                     diagnose installation + connectivity
+  pygeofetch status [--json]            provider and cache overview
+  pygeofetch version
 
 AUTH
-  PyGeoFetch auth add PROVIDER [--username U] [--password P] [--api-key K]
-  PyGeoFetch auth login PROVIDER        interactive prompt
-  PyGeoFetch auth list [--json]
-  PyGeoFetch auth test PROVIDER
-  PyGeoFetch auth remove PROVIDER [--yes]
-  PyGeoFetch auth export [--output FILE]
+  pygeofetch auth add PROVIDER [--username U] [--password P] [--api-key K]
+  pygeofetch auth login PROVIDER        interactive prompt
+  pygeofetch auth list [--json]
+  pygeofetch auth test PROVIDER
+  pygeofetch auth remove PROVIDER [--yes]
+  pygeofetch auth export [--output FILE]
 
 PROVIDERS
-  PyGeoFetch providers list [--auth|--no-auth] [--capabilities sar] [--json]
-  PyGeoFetch providers info PROVIDER
-  PyGeoFetch providers search "TERM"
+  pygeofetch providers list [--auth|--no-auth] [--capabilities sar] [--json]
+  pygeofetch providers info PROVIDER
+  pygeofetch providers search "TERM"
 
 SEARCH
-  PyGeoFetch search run \
+  pygeofetch search run \
     --bbox "minlon,minlat,maxlon,maxlat"   or  --geometry-file area.geojson
     --start-date YYYY-MM-DD  --end-date YYYY-MM-DD
     --cloud-cover 0-20
@@ -452,7 +452,7 @@ SEARCH
     --no-cache  --timeout 60
 
 DOWNLOAD
-  PyGeoFetch download run \
+  pygeofetch download run \
     --from-search results.geojson
     --output ./data/
     --parallel 4  --retry 5
@@ -466,72 +466,72 @@ DOWNLOAD
     --json
 
 PREPROCESSING
-  PyGeoFetch preprocess atmos         scene.tif --method dos1|sen2cor|flaash|6s
-  PyGeoFetch preprocess cloud-mask    scene.tif --method scl|fmask|threshold
-  PyGeoFetch preprocess cloud-fill    cloudy.tif t1.tif t2.tif
-  PyGeoFetch preprocess topo-correct  scene.tif dem.tif --method cosine
-  PyGeoFetch preprocess clip          scene.tif --bbox "..." | --geometry file.geojson
-  PyGeoFetch preprocess reproject     scene.tif --crs EPSG:4326
-  PyGeoFetch preprocess resample      scene.tif --resolution 30
-  PyGeoFetch preprocess pansharpen    pan.tif ms.tif --method brovey
-  PyGeoFetch preprocess mosaic        s1.tif s2.tif --method first|last|min|max
-  PyGeoFetch preprocess composite     *.tif --method median|mean|max|best_pixel
-  PyGeoFetch preprocess tile          scene.tif --tile-size 512 --overlap 64
+  pygeofetch preprocess atmos         scene.tif --method dos1|sen2cor|flaash|6s
+  pygeofetch preprocess cloud-mask    scene.tif --method scl|fmask|threshold
+  pygeofetch preprocess cloud-fill    cloudy.tif t1.tif t2.tif
+  pygeofetch preprocess topo-correct  scene.tif dem.tif --method cosine
+  pygeofetch preprocess clip          scene.tif --bbox "..." | --geometry file.geojson
+  pygeofetch preprocess reproject     scene.tif --crs EPSG:4326
+  pygeofetch preprocess resample      scene.tif --resolution 30
+  pygeofetch preprocess pansharpen    pan.tif ms.tif --method brovey
+  pygeofetch preprocess mosaic        s1.tif s2.tif --method first|last|min|max
+  pygeofetch preprocess composite     *.tif --method median|mean|max|best_pixel
+  pygeofetch preprocess tile          scene.tif --tile-size 512 --overlap 64
 
 SPECTRAL INDICES
-  PyGeoFetch index ndvi    --red B04.tif --nir B08.tif
-  PyGeoFetch index evi     --blue B02.tif --red B04.tif --nir B08.tif
-  PyGeoFetch index savi    --red B04.tif --nir B08.tif --soil-l 0.5
-  PyGeoFetch index ndwi    --green B03.tif --nir B08.tif
-  PyGeoFetch index mndwi   --green B03.tif --swir1 B11.tif
-  PyGeoFetch index ndbi    --nir B08.tif --swir1 B11.tif
-  PyGeoFetch index ndsi    --green B03.tif --swir1 B11.tif
-  PyGeoFetch index ndmi    --nir B08.tif --swir1 B11.tif
-  PyGeoFetch index nbr     --nir B08.tif --swir2 B12.tif
-  PyGeoFetch index dnbr    --pre-nir B08.tif --pre-swir2 B12.tif \
+  pygeofetch index ndvi    --red B04.tif --nir B08.tif
+  pygeofetch index evi     --blue B02.tif --red B04.tif --nir B08.tif
+  pygeofetch index savi    --red B04.tif --nir B08.tif --soil-l 0.5
+  pygeofetch index ndwi    --green B03.tif --nir B08.tif
+  pygeofetch index mndwi   --green B03.tif --swir1 B11.tif
+  pygeofetch index ndbi    --nir B08.tif --swir1 B11.tif
+  pygeofetch index ndsi    --green B03.tif --swir1 B11.tif
+  pygeofetch index ndmi    --nir B08.tif --swir1 B11.tif
+  pygeofetch index nbr     --nir B08.tif --swir2 B12.tif
+  pygeofetch index dnbr    --pre-nir B08.tif --pre-swir2 B12.tif \
                             --post-nir B08_post.tif --post-swir2 B12_post.tif
-  PyGeoFetch index tct     --blue B02.tif --green B03.tif --red B04.tif \
+  pygeofetch index tct     --blue B02.tif --green B03.tif --red B04.tif \
                             --nir B08.tif --swir1 B11.tif --swir2 B12.tif
-  PyGeoFetch index pca     B02.tif B03.tif B04.tif B08.tif --components 3
-  PyGeoFetch index texture  B08.tif --window 7 --features contrast,homogeneity
-  PyGeoFetch index lst     B10.tif --emissivity 0.97 --sensor landsat8
-  PyGeoFetch index albedo  B02.tif B03.tif B04.tif B08.tif B11.tif B12.tif
-  PyGeoFetch index band-math B04.tif B08.tif --expr "(B[1]-B[0])/(B[1]+B[0]+1e-6)"
-  PyGeoFetch index stack   B02.tif B03.tif B04.tif
+  pygeofetch index pca     B02.tif B03.tif B04.tif B08.tif --components 3
+  pygeofetch index texture  B08.tif --window 7 --features contrast,homogeneity
+  pygeofetch index lst     B10.tif --emissivity 0.97 --sensor landsat8
+  pygeofetch index albedo  B02.tif B03.tif B04.tif B08.tif B11.tif B12.tif
+  pygeofetch index band-math B04.tif B08.tif --expr "(B[1]-B[0])/(B[1]+B[0]+1e-6)"
+  pygeofetch index stack   B02.tif B03.tif B04.tif
 
 POST-PROCESSING
-  PyGeoFetch post vectorize       ndvi.tif --threshold 0.3 --format geojson
-  PyGeoFetch post smooth          polygons.geojson --tolerance 0.5
-  PyGeoFetch post regularize      buildings.geojson
-  PyGeoFetch post zonal-stats     ndvi.tif parcels.geojson --output stats.csv
-  PyGeoFetch post buffer          roads.geojson --distance 15
-  PyGeoFetch post centroids       polygons.geojson
-  PyGeoFetch post geometry-metrics polygons.geojson
-  PyGeoFetch post compress        scene.tif --method lzw|deflate|zstd
-  PyGeoFetch post cog             scene.tif --compress deflate --blocksize 512
+  pygeofetch post vectorize       ndvi.tif --threshold 0.3 --format geojson
+  pygeofetch post smooth          polygons.geojson --tolerance 0.5
+  pygeofetch post regularize      buildings.geojson
+  pygeofetch post zonal-stats     ndvi.tif parcels.geojson --output stats.csv
+  pygeofetch post buffer          roads.geojson --distance 15
+  pygeofetch post centroids       polygons.geojson
+  pygeofetch post geometry-metrics polygons.geojson
+  pygeofetch post compress        scene.tif --method lzw|deflate|zstd
+  pygeofetch post cog             scene.tif --compress deflate --blocksize 512
 
 SAR PROCESSING
-  PyGeoFetch sar despeckle  sar.tif --filter lee|enhanced_lee|frost|gamma --window 7
-  PyGeoFetch sar calibrate  sar.tif --output-type sigma0|gamma0|beta0 --db
-  PyGeoFetch sar flood-map  post.tif --threshold -15 [--reference pre.tif]
-  PyGeoFetch sar coherence  slc1.tif slc2.tif --window 7
+  pygeofetch sar despeckle  sar.tif --filter lee|enhanced_lee|frost|gamma --window 7
+  pygeofetch sar calibrate  sar.tif --output-type sigma0|gamma0|beta0 --db
+  pygeofetch sar flood-map  post.tif --threshold -15 [--reference pre.tif]
+  pygeofetch sar coherence  slc1.tif slc2.tif --window 7
 
 PROCESSING PIPELINES
-  PyGeoFetch proc-pipeline template ndvi|change_detection|flood_map|urban_mapping|...
-  PyGeoFetch proc-pipeline validate FILE
-  PyGeoFetch proc-pipeline run FILE [--input scene.tif] [--output-dir ./out/]
+  pygeofetch proc-pipeline template ndvi|change_detection|flood_map|urban_mapping|...
+  pygeofetch proc-pipeline validate FILE
+  pygeofetch proc-pipeline run FILE [--input scene.tif] [--output-dir ./out/]
 
 DATA PIPELINES (search + download)
-  PyGeoFetch pipeline run|validate|schedule|list-scheduled|unschedule|history
+  pygeofetch pipeline run|validate|schedule|list-scheduled|unschedule|history
 
 CACHE
-  PyGeoFetch cache stats|clear|ttl [show|set N]|location|prune --max-size 1GB
+  pygeofetch cache stats|clear|ttl [show|set N]|location|prune --max-size 1GB
 
 CONFIG
-  PyGeoFetch config show|get KEY|set KEY VALUE|path|reset
+  pygeofetch config show|get KEY|set KEY VALUE|path|reset
 
 COMPLETION
-  PyGeoFetch --install-completion bash|zsh|fish
+  pygeofetch --install-completion bash|zsh|fish
 ```
 
 ---
@@ -600,8 +600,8 @@ Contributions of all kinds are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) f
 Good first issues include implementing stub providers to full API integrations, improving test coverage, and adding new post-processing actions.
 
 ```bash
-git clone https://github.com/appiahkubis14/PyGeoFetch
-cd PyGeoFetch
+git clone https://github.com/appiahkubis14/pygeofetch
+cd pygeofetch
 pip install -e ".[dev,all]"
 pytest tests/unit/ -v
 ```
@@ -610,6 +610,6 @@ pytest tests/unit/ -v
 
 ## 📄 License
 
-PyGeoFetch is free and open source software, licensed under the [MIT License](LICENSE).
+pygeofetch is free and open source software, licensed under the [MIT License](LICENSE).
 
-© 2025 PyGeoFetch Contributors. Part of the **PyGeoVision** platform — [PyGeoFetch](https://github.com/appiahkubis14/PyGeoFetch) (data + processing) + [GeoAI](https://opengeoai.org) (AI) = complete Earth observation pipeline.
+© 2025 pygeofetch Contributors. Part of the **PyGeoVision** platform — [pygeofetch](https://github.com/appiahkubis14/pygeofetch) (data + processing) + [GeoAI](https://opengeoai.org) (AI) = complete Earth observation pipeline.