💻 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  [35mfetchez[0m 0.5.4
    [48;2;43;76;126m  [0m[48;2;244;247;250m  [0m[48;2;212;190;157m  [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.
--list-hooks - List all available hooks.
--list-presets - List all available hook presets.
--list-recipes - List all curated recipes available in the registry.
--search-modules TERM - Search modules by tag, agency, or description.
--module-info MODULE - Show detailed metadata for a specific module.
--hook-info HOOK_NAME - Print detailed documentation and arguments for a specific hook.
-h, --help - Show this help message and exit.
--version - show program’s version number and exit

fetchez Execution Control#

-r RECIPE, --recipe RECIPE - The YAML Recipe file to process or Keyword.
--hook HOOK - Add a custom global hook (e.g. 'audit:file=log.txt').
-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).
--init-presets - Generate a default ~/.fetchez/presets.yaml file.
--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.
--audit-full - Generate SHA256 hashes, enrichment, and a full JSON audit logs.

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-modules bathymetry

CUDEM home page: <http://cudem.colorado.edu>
        