💻 Command Line Interface#

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

fetchez - CLI interface#

%(prog)s (0.4.3) :: Discover and Fetch remote geospatial data

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#

  • -m, --modules - List all available data modules.

  • -s TERM, --search TERM - Search modules by tag, agency, or description.

  • -i MODULE, --info MODULE - Show detailed metadata for a specific module.

  • -h, --help - Show this help message and exit.

  • -v, --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.

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 charts –hook unzip –hook filename_filter:match=.000 –pipe-path fetchez –search bathymetry CUDEM home page: <http://cudem.colorado.edu>