PyGeoFetch 0.1.0__tar.gz → 0.1.1__tar.gz

{pygeofetch-0.1.0 → pygeofetch-0.1.1}/LICENSE

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

{pygeofetch-0.1.0 → pygeofetch-0.1.1}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
-Name: PyGeoFetch
-Version: 0.1.0
+Name: pygeofetch
+Version: 0.1.1
 Summary: Universal satellite data download pipeline with unified access to 20+ repositories
-Author: PyGeoFetch Contributors
+Author: pygeofetch Contributors
 License: MIT License
         
-        Copyright (c) 2024 PyGeoFetch Contributors
+        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
@@ -25,10 +25,10 @@ License: MIT License
         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
+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
@@ -78,24 +78,24 @@ 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"
+Requires-Dist: pygeofetch[dev,geo]; extra == "all"
 Dynamic: license-file
 
-# PyGeoFetch 🛰️
+# 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/)
+[![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)
+[![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?
+## Why pygeofetch?
 
-| Feature | PyGeoFetch | EODAG | pystac-client | satpy | sentinelsat |
+| Feature | pygeofetch | EODAG | pystac-client | satpy | sentinelsat |
 |---|---|---|---|---|---|
 | **Providers** | **22+** | 10+ | STAC only | Limited | Sentinel only |
 | **CLI** | ✅ Full | ❌ | ❌ | ❌ | ✅ Basic |
@@ -114,13 +114,13 @@ Dynamic: license-file
 ## Installation
 
 ```bash
-pip install PyGeoFetch
+pip install pygeofetch
 
 # With raster processing support
-pip install "PyGeoFetch[geo]"
+pip install "pygeofetch[geo]"
 
 # Full installation (all optional deps)
-pip install "PyGeoFetch[all]"
+pip install "pygeofetch[all]"
 ```
 
 **Requirements:** Python 3.9+
@@ -163,15 +163,15 @@ pip install "PyGeoFetch[all]"
 ### 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
+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 \
+pygeofetch search run \
     --bbox "-74.1,40.6,-73.7,40.9" \
     --start-date 2024-01-01 \
     --cloud-cover 0-15 \
@@ -179,12 +179,12 @@ PyGeoFetch search run \
     --output results.geojson
 ```
 
-![PyGeoFetch search demo](data/test/search.png)
+![pygeofetch search demo](data/test/search.png)
 
 ### 3. Download
 
 ```bash
-PyGeoFetch download run \
+pygeofetch download run \
     --from-search results.geojson \
     --output ./my_data/ \
     --parallel 4 \
@@ -192,7 +192,7 @@ PyGeoFetch download run \
     --post-process "unzip,reproject:EPSG:4326,compress:lzw"
 ```
 
-![PyGeoFetch download demo](data/test/download.png)
+![pygeofetch download demo](data/test/download.png)
 
 ---
 
@@ -200,10 +200,10 @@ PyGeoFetch download run \
 
 ```python
 from pathlib import Path
-from PyGeoFetch import PyGeoFetch
-from PyGeoFetch.models import SearchQuery, DownloadOptions
+from pygeofetch import pygeofetch
+from pygeofetch.models import SearchQuery, DownloadOptions
 
-sb = PyGeoFetch()
+sb = pygeofetch()
 sb.add_credentials("usgs", username="user", password="pass")
 sb.add_credentials("planet", api_key="PL_KEY")
 
@@ -243,32 +243,32 @@ for dr in download_results:
 
 ### Global Options
 ```
-PyGeoFetch [--log-level LEVEL] [--log-file FILE] [--log-format console|json]
+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]
+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]
+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
+pygeofetch search run
     --bbox "minx,miny,maxx,maxy"       # Bounding box
     --geometry-file area.geojson        # AOI from GeoJSON file
     --start-date YYYY-MM-DD
@@ -291,7 +291,7 @@ PyGeoFetch search run
 
 ### Download
 ```bash
-PyGeoFetch download run
+pygeofetch download run
     --from-search FILE                  # GeoJSON from search run
     --scene-ids ID1,ID2,...             # Direct scene IDs
     --output DIRECTORY
@@ -311,41 +311,41 @@ PyGeoFetch download run
 
 ### 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
+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
+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
+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
+pygeofetch status [--json]
+pygeofetch version [--json]
+pygeofetch doctor                  # Diagnose installation and connectivity
+pygeofetch --install-completion bash|zsh|fish
 ```
 
 ---
@@ -369,7 +369,7 @@ PyGeoFetch --install-completion bash|zsh|fish
 Chain post-processing actions on downloaded data:
 
 ```bash
-PyGeoFetch download run \
+pygeofetch download run \
     --from-search results.geojson --output ./data/ \
     --post-process "unzip,reproject:EPSG:4326,compress:lzw,ndvi,cog"
 ```
@@ -426,31 +426,31 @@ steps:
 
 ```bash
 # One-shot execution
-PyGeoFetch pipeline run weekly-sentinel2.yaml
+pygeofetch pipeline run weekly-sentinel2.yaml
 
 # Schedule for recurring execution
-PyGeoFetch pipeline schedule weekly-sentinel2.yaml
+pygeofetch pipeline schedule weekly-sentinel2.yaml
 
 # Validate without running
-PyGeoFetch pipeline validate weekly-sentinel2.yaml
+pygeofetch pipeline validate weekly-sentinel2.yaml
 ```
 
 ---
 
 ## Configuration
 
-PyGeoFetch uses a hierarchical config system:
+pygeofetch uses a hierarchical config system:
 
 1. Built-in defaults
-2. User config (`~/.PyGeoFetch/config.yaml`)
-3. Project config (`.PyGeoFetch.yaml`)
+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
+# ~/.pygeofetch/config.yaml
 
 download:
   parallel: 4                        # Default concurrent downloads
@@ -472,7 +472,7 @@ cache:
   enabled: true
   ttl_seconds: 3600                  # 1 hour default
   max_size_gb: 10                    # Auto-prune when exceeded
-  location: ~/.PyGeoFetch/cache
+  location: ~/.pygeofetch/cache
 
 search:
   default_providers: []
@@ -484,8 +484,8 @@ search:
 
 auth:
   storage_backend: keyring           # keyring or file
-  keyring_service: PyGeoFetch
-  file_path: ~/.PyGeoFetch/credentials.enc
+  keyring_service: pygeofetch
+  file_path: ~/.pygeofetch/credentials.enc
 
 proxy:
   http_proxy: null
@@ -532,7 +532,7 @@ export SATELLITE_BRIDGE_PLANET_API_KEY=PL_KEY
 
 ## Error Handling & Resilience
 
-PyGeoFetch handles failures at every layer:
+pygeofetch handles failures at every layer:
 
 ### Provider Failures
 - **Circuit breaker**: Failing providers disabled after 5 consecutive failures
@@ -542,10 +542,10 @@ PyGeoFetch handles failures at every layer:
 
 ```bash
 # Skip failing providers, return what's available
-PyGeoFetch search run --providers copernicus,usgs,planet --on-provider-failure skip
+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
+pygeofetch search run --providers copernicus,usgs --on-provider-failure abort
 ```
 
 ### Download Resilience
@@ -557,14 +557,14 @@ PyGeoFetch search run --providers copernicus,usgs --on-provider-failure abort
 ### 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
+- 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 ...
+pygeofetch --log-level DEBUG search run ...
+pygeofetch --log-file pygeofetch.log search run ...
+pygeofetch --log-format json search run ...
 ```
 
 ---
@@ -574,7 +574,7 @@ PyGeoFetch --log-format json search run ...
 ### 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
+- 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
 
@@ -590,7 +590,7 @@ PyGeoFetch --log-format json search run ...
 - Download resume tokens prevent data duplication
 
 ### Privacy
-- **No telemetry** — PyGeoFetch does not phone home
+- **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
@@ -599,7 +599,7 @@ PyGeoFetch --log-format json search run ...
 
 Do **not** open public issues for security vulnerabilities.
 
-- Email: security@PyGeoFetch.dev
+- Email: security@pygeofetch.dev
 - Response time: Within 48 hours
 - Responsible disclosure policy: 90-day disclosure window
 
@@ -610,11 +610,11 @@ Do **not** open public issues for security vulnerabilities.
 ### Quick Start
 
 ```bash
-docker pull PyGeoFetch/PyGeoFetch:latest
+docker pull pygeofetch/pygeofetch:latest
 
-docker run -v ~/.PyGeoFetch:/root/.PyGeoFetch \
+docker run -v ~/.pygeofetch:/root/.pygeofetch \
     -v $(pwd)/data:/data \
-    PyGeoFetch/PyGeoFetch search run \
+    pygeofetch/pygeofetch search run \
     --bbox "-74.1,40.6,-73.7,40.9" \
     --providers aws_earth \
     --output /data/results.geojson
@@ -625,21 +625,21 @@ docker run -v ~/.PyGeoFetch:/root/.PyGeoFetch \
 ```yaml
 version: '3.8'
 services:
-  PyGeoFetch-scheduler:
-    image: PyGeoFetch/PyGeoFetch:latest
+  pygeofetch-scheduler:
+    image: pygeofetch/pygeofetch:latest
     volumes:
-      - ~/.PyGeoFetch:/root/.PyGeoFetch
+      - ~/.pygeofetch:/root/.pygeofetch
       - ./pipelines:/pipelines
       - ./data:/data
-    command: PyGeoFetch pipeline run /pipelines/weekly-ndvi.yaml
+    command: pygeofetch pipeline run /pipelines/weekly-ndvi.yaml
     restart: unless-stopped
 ```
 
 ### Build Locally
 
 ```bash
-docker build -t PyGeoFetch:local .
-docker run PyGeoFetch:local status
+docker build -t pygeofetch:local .
+docker run pygeofetch:local status
 ```
 
 Available on Docker Hub and GitHub Container Registry.
@@ -653,7 +653,7 @@ Available on Docker Hub and GitHub Container Registry.
 pytest tests/ -v
 
 # With coverage
-pytest tests/ -v --cov=PyGeoFetch --cov-report=html
+pytest tests/ -v --cov=pygeofetch --cov-report=html
 
 # Unit tests only (fast)
 pytest tests/unit/ -v
@@ -684,18 +684,18 @@ Coverage minimum: **80% line coverage** — CI fails if below threshold.
 - [ ] 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`)
+- [ ] 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)
+- [ ] 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)
+Vote on features at [github.com/pygeofetch/pygeofetch/discussions](https://github.com/pygeofetch/pygeofetch/discussions)
 
 ---
 
@@ -707,8 +707,8 @@ We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for full guidel
 improving test coverage, 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]"
 make test
 ```