id = "ping"
name = "ping"
description = "Send ICMP ECHO_REQUEST packets to network hosts."
executables = ["ping"]

[commands]
format = 1
label = "Ping a host"
description = "Send echo requests to a host. Only options shared by BSD and Linux ping are offered; flags that differ between platforms are left out."
quality = "ai-draft"
base = "fig:ping"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = true }

[[commands.source]]
id = "fig"
kind = "completion"
url = "https://github.com/withfig/autocomplete/blob/master/src/ping.ts"
license = "MIT"

[[commands.field]]
id = "host"
label = "Hostname or IP"
type = "string"
position = 0
sources = ["fig"]

[[commands.field]]
id = "count"
label = "Packet count"
description = "Stop after this many packets; unset pings until interrupted."
type = "integer"
option = ["-c"]
sources = ["fig"]

[[commands.field]]
id = "interval"
label = "Seconds between packets"
type = "number"
option = ["-i"]
sources = ["fig"]

[[commands.field]]
id = "numeric"
label = "Numeric output only"
type = "boolean"
option = ["-n"]
sources = ["fig"]

[[commands.field]]
id = "quiet"
label = "Quiet output"
type = "boolean"
option = ["-q"]
sources = ["fig"]

[[commands.field]]
id = "size"
label = "Data bytes"
type = "integer"
option = ["-s"]
sources = ["fig"]

[[commands.field]]
id = "verbose"
label = "Verbose output"
type = "boolean"
option = ["-v"]
sources = ["fig"]

[[commands.task]]
id = "check"
label = "Ping four times"
fields = ["host", "count"]
required = ["host", "count"]
set = { count = [4] }

[[commands.task]]
id = "cont"
label = "Ping until interrupted"
fields = ["host"]
required = ["host"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["host", "count", "interval", "numeric", "quiet"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["size", "verbose"]