id       = "gdal"
name     = "GDAL"
homepage = "https://gdal.org"
description = "A translator library for raster and vector geospatial data formats."
icon     = "SimpleIcons:gdal"
executables   = ["gdalinfo", "gdal_translate", "gdalwarp", "ogr2ogr", "gdaldem"]

[dotfiles]

# https://gdal.org/en/stable/user/configoptions.html — GDAL 3.3+ attempts
# ${HOME}/.gdal/gdalrc on Unix after the system file, and
# ${USERPROFILE}/.gdal/gdalrc on Windows. GDAL_CONFIG_FILE can override this
# path, but an arbitrary environment-selected path cannot be represented here.
paths = ["~/.gdal/gdalrc"]
secret = []

# gdalrc is an INI-style configuration file, and since GDAL 3.5 it may carry
# arbitrary path-specific credentials under [credentials]. The credential key
# names and path-prefix sections are user-defined, so no safe fixed
# secret_paths pattern can be written; consumers should content-scan this
# file when handling it.
side_effect = false

[commands]
format = 1
label = "Inspect raster (gdalinfo)"
description = "Print information about a raster dataset: size, projection, bands, metadata and optional statistics. Conversion tools such as gdal_translate and gdalwarp, and multi-value options, are not covered."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = false, short_attached = false, short_bundles = false }

[[commands.source]]
id = "doc"
kind = "manual"
url = "https://gdal.org/en/stable/programs/gdalinfo.html"
revision = "2026-10-27"
evidence = """
.. option:: -json
.. option:: -mm
    Force computation of the actual min/max values for each band in the dataset.
.. option:: -stats
    Read and display image statistics. Force computation if no statistics are stored in an image.
.. option:: -hist
    Report histogram information for all bands.
.. option:: -nogcp
    Suppress ground control points list printing.
.. option:: -nomd
    Suppress metadata printing.
.. option:: -checksum
    Force computation of the checksum for each band in the dataset.
.. option:: -proj4
    Report a PROJ.4 string corresponding to the file's coordinate system.
.. option:: -sd <n>
    If the input dataset contains several subdatasets read and display a subdataset with specified n number (starting from 1).
"""

[[commands.field]]
id = "json"
label = "JSON output"
type = "boolean"
option = ["-json"]
sources = ["doc"]

[[commands.field]]
id = "stats"
label = "Image statistics"
type = "boolean"
option = ["-stats"]
sources = ["doc"]

[[commands.field]]
id = "minmax"
label = "Compute min/max"
type = "boolean"
option = ["-mm"]
sources = ["doc"]

[[commands.field]]
id = "hist"
label = "Histograms"
type = "boolean"
option = ["-hist"]
sources = ["doc"]

[[commands.field]]
id = "checksum"
label = "Band checksums"
type = "boolean"
option = ["-checksum"]
sources = ["doc"]

[[commands.field]]
id = "proj4"
label = "PROJ.4 string"
type = "boolean"
option = ["-proj4"]
sources = ["doc"]

[[commands.field]]
id = "nomd"
label = "Hide metadata"
type = "boolean"
option = ["-nomd"]
sources = ["doc"]

[[commands.field]]
id = "nogcp"
label = "Hide ground control points"
type = "boolean"
option = ["-nogcp"]
sources = ["doc"]

[[commands.field]]
id = "subdataset"
label = "Subdataset number"
description = "Starts from 1."
type = "integer"
option = ["-sd"]
sources = ["doc"]

[[commands.field]]
id = "dataset"
label = "Dataset"
type = "path"
position = 0
path = { kind = "file", role = "input" }
sources = ["doc"]

[[commands.task]]
id = "summary"
label = "Summary with statistics"
set = { stats = [true] }
fields = ["dataset", "stats", "nomd"]
required = ["dataset"]

[[commands.task]]
id = "json"
label = "Machine-readable JSON"
set = { json = [true] }
lock = ["json"]
fields = ["dataset", "json", "stats"]
required = ["dataset"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["dataset", "json", "stats", "minmax"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["hist", "checksum", "proj4", "nomd", "nogcp", "subdataset"]