PyGeoFetch 0.1.0__py3-none-any.whl

pygeofetch-0.1.0.dist-info/METADATA

@@ -0,0 +1,720 @@
+Metadata-Version: 2.4
+Name: PyGeoFetch
+Version: 0.1.0
+Summary: Universal satellite data download pipeline with unified access to 20+ repositories
+Author: PyGeoFetch Contributors
+License: MIT License
+        
+        Copyright (c) 2024 PyGeoFetch Contributors
+        
+        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.
+        
+Project-URL: Homepage, https://github.com/PyGeoFetch/PyGeoFetch
+Project-URL: Documentation, https://PyGeoFetch.readthedocs.io
+Project-URL: Repository, https://github.com/PyGeoFetch/PyGeoFetch
+Project-URL: Bug Tracker, https://github.com/PyGeoFetch/PyGeoFetch/issues
+Keywords: satellite,remote-sensing,GIS,earth-observation,geospatial
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: GIS
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27
+Requires-Dist: httpx[http2]>=0.27
+Requires-Dist: click>=8.1
+Requires-Dist: pydantic>=2.5
+Requires-Dist: pydantic-settings>=2.1
+Requires-Dist: rich>=13.7
+Requires-Dist: shapely>=2.0
+Requires-Dist: pyproj>=3.6
+Requires-Dist: pystac>=1.9
+Requires-Dist: cryptography>=42.0
+Requires-Dist: keyring>=24.3
+Requires-Dist: aiofiles>=23.2
+Requires-Dist: tenacity>=8.2
+Requires-Dist: PyYAML>=6.0
+Requires-Dist: python-dateutil>=2.9
+Requires-Dist: tqdm>=4.66
+Requires-Dist: anyio>=4.2
+Requires-Dist: boto3>=1.34
+Requires-Dist: requests>=2.31
+Requires-Dist: click-completion>=0.5
+Provides-Extra: geo
+Requires-Dist: rasterio>=1.3; extra == "geo"
+Requires-Dist: geopandas>=0.14; extra == "geo"
+Requires-Dist: pyarrow>=15.0; extra == "geo"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: pytest-cov>=4.1; extra == "dev"
+Requires-Dist: pytest-mock>=3.12; extra == "dev"
+Requires-Dist: vcrpy>=6.0; extra == "dev"
+Requires-Dist: httpx[mock]>=0.27; extra == "dev"
+Requires-Dist: black>=24.0; extra == "dev"
+Requires-Dist: ruff>=0.3; extra == "dev"
+Requires-Dist: mypy>=1.8; extra == "dev"
+Requires-Dist: bump2version>=1.0; extra == "dev"
+Provides-Extra: all
+Requires-Dist: PyGeoFetch[dev,geo]; extra == "all"
+Dynamic: license-file
+
+# PyGeoFetch 🛰️
+
+**Universal satellite data pipeline** — unified access to 22+ satellite repositories with one CLI or Python API.
+
+[![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/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Tests](https://github.com/PyGeoFetch/PyGeoFetch/actions/workflows/tests.yml/badge.svg)](https://github.com/PyGeoFetch/PyGeoFetch/actions)
+[![Coverage](https://codecov.io/gh/PyGeoFetch/PyGeoFetch/branch/main/graph/badge.svg)](https://codecov.io/gh/PyGeoFetch/PyGeoFetch)
+
+---
+
+## Why PyGeoFetch?
+
+| Feature | PyGeoFetch | EODAG | pystac-client | satpy | sentinelsat |
+|---|---|---|---|---|---|
+| **Providers** | **22+** | 10+ | STAC only | Limited | Sentinel only |
+| **CLI** | ✅ Full | ❌ | ❌ | ❌ | ✅ Basic |
+| **Pipeline Orchestration** | ✅ YAML | ❌ | ❌ | ❌ | ❌ |
+| **Auth Management** | ✅ Keyring | Partial | ❌ | ❌ | ✅ |
+| **Parallel Downloads** | ✅ Adaptive | ✅ | ❌ | ❌ | ❌ |
+| **STAC Output** | ✅ Native | ❌ | ✅ | ❌ | ❌ |
+| **GeoParquet** | ✅ | ❌ | ❌ | ❌ | ❌ |
+| **Docker** | ✅ | ❌ | ❌ | ❌ | ❌ |
+| **Scheduler** | ✅ Cron | ❌ | ❌ | ❌ | ❌ |
+| **Webhook Notifications** | ✅ | ❌ | ❌ | ❌ | ❌ |
+| **Commercial Providers** | ✅ Planet/Maxar | ❌ | ❌ | ❌ | ❌ |
+
+---
+
+## Installation
+
+```bash
+pip install PyGeoFetch
+
+# With raster processing support
+pip install "PyGeoFetch[geo]"
+
+# Full installation (all optional deps)
+pip install "PyGeoFetch[all]"
+```
+
+**Requirements:** Python 3.9+
+
+---
+
+## Supported Providers
+
+| Provider | ID | Auth | Satellites | SAR | <1m | STAC |
+|---|---|---|---|---|---|---|
+| USGS Earth Explorer | `usgs` | 🔐 User/Pass | Landsat 1-9, ASTER, MODIS | ❌ | ❌ | ❌ |
+| Copernicus CDSE | `copernicus` | 🔐 OAuth2 | Sentinel-1/2/3/5P | ✅ | ❌ | ✅ |
+| NASA Earthdata CMR | `nasa_earthdata` | 🔐 OAuth2 | MODIS, VIIRS, ICESat-2, GEDI | ❌ | ❌ | ✅ |
+| NASA Earthdata Cloud | `nasa_earthdata_cloud` | 🔐 OAuth2+S3 | Cloud-hosted NASA data | ❌ | ❌ | ✅ |
+| OpenTopography | `opentopography` | 🔐 API Key | SRTM, Copernicus DEM, LiDAR | ❌ | ❌ | ❌ |
+| Planet Labs | `planet` | 🔐 API Key | PlanetScope, SkySat, RapidEye | ❌ | ✅ | ✅ |
+| Sentinel Hub | `sentinel_hub` | 🔐 OAuth2 | Sentinel-1/2/3, Landsat, MODIS | ✅ | ❌ | ❌ |
+| Maxar GBDX | `maxar_gbdx` | 🔐 Token | WorldView 1-4, GeoEye-1 | ❌ | ✅ | ❌ |
+| Airbus OneAtlas | `airbus_oneatlas` | 🔐 API Key | Pléiades, SPOT 6/7 | ❌ | ✅ | ✅ |
+| Alaska Satellite Facility | `alaska_satellite_facility` | 🔐 Earthdata | Sentinel-1, ALOS PALSAR | ✅ | ❌ | ❌ |
+| NOAA Big Data | `noaa_big_data` | 🌐 None | GOES-16/17/18, NEXRAD | ❌ | ❌ | ❌ |
+| Google Earth Engine | `google_earth_engine` | 🔐 Service Acct | Global multi-petabyte catalog | ✅ | ❌ | ❌ |
+| TerraBotics | `terrabotics` | 🔐 API Key | Archive + Tasking | ❌ | ✅ | ❌ |
+| AWS Earth Open Data | `aws_earth` | 🌐 None | Sentinel-2, Landsat, NAIP | ❌ | ❌ | ✅ |
+| Microsoft Planetary Computer | `planetary_computer` | 🌐 None | Sentinel-1/2, Landsat, MODIS, NAIP | ✅ | ❌ | ✅ |
+| Element 84 Earth Search | `element84` | 🌐 None | Sentinel-2 COGs, Landsat Col 2 | ❌ | ❌ | ✅ |
+| ESA SciHub Mirror | `esa_scihub` | 🌐 None | Copernicus public mirrors | ✅ | ❌ | ❌ |
+| JAXA ALOS World | `jaxa_earth` | 🌐 None | ALOS World 3D DSM, PALSAR | ✅ | ❌ | ❌ |
+| ISRO Bhuvan | `isro_bhuvan` | 🌐 None | ResourceSat, Cartosat, Oceansat | ❌ | ❌ | ❌ |
+| INPE CBERS | `inpe_cbers` | 🌐 None | CBERS-4/4A | ❌ | ❌ | ❌ |
+| DigitalGlobe Open Data | `digitalglobe` | 🌐 None | Disaster response imagery | ❌ | ✅ | ❌ |
+| GeoServer Generic | `geoserver_generic` | 🌐 Configurable | Any OGC service | ❌ | ❌ | ❌ |
+
+🔐 = Authentication Required | 🌐 = Open Access (No Login)
+
+---
+
+## Quick Start (5 minutes)
+
+### 1. Add credentials
+
+```bash
+PyGeoFetch auth add usgs --username USER --password PASS
+PyGeoFetch auth add planet --api-key YOUR_KEY
+PyGeoFetch auth login copernicus  # interactive
+```
+
+### 2. Search
+
+```bash
+PyGeoFetch search run \
+    --bbox "-74.1,40.6,-73.7,40.9" \
+    --start-date 2024-01-01 \
+    --cloud-cover 0-15 \
+    --providers planetary_computer \
+    --output results.geojson
+```
+
+![PyGeoFetch search demo](data/test/search.png)
+
+### 3. Download
+
+```bash
+PyGeoFetch download run \
+    --from-search results.geojson \
+    --output ./my_data/ \
+    --parallel 4 \
+    --verify-checksum \
+    --post-process "unzip,reproject:EPSG:4326,compress:lzw"
+```
+
+![PyGeoFetch download demo](data/test/download.png)
+
+---
+
+## Python API
+
+```python
+from pathlib import Path
+from PyGeoFetch import PyGeoFetch
+from PyGeoFetch.models import SearchQuery, DownloadOptions
+
+sb = PyGeoFetch()
+sb.add_credentials("usgs", username="user", password="pass")
+sb.add_credentials("planet", api_key="PL_KEY")
+
+results = sb.search(
+    SearchQuery(
+        bbox=(-74.1, 40.6, -73.7, 40.9),
+        start_date="2024-01-01",
+        end_date="2024-06-01",
+        cloud_cover_max=20,
+    ),
+    providers=["usgs", "copernicus", "planetary_computer", "aws_earth"],
+)
+
+print(f"Found {len(results)} scenes")
+
+download_results = sb.download(
+    results[:5],
+    destination=Path("./data/"),
+    options=DownloadOptions(
+        parallel=4,
+        verify_checksum=True,
+        resume=True,
+        post_process=[],
+    ),
+)
+
+for dr in download_results:
+    if dr.success:
+        print(f"  ✓ {dr.data_id} ({dr.bytes_downloaded // 1024 // 1024:.1f} MB)")
+    else:
+        print(f"  ✗ {dr.data_id}: {dr.error}")
+```
+
+---
+
+## CLI Reference
+
+### Global Options
+```
+PyGeoFetch [--log-level LEVEL] [--log-file FILE] [--log-format console|json]
+                [--config FILE] [--version] [--help] COMMAND [ARGS]
+```
+
+### Authentication
+```bash
+PyGeoFetch auth add PROVIDER --username USER --password PASS
+PyGeoFetch auth add PROVIDER --api-key KEY
+PyGeoFetch auth add PROVIDER --client-id ID --client-secret SECRET
+PyGeoFetch auth login PROVIDER          # interactive
+PyGeoFetch auth list [--json]
+PyGeoFetch auth test PROVIDER
+PyGeoFetch auth remove PROVIDER [--yes]
+PyGeoFetch auth export [--output FILE]
+```
+
+### Providers
+```bash
+PyGeoFetch providers list [--auth|--no-auth] [--capabilities sar,optical,stac] [--region global] [--satellite Landsat] [--json]
+PyGeoFetch providers info PROVIDER [--json]
+PyGeoFetch providers search "landsat" [--json]
+```
+
+### Search
+```bash
+PyGeoFetch search run
+    --bbox "minx,miny,maxx,maxy"       # Bounding box
+    --geometry-file area.geojson        # AOI from GeoJSON file
+    --start-date YYYY-MM-DD
+    --end-date YYYY-MM-DD
+    --cloud-cover MIN-MAX               # e.g. 0-20
+    --resolution MIN-MAX                # metres e.g. 10-30
+    --processing-level LEVEL            # e.g. L2A
+    --providers P1,P2,...
+    --satellites S1,S2,...
+    --max-results N
+    --sort-by datetime|cloud_cover|score|satellite
+    --sort-order asc|desc
+    --cql2 "EXPRESSION"                 # CQL2 filter expression
+    --output FILE
+    --format table|json|stac|geojson|geoparquet|csv|ids
+    --on-provider-failure skip|abort|retry
+    --timeout SECONDS
+    --no-cache
+```
+
+### Download
+```bash
+PyGeoFetch download run
+    --from-search FILE                  # GeoJSON from search run
+    --scene-ids ID1,ID2,...             # Direct scene IDs
+    --output DIRECTORY
+    --parallel N                        # Concurrent downloads
+    --retry N                           # Retry attempts
+    --verify-checksum                   # SHA256 verification
+    --resume                            # Resume interrupted downloads
+    --bandwidth-limit MB                # e.g. 10MB, 500KB
+    --priority high|normal|low
+    --notify webhook:URL                # Slack/Teams webhook
+    --notify email:ADDRESS
+    --post-process "ACTION1,ACTION2"    # Processing chain
+    --on-failure skip|abort|retry
+    --max-items N
+    --overwrite
+```
+
+### Cache
+```bash
+PyGeoFetch cache stats [--json]
+PyGeoFetch cache clear [--provider PROVIDER] [--older-than 7d] [--dry-run]
+PyGeoFetch cache ttl show
+PyGeoFetch cache ttl set SECONDS
+PyGeoFetch cache location
+PyGeoFetch cache prune --max-size 1GB
+```
+
+### Pipeline
+```bash
+PyGeoFetch pipeline run FILE [--step STEP_NAME]
+PyGeoFetch pipeline validate FILE
+PyGeoFetch pipeline schedule FILE [--name NAME] [--cron "0 6 * * 1"]
+PyGeoFetch pipeline list-scheduled [--json]
+PyGeoFetch pipeline unschedule NAME
+PyGeoFetch pipeline logs NAME [--tail 50] [--follow]
+PyGeoFetch pipeline history [--limit 20]
+PyGeoFetch pipeline retry RUN_ID
+```
+
+### Configuration
+```bash
+PyGeoFetch config show [--json]
+PyGeoFetch config get KEY
+PyGeoFetch config set KEY VALUE
+PyGeoFetch config path
+PyGeoFetch config reset
+```
+
+### System
+```bash
+PyGeoFetch status [--json]
+PyGeoFetch version [--json]
+PyGeoFetch doctor                  # Diagnose installation and connectivity
+PyGeoFetch --install-completion bash|zsh|fish
+```
+
+---
+
+## Output Formats
+
+| Format | Flag | Description |
+|---|---|---|
+| Table | `--format table` | Pretty-printed terminal table (default) |
+| JSON | `--format json` | Full JSON response array |
+| STAC | `--format stac` | STAC ItemCollection FeatureCollection |
+| GeoJSON | `--format geojson` | GeoJSON FeatureCollection |
+| GeoParquet | `--format geoparquet` | GeoParquet file (requires `geopandas`) |
+| CSV | `--format csv` | CSV with id, provider, satellite, datetime, cloud_cover, score, bbox |
+| IDs | `--format ids` | Scene IDs only, one per line |
+
+---
+
+## Post-Processing Actions
+
+Chain post-processing actions on downloaded data:
+
+```bash
+PyGeoFetch download run \
+    --from-search results.geojson --output ./data/ \
+    --post-process "unzip,reproject:EPSG:4326,compress:lzw,ndvi,cog"
+```
+
+| Action | Syntax | Description |
+|---|---|---|
+| `unzip` | `unzip` | Extract downloaded ZIP/TAR archives |
+| `reproject` | `reproject:EPSG:4326` | Reproject to target CRS |
+| `compress` | `compress:lzw` | Apply compression (lzw, deflate, zstd) |
+| `ndvi` | `ndvi` | Calculate NDVI from multispectral bands |
+| `ndwi` | `ndwi` | Calculate NDWI water index |
+| `composite` | `composite` | Create temporal composite |
+| `atmospheric` | `atmospheric:sen2cor` | Atmospheric correction |
+| `clip` | `clip:file.geojson` | Clip to geometry |
+| `resample` | `resample:30` | Resample to target resolution (metres) |
+| `cog` | `cog` | Convert to Cloud Optimized GeoTIFF |
+| `merge` | `merge` | Merge overlapping scenes |
+| `pan-sharpen` | `pan-sharpen` | Pan-sharpen multispectral with panchromatic |
+
+Multiple actions execute in order: `"unzip,reproject:EPSG:4326,compress:lzw,cog"`
+
+---
+
+## Pipeline Orchestration
+
+Define recurring workflows in YAML:
+
+```yaml
+# weekly-sentinel2.yaml
+name: weekly-sentinel2-ndvi
+schedule: "0 6 * * 1"  # Every Monday at 06:00 UTC
+description: Weekly Sentinel-2 acquisition for NDVI monitoring
+
+steps:
+  - search:
+      providers: [copernicus, aws_earth, planetary_computer]
+      date_range: last_7_days
+      cloud_cover: 0-10
+      bbox: "-74.1,40.6,-73.7,40.9"
+      max_results: 20
+
+  - filter:
+      expression: "data.cloud_cover < 5"
+
+  - download:
+      parallel: 4
+      output: ./raw/
+      verify_checksum: true
+
+  - export:
+      format: cloud_optimized_geotiff
+      destination: s3://my-bucket/ndvi/
+```
+
+```bash
+# One-shot execution
+PyGeoFetch pipeline run weekly-sentinel2.yaml
+
+# Schedule for recurring execution
+PyGeoFetch pipeline schedule weekly-sentinel2.yaml
+
+# Validate without running
+PyGeoFetch pipeline validate weekly-sentinel2.yaml
+```
+
+---
+
+## Configuration
+
+PyGeoFetch uses a hierarchical config system:
+
+1. Built-in defaults
+2. User config (`~/.PyGeoFetch/config.yaml`)
+3. Project config (`.PyGeoFetch.yaml`)
+4. Environment variables (`SATELLITE_BRIDGE_*`)
+5. CLI arguments
+
+### Full Configuration Reference
+
+```yaml
+# ~/.PyGeoFetch/config.yaml
+
+download:
+  parallel: 4                        # Default concurrent downloads
+  retry_attempts: 5                  # Max retries per file
+  retry_delay_seconds: 1.0           # Initial delay (doubles each retry)
+  retry_max_delay_seconds: 60.0      # Maximum delay cap
+  retry_jitter: true                 # Add randomness to delays
+  verify_checksum: false             # SHA256 verification
+  checksum_algorithm: sha256         # md5, sha256, sha512
+  chunk_size_mb: 10                  # Download chunk size
+  resume: true                       # Auto-resume interrupted downloads
+  bandwidth_limit_mbps: null         # Throttle (null = unlimited)
+  overwrite_existing: false
+  notify_on_completion: null         # webhook URL or email
+  notify_on_failure: null
+  on_failure: skip                   # skip, abort, retry
+
+cache:
+  enabled: true
+  ttl_seconds: 3600                  # 1 hour default
+  max_size_gb: 10                    # Auto-prune when exceeded
+  location: ~/.PyGeoFetch/cache
+
+search:
+  default_providers: []
+  max_results: 100
+  timeout_seconds: 60
+  on_provider_failure: skip          # skip, abort, retry
+  sort_by: datetime
+  sort_order: desc
+
+auth:
+  storage_backend: keyring           # keyring or file
+  keyring_service: PyGeoFetch
+  file_path: ~/.PyGeoFetch/credentials.enc
+
+proxy:
+  http_proxy: null
+  https_proxy: null
+  no_proxy: []
+
+logging:
+  level: INFO
+  format: console                    # console, json
+  file: null
+  max_file_size_mb: 10
+  backup_count: 3
+
+providers:
+  usgs:
+    endpoint: https://m2m.cr.usgs.gov/api/api/json/stable/
+    timeout: 60
+  copernicus:
+    endpoint: https://catalogue.dataspace.copernicus.eu/resto/api/
+    timeout: 45
+  planet:
+    endpoint: https://api.planet.com/data/v1/
+    rate_limit: 100
+  planetary_computer:
+    endpoint: https://planetarycomputer.microsoft.com/api/stac/v1
+    timeout: 60
+  element84:
+    endpoint: https://earth-search.aws.element84.com/v1
+    timeout: 60
+```
+
+### Environment Variables
+
+```bash
+export SATELLITE_BRIDGE_LOG_LEVEL=DEBUG
+export SATELLITE_BRIDGE_DOWNLOAD__PARALLEL=8
+export SATELLITE_BRIDGE_CACHE__TTL_SECONDS=7200
+export SATELLITE_BRIDGE_USGS_USERNAME=myuser
+export SATELLITE_BRIDGE_USGS_PASSWORD=mypass
+export SATELLITE_BRIDGE_PLANET_API_KEY=PL_KEY
+```
+
+---
+
+## Error Handling & Resilience
+
+PyGeoFetch handles failures at every layer:
+
+### Provider Failures
+- **Circuit breaker**: Failing providers disabled after 5 consecutive failures
+- **Automatic recovery**: Providers retried after 60-second cooldown
+- **Partial results**: If one provider fails, results from others still returned
+- **On-failure policy**: `skip`, `abort`, or `retry` per search and download
+
+```bash
+# Skip failing providers, return what's available
+PyGeoFetch search run --providers copernicus,usgs,planet --on-provider-failure skip
+
+# Abort entirely if any provider fails
+PyGeoFetch search run --providers copernicus,usgs --on-provider-failure abort
+```
+
+### Download Resilience
+- **Exponential backoff**: Retries with 1s, 2s, 4s, 8s, 16s + jitter
+- **Resume support**: Interrupted downloads resume from last byte received
+- **Checksum verification**: SHA256 verified post-download, auto-retry on mismatch
+- **Atomic writes**: Files written to `.tmp` then renamed — no partial files
+
+### Search Caching
+- Results cached per query (configurable TTL, default 1 hour)
+- Cache hits return instantly without API calls
+- Cache auto-invalidates; `PyGeoFetch cache clear` for manual purge
+
+### Logging
+
+```bash
+PyGeoFetch --log-level DEBUG search run ...
+PyGeoFetch --log-file PyGeoFetch.log search run ...
+PyGeoFetch --log-format json search run ...
+```
+
+---
+
+## Security
+
+### Credential Handling
+- Credentials are **never logged** — log filters redact passwords, tokens, API keys
+- Authentication tokens stored in **system keyring** (macOS Keychain, Windows Credential Manager, Linux Secret Service)
+- Encrypted file fallback at `~/.PyGeoFetch/credentials.enc` using Fernet symmetric encryption
+- Environment variables supported: `SATELLITE_BRIDGE_USGS_USERNAME`, `SATELLITE_BRIDGE_PLANET_API_KEY`, etc.
+- Credentials cleared from memory immediately after authentication
+
+### Network Security
+- **TLS 1.2+** enforced on all connections
+- **SSL certificate verification** — no `verify=False` anywhere in the codebase
+- Certificate pinning available for enterprise deployments
+- Proxy support respecting `HTTP_PROXY`/`HTTPS_PROXY` environment variables
+
+### Data Integrity
+- **SHA256 checksum verification** on all downloads (configurable: MD5, SHA256, SHA512)
+- Atomic file writes — partial downloads never corrupt existing data
+- Download resume tokens prevent data duplication
+
+### Privacy
+- **No telemetry** — PyGeoFetch does not phone home
+- **No analytics** — zero data collection
+- **No third-party requests** beyond configured providers
+- Usage data stays local unless you configure webhook notifications
+
+### Reporting Vulnerabilities
+
+Do **not** open public issues for security vulnerabilities.
+
+- Email: security@PyGeoFetch.dev
+- Response time: Within 48 hours
+- Responsible disclosure policy: 90-day disclosure window
+
+---
+
+## Docker
+
+### Quick Start
+
+```bash
+docker pull PyGeoFetch/PyGeoFetch:latest
+
+docker run -v ~/.PyGeoFetch:/root/.PyGeoFetch \
+    -v $(pwd)/data:/data \
+    PyGeoFetch/PyGeoFetch search run \
+    --bbox "-74.1,40.6,-73.7,40.9" \
+    --providers aws_earth \
+    --output /data/results.geojson
+```
+
+### Docker Compose for Scheduled Pipelines
+
+```yaml
+version: '3.8'
+services:
+  PyGeoFetch-scheduler:
+    image: PyGeoFetch/PyGeoFetch:latest
+    volumes:
+      - ~/.PyGeoFetch:/root/.PyGeoFetch
+      - ./pipelines:/pipelines
+      - ./data:/data
+    command: PyGeoFetch pipeline run /pipelines/weekly-ndvi.yaml
+    restart: unless-stopped
+```
+
+### Build Locally
+
+```bash
+docker build -t PyGeoFetch:local .
+docker run PyGeoFetch:local status
+```
+
+Available on Docker Hub and GitHub Container Registry.
+
+---
+
+## Testing
+
+```bash
+# Run all tests
+pytest tests/ -v
+
+# With coverage
+pytest tests/ -v --cov=PyGeoFetch --cov-report=html
+
+# Unit tests only (fast)
+pytest tests/unit/ -v
+
+# Integration tests (requires credentials)
+pytest tests/integration/ -v --run-integration
+```
+
+### Testing Strategy
+- **Unit tests**: Every provider, utility, and model has dedicated unit tests
+- **VCR recordings**: HTTP interactions recorded with `pytest-vcr` for deterministic replay
+- **Mock servers**: Provider APIs simulated with `responses` and `httpx` mocks
+- **Integration tests**: Optional real-API tests flagged with `--run-integration`
+- **Property-based testing**: Edge cases generated with `hypothesis`
+- **CLI tests**: Full workflow tests with Click's `CliRunner`
+
+Coverage minimum: **80% line coverage** — CI fails if below threshold.
+
+---
+
+## Roadmap
+
+### v0.2.0 (Q4 2024)
+- [ ] BlackSky provider
+- [ ] SI Imaging Services (KOMPSAT) provider
+- [ ] Interactive search mode (`--interactive`)
+- [ ] Webhook integrations: Slack, Discord, Teams built-in templates
+- [ ] Streaming COG partial reads (no full download needed)
+
+### v0.3.0 (Q1 2025)
+- [ ] Web dashboard for pipeline monitoring (`PyGeoFetch dashboard`)
+- [ ] REST API server mode (`PyGeoFetch serve`)
+- [ ] Automatic provider health monitoring
+- [ ] Download bandwidth scheduling (limit during business hours)
+
+### v1.0.0 (Q2 2025)
+- [ ] PyGeoFetch Cloud (hosted API, zero setup)
+- [ ] Enterprise SSO (Okta, Azure AD)
+- [ ] Team workspaces for credential sharing
+- [ ] SLA-backed production support tier
+
+Vote on features at [github.com/PyGeoFetch/PyGeoFetch/discussions](https://github.com/PyGeoFetch/PyGeoFetch/discussions)
+
+---
+
+## Contributing
+
+We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for full guidelines.
+
+**Good first issues:** implementing stub providers to full API integrations,
+improving test coverage, adding new post-processing actions.
+
+```bash
+git clone https://github.com/appiahkubis14/PyGeoFetch
+cd PyGeoFetch
+pip install -e ".[dev,all]"
+make test
+```
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE).

pygeofetch-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+pygeofetch-0.1.0.dist-info/licenses/LICENSE,sha256=Si1hKnjIgjlw8L3abiwbOsWTti0FJVYkNoUT-dc4Xdw,1080
+pygeofetch-0.1.0.dist-info/METADATA,sha256=6xVj4-Vb4fq_DXphUcPSLr-5TyYqhRhcaEdKf-XBFM8,23716
+pygeofetch-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+pygeofetch-0.1.0.dist-info/entry_points.txt,sha256=Oq5JRi8xVM1cQ_S5BQsSXnYKoPpBgERKNtZ8hIM9BaY,55
+pygeofetch-0.1.0.dist-info/top_level.txt,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+pygeofetch-0.1.0.dist-info/RECORD,,

pygeofetch-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

pygeofetch-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+PyGeoFetch = PyGeoFetch.cli.main:cli

pygeofetch-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 PyGeoFetch Contributors
+
+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.

pygeofetch-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+