Fetchez Documentation#
Fetch geospatial data with ease.
Fetchez Les Données
Fetchez is a lightweight, modular and highly extendable Python library and command-line tool designed to discover, retrieve and process geospatial data from a wide variety of public repositories.
Quickstart#
Installation:
pip install fetchez
Command Line Interface:#
Fetch Copernicus topography and NOAA multibeam bathymetry for a specific bounding box in one command:
fetchez -R loc:"Miami, FL" copernicus multibeam
Python API:#
import fetchez
# Search
fetchez.search("bathymetry")
# Get Data (Returns list of local file paths)
files = fetchez.get("nos_hydro", region=[-120, -118, 33, 34], year=2020)
# Advanced (With Hooks)
files = fetchez.get("blue_topo", hooks=['unzip', 'filter:match=.tif'])
Key Features#
Unified Interface: Access 50+ different modules using the exact same syntax.
Streaming First: Fetchez prefers streaming data through standard pipes over downloading massive archives to disk.
Parallel Fetching: High-performance, multi-threaded downloading with automatic retry, timeout handling, and partial-download resumption.
Infrastructure as Code: Define complex data pipelines, cropping, and gridding workflows using CLI switches or simple YAML “Recipes”.
Pipeline Hooks: Transparently stream, filter, and process data (via globato and transformez) as it is being downloaded.