id = "ln"
name = "ln"
description = "Create hard or symbolic links to files."
executables = ["ln"]

[commands]
format = 1
label = "Create link"
description = "Create a hard or symbolic link. Options not present in the completion data are left out."
quality = "ai-draft"
base = "fig:ln"
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/ln.ts"
license = "MIT"

[[commands.field]]
id = "source"
label = "Target"
description = "Existing file or directory the link points to."
type = "path"
position = 0
path = { kind = "any", role = "input" }
sources = ["fig"]

[[commands.field]]
id = "link_name"
label = "Link name or directory"
type = "path"
position = 1
path = { kind = "any", role = "output", must_exist = false }
sources = ["fig"]

[[commands.field]]
id = "symbolic"
label = "Symbolic link"
type = "boolean"
option = ["-s"]
sources = ["fig"]

[[commands.field]]
id = "force"
label = "Replace existing link"
description = "Unlink an existing destination first."
type = "boolean"
option = ["-f"]
effect = "overwrite"
sources = ["fig"]

[[commands.field]]
id = "interactive"
label = "Prompt before replacing"
type = "boolean"
option = ["-i"]
sources = ["fig"]

[[commands.field]]
id = "no_deref"
label = "Do not follow symlinks"
type = "boolean"
option = ["-h"]
sources = ["fig"]

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

[[commands.task]]
id = "symlink"
label = "Symbolic link"
set = { symbolic = [true] }
fields = ["source", "link_name", "force", "verbose"]
required = ["source", "link_name"]

[[commands.task]]
id = "hardlink"
label = "Hard link"
fields = ["source", "link_name", "verbose"]
required = ["source", "link_name"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["source", "link_name", "symbolic", "force", "verbose"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["no_deref", "interactive"]