id          = "jython"
name        = "Jython"
homepage    = "https://www.jython.org"
description = "Python implementation written in Java."
executables      = ["jython"]

[dotfiles]

# Jython's official registry documentation explicitly names the user's
# personal registry as user.home/.jython and describes its prop=value format.
# https://www.jython.org/registry.html
paths  = ["~/.jython"]
secret = []

[commands]
format = 1
label = "Run Python with Jython"
description = "Run a script, a one-line program or a library module. -D properties, -jar, -Q, -W and -3 are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "posix", long_equals = false, short_attached = false, short_bundles = false }

[[commands.source]]
id = "help"
kind = "help"
url = "https://github.com/jython/jython/blob/master/src/org/python/util/jython.java"
revision = "master 2026-10-27"
evidence = """
usage: jython [option] ... [-c cmd | -m mod | file | -] [arg] ...
-B       : don't write bytecode files on import;
-c cmd   : program passed in as string (terminates option list)
-E       : ignore environment variables (such as JYTHONPATH)
-i       : inspect interactively after running script; forces a prompt even
-m mod   : run library module as a script (terminates option list)
-s       : don't add user site directory to sys.path;
-S       : don't imply 'import site' on initialization
-u       : unbuffered binary stdout and stderr
-v       : verbose (emit more "org.python" log messages)
file     : program read from script file
arg ...  : arguments passed to program in sys.argv[1:]
"""

[[commands.field]]
id = "command"
label = "Program string"
description = "Runs this code instead of a file."
type = "string"
option = ["-c"]
sources = ["help"]

[[commands.field]]
id = "module"
label = "Library module"
type = "string"
option = ["-m"]
sources = ["help"]

[[commands.field]]
id = "interactive"
label = "Inspect interactively afterwards"
type = "boolean"
option = ["-i"]
sources = ["help"]

[[commands.field]]
id = "unbuffered"
label = "Unbuffered stdout and stderr"
type = "boolean"
option = ["-u"]
sources = ["help"]

[[commands.field]]
id = "no_bytecode"
label = "Do not write bytecode files"
type = "boolean"
option = ["-B"]
sources = ["help"]

[[commands.field]]
id = "ignore_env"
label = "Ignore environment variables"
type = "boolean"
option = ["-E"]
sources = ["help"]

[[commands.field]]
id = "no_site"
label = "Skip import site"
type = "boolean"
option = ["-S"]
sources = ["help"]

[[commands.field]]
id = "no_user_site"
label = "No user site directory"
type = "boolean"
option = ["-s"]
sources = ["help"]

[[commands.field]]
id = "verbose"
label = "Verbosity"
type = "count"
option = ["-v"]
sources = ["help"]

[[commands.field]]
id = "script"
label = "Script file"
type = "path"
position = 0
path = { kind = "file", role = "input", must_exist = true }
sources = ["help"]

[[commands.field]]
id = "args"
label = "Script arguments"
type = "string"
position = 1
multiple = true
sources = ["help"]

[[commands.task]]
id = "run-script"
label = "Run a script"
fields = ["script", "args", "interactive", "unbuffered", "verbose"]
required = ["script"]

[[commands.task]]
id = "run-module"
label = "Run a module"
fields = ["module", "args", "unbuffered"]
required = ["module"]

[[commands.task]]
id = "run-string"
label = "Run a one-liner"
fields = ["command", "interactive"]
required = ["command"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["script", "args", "module", "command", "interactive"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["unbuffered", "no_bytecode", "ignore_env", "no_site", "no_user_site", "verbose"]