💻 Command Line Interface#

The fetchez command line tool allows you to chain modules and hooks together.

fetchez - CLI interface#

[48;2;133;181;141m [0m[48;2;84;130;180m [0m[48;2;181;193;142m [0m[48;2;212;190;157m [0m[48;2;84;130;180m [0m [48;2;43;76;126m [0m[48;2;133;181;141m [0m[48;2;212;190;157m [0m[48;2;84;130;180m [0m[48;2;181;193;142m [0m [35mfetchez[0m 0.5.0 [48;2;84;130;180m [0m[48;2;43;76;126m [0m[48;2;84;130;180m [0m[48;2;244;247;250m [0m[48;2;244;247;250m [0m [3mFetch geospatial data with ease.[0m

fetchez [-R REGION] [OPTIONS] MODULE [MODULE-OPTS]...

fetchez Geospatial Selection#

-R REGION, --region REGION, --aoi REGION -
Region Formats:
xmin/xmax/ymin/ymax : Bounding box loc:City,State : Geocode place name file.geojson : Bounding box of vector file
-B PCT, --buffer PCT - Buffer the input region by PCT percent. (default: 0)

fetchez Discovery & Metadata#

--list-modules - List all available data modules.
--search-modules TERM - Search modules by tag, agency, or description.
--module-info MODULE - Show detailed metadata for a specific module.
-h, --help - Show this help message and exit.
--version - show program’s version number and exit

fetchez Execution Control#

-O DIR, --outdir DIR - Base output directory (default: current working directory).
-H N, --threads N - Number of parallel download threads (default: 1). (default: 1)
-A N, --attempts N - Number of retry attempts per file (default: 5). (default: 5)
-q, --quiet - Suppress progress bars and status messages.
-v, --verbose - Enable verbose (DEBUG) logging.

fetchez Pipeline Shortcuts (Hook Presets)#

-l, --list - List discovered URLs to stdout (Pre-Hook).
--inventory FMT - Print manifest of files to be fetched (default: json). Prevents download.
--pipe-path - Print absolute paths of downloaded files for piping (Post-Hook).
--audit-log FILE - Generate a full audit log with Checksums and Metadata.

fetchez Advanced Configuration#

--hook HOOK - Add a custom global hook (e.g. 'audit:file=log.txt').
--list-hooks - List all available hooks.
--hook-info HOOK_NAME - Print detailed documentation and arguments for a specific hook.
--init-presets - Generate a default ~/.fetchez/presets.yaml file.

Examples: fetchez -R -105/-104/39/40 srtm_plus fetchez -R loc:”Boulder, CO” copernicus –datatype=1 fetchez -R loc:seattle -H4 charts –hook unzip –hook filename_filter:match=.000 –pipe-path fetchez –search bathymetry CUDEM home page: <http://cudem.colorado.edu>