id       = "ant"
name     = "Apache Ant"
homepage = "https://ant.apache.org"
description = "Apache Ant is a Java library and command-line tool whose mission is to drive processes described in build files."
icon     = "SimpleIcons:apacheant"
executables   = ["ant"]

[dotfiles]

# https://ant.apache.org/manual/running.html — "The Ant wrapper script for Unix
# will source (read and evaluate) the file ~/.antrc before it does anything",
# alongside /etc/ant.conf and $HOME/.ant/ant.conf. On Windows the wrapper
# instead runs %HOME%\antrc_pre.bat and %HOME%\antrc_post.bat; %HOME% is not a
# path form this catalog can express, so those are left out.
paths = [
  "~/.antrc",
  "~/.ant/ant.conf",
]

# The same page: "${user.home}/.ant/lib" is scanned for extra jars. Those are
# binaries, not configuration.
exclude = ["~/.ant/lib/"]

secret = []

# Sourced afresh by every ant invocation.
side_effect = false

# No machine_lines: both files are free-form shell fragments. The lines that
# are machine-local in practice (JAVA_HOME, ANT_HOME) may be written with or
# without `export`, and a prefix rule cannot tell the two apart, so nothing is
# claimed here rather than claiming it wrongly.

[commands]
format = 1
label = "Run Ant build"
description = "Run one or more targets of an Ant build file. Listener, logger, input-handler and classpath options are left out."
quality = "ai-draft"
base = "fig:ant"
parser = { end_of_options = "--", interleave = "permute", long_equals = false, short_attached = false, short_bundles = false }

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

[[commands.field]]
id = "buildfile"
label = "Build file"
description = "Defaults to build.xml in the current directory."
type = "path"
option = ["-buildfile", "-file", "-f"]
path = { kind = "file", role = "input", must_exist = true }
sources = ["fig"]

[[commands.field]]
id = "logfile"
label = "Log file"
type = "path"
option = ["-logfile", "-l"]
path = { kind = "file", role = "output", must_exist = false }
effect = "overwrite"
sources = ["fig"]

[[commands.field]]
id = "propertyfile"
label = "Property file"
type = "path"
option = ["-propertyfile"]
path = { kind = "file", role = "input", must_exist = true }
sources = ["fig"]

[[commands.field]]
id = "keep_going"
label = "Keep going after failures"
type = "boolean"
option = ["-keep-going", "-k"]
sources = ["fig"]

[[commands.field]]
id = "projecthelp"
label = "Print project help (targets)"
type = "boolean"
option = ["-projecthelp", "-p"]
sources = ["fig"]

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

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

[[commands.field]]
id = "debug"
label = "Debug output"
type = "boolean"
option = ["-debug", "-d"]
sources = ["fig"]

[[commands.field]]
id = "noinput"
label = "No interactive input"
type = "boolean"
option = ["-noinput"]
sources = ["fig"]

[[commands.field]]
id = "targets"
label = "Targets"
description = "Targets to run in order. Defaults to the build file's default target."
type = "string"
position = 0
multiple = true
sources = ["fig"]

[[commands.task]]
id = "build"
label = "Run targets"
fields = ["targets", "buildfile", "propertyfile", "keep_going", "verbose"]
required = []

[[commands.task]]
id = "list-targets"
label = "List targets"
set = { projecthelp = [true] }
lock = ["projecthelp"]
fields = ["projecthelp", "buildfile"]
required = []

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["targets", "buildfile", "propertyfile", "keep_going", "projecthelp"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["logfile", "verbose", "quiet", "debug", "noinput"]