id          = "w3m"
name        = "w3m"
homepage    = "https://w3m.sourceforge.net/"
description = "w3m is a pager/text-based WWW browser."
executables      = ["w3m"]

[dotfiles]

# The w3m project documents ~/.w3m/config for options and ~/.w3m/keymap for
# user key bindings:
# https://w3m.sourceforge.net/eng/FAQ.html
# https://www.chiark.greenend.org.uk/doc/w3m/MANUAL.html
paths = ["~/.w3m/config", "~/.w3m/keymap"]
secret = []
side_effect = false

[commands]
format = 1
label = "Browse or dump a page"
description = "Open URLs or files in w3m, or render them to standard output. Proxy, cookie, config-file and -o option overrides are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = false, short_attached = false, short_bundles = false }

[[commands.source]]
id = "man"
kind = "manual"
url = "https://manpages.debian.org/bookworm/w3m/w3m.1.en.html"
revision = "Debian bookworm"
evidence = """-B  with no other target defined, use the bookmark page for startup
-M  monochrome display
-no-mouse  deactivate mouse support
-num  display each line's number
-N  distribute multiple command line arguments to tabs
-cols num  with stdout as destination; HTML is rendered to lines of num characters
-s  squeeze multiple blank lines into one
-I charset  user defined character encoding of input data
-O charset  user defined character encoding of output data
-T type  explicit characterization of input data by MIME type
-dump  dump rendered page into stdout
-dump_source  dump the page's source code into stdout
-dump_head  dump response of a HEAD request for a URL into stdout
-4  IPv4 only
-6  IPv6 only"""

[[commands.field]]
id = "dump"
label = "Dump rendered page to stdout"
type = "boolean"
option = ["-dump"]
sources = ["man"]

[[commands.field]]
id = "dump_source"
label = "Dump page source to stdout"
type = "boolean"
option = ["-dump_source"]
sources = ["man"]

[[commands.field]]
id = "dump_head"
label = "Dump HEAD response to stdout"
type = "boolean"
option = ["-dump_head"]
sources = ["man"]

[[commands.field]]
id = "cols"
label = "Output width (columns)"
description = "Only with stdout as destination (dump)."
type = "integer"
option = ["-cols"]
sources = ["man"]

[[commands.field]]
id = "squeeze"
label = "Squeeze blank lines"
type = "boolean"
option = ["-s"]
sources = ["man"]

[[commands.field]]
id = "line_numbers"
label = "Show line numbers"
type = "boolean"
option = ["-num"]
sources = ["man"]

[[commands.field]]
id = "no_mouse"
label = "Disable mouse"
type = "boolean"
option = ["-no-mouse"]
sources = ["man"]

[[commands.field]]
id = "mono"
label = "Monochrome"
type = "boolean"
option = ["-M"]
sources = ["man"]

[[commands.field]]
id = "tabs"
label = "Open multiple targets in tabs"
type = "boolean"
option = ["-N"]
sources = ["man"]

[[commands.field]]
id = "input_charset"
label = "Input charset"
type = "string"
option = ["-I"]
suggestions = [{ value = "UTF-8", label = "UTF-8" }, { value = "EUC-JP", label = "EUC-JP" }]
sources = ["man"]

[[commands.field]]
id = "output_charset"
label = "Output charset"
type = "string"
option = ["-O"]
suggestions = [{ value = "UTF-8", label = "UTF-8" }, { value = "EUC-JP", label = "EUC-JP" }]
sources = ["man"]

[[commands.field]]
id = "mime_type"
label = "Input MIME type"
type = "string"
option = ["-T"]
suggestions = [{ value = "text/html", label = "HTML" }, { value = "text/plain", label = "Plain text" }]
sources = ["man"]

[[commands.field]]
id = "target"
label = "URL or file"
type = "string"
position = 0
multiple = true
sources = ["man"]

[[commands.task]]
id = "dump_page"
label = "Dump a page as text"
fields = ["target", "dump", "cols"]
required = ["target", "dump"]
set = { dump = [true] }

[[commands.task]]
id = "browse"
label = "Browse"
fields = ["target"]
required = ["target"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["target", "dump", "dump_source", "dump_head", "cols"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["squeeze", "line_numbers", "no_mouse", "mono", "tabs", "input_charset", "output_charset", "mime_type"]