Programs

Complete reference for all GeoETL command-line programs and their options.

geoetl-cli

The main GeoETL command-line interface provides commands for converting geospatial data between formats, inspecting datasets, and managing drivers.

Available Commands

Command	Description
convert	Convert data between formats
info	Display dataset information
drivers	List available format drivers
completions	Generate shell completions

Global Options

Option	Short	Description
--help	-h	Print help information
--version	-V	Print version information
--verbose	-v	Enable verbose logging

Basic Usage

# Get help
geoetl-cli --help

# Get version
geoetl-cli --version

# List available drivers
geoetl-cli drivers

# Convert a file
geoetl-cli convert -i input.geojson -o output.csv \
  --input-driver GeoJSON --output-driver CSV

# Get dataset information
geoetl-cli info data.geojson --driver GeoJSON

Verbose Logging

Enable verbose output with -v flag:

geoetl-cli -v convert -i input.geojson -o output.csv \
  --input-driver GeoJSON --output-driver CSV

For detailed debug logging, use RUST_LOG:

RUST_LOG=debug geoetl-cli convert ...
RUST_LOG=info geoetl-cli convert ...

Command Reference

Browse the detailed reference for each command:

• convert - Convert data between formats
• info - Display dataset information
• drivers - List available format drivers
• completions - Generate shell completions

Common Options

Input/Output Specification

Most commands accept input and output files:

--input <PATH>      # or -i <PATH>
--output <PATH>     # or -o <PATH>

Driver Specification

Specify format drivers for input and output:

--input-driver <DRIVER>
--output-driver <DRIVER>

Available drivers: GeoJSON, CSV, GeoParquet

See Supported Drivers for details.

CSV-Specific Options

When working with CSV files:

--geometry-column <COLUMN>  # Required for CSV input
--geometry-type <TYPE>      # Optional geometry type hint

Exit Codes

GeoETL uses standard Unix exit codes:

Code	Meaning
0	Success
1	General error
2	Invalid arguments

Environment Variables

RUST_LOG

Control logging level:

export RUST_LOG=info     # Informational messages
export RUST_LOG=debug    # Debug messages
export RUST_LOG=trace    # Trace messages

Examples:

RUST_LOG=info geoetl-cli convert ...
RUST_LOG=debug geoetl-cli info ...

Examples

Basic Conversion

geoetl-cli convert \
  -i cities.geojson \
  -o cities.csv \
  --input-driver GeoJSON \
  --output-driver CSV

Verbose Conversion

geoetl-cli -v convert \
  -i large_dataset.geojson \
  -o large_dataset.parquet \
  --input-driver GeoJSON \
  --output-driver GeoParquet

CSV with Custom Geometry Column

geoetl-cli convert \
  -i data.csv \
  -o data.geojson \
  --input-driver CSV \
  --output-driver GeoJSON \
  --geometry-column wkt

Dataset Inspection

geoetl-cli info cities.geojson --driver GeoJSON
geoetl-cli info data.csv --driver CSV --geometry-column geometry
geoetl-cli info data.parquet --driver GeoParquet

See Also

• Getting Started - Installation guide
• Your First Conversion - Quick start tutorial
• Supported Drivers - Format driver reference
• FAQ - Frequently asked questions

---

Need help? Run geoetl-cli --help or geoetl-cli <command> --help