id = "ncftp"
name = "NcFTP Client"
homepage = "https://www.ncftp.com/ncftp/"
description = "NcFTP is an improved FTP client program."
executables = ["ncftp"]

[dotfiles]

# The official ncftp(1) FILES section documents prefs and firewall under
# ~/.ncftp; bookmarks and firewall access data can contain login credentials.
# https://www.ncftp.com/ncftp/doc/ncftp.html
# https://www.ncftp.com/ncftp/doc/faq.html
paths = ["~/.ncftp/prefs"]
secret = ["~/.ncftp/bookmarks", "~/.ncftp/firewall"]

[commands]
format = 1
label = "Connect to an FTP host"
description = "Open an NcFTP session on a host. The password flag is left out so it is not typed into the command line."
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://www.ncftp.com/ncftp/doc/ncftp.html"
revision = "2026-10-27"
evidence = """-u XX
Use username XX instead of anonymous.
-P XX
Use port number XX instead of the default FTP service port (21)."""

[[commands.field]]
id = "host"
label = "Host"
type = "string"
position = 0
sources = ["doc"]

[[commands.field]]
id = "user"
label = "User"
type = "string"
option = ["-u"]
sources = ["doc"]

[[commands.field]]
id = "port"
label = "Port"
type = "integer"
option = ["-P"]
sources = ["doc"]

[[commands.task]]
id = "connect"
label = "Connect"
fields = ["host", "user", "port"]
required = ["host"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["host", "user", "port"]