id       = "julia"
name     = "Julia"
homepage = "https://julialang.org"
description = "Julia is a high-level, high-performance dynamic language for technical computing."
icon     = "SimpleIcons:julia"
executables   = ["julia"]

[dotfiles]

# https://docs.julialang.org/en/v1/manual/command-line-interface/ — "If you have
# code that you want executed whenever Julia is run, you can put it in
# ~/.julia/config/startup.jl". The directory above it is the depot
# (JULIA_DEPOT_PATH), which is ~/.julia when the variable is unset.
paths = ["~/.julia/config/startup.jl"]

# The rest of the depot is downloaded and generated content — installed
# packages, precompiled images, cloned registries, artifacts, the REPL history —
# so nothing under it is listed as config in the first place.
exclude = []

# A startup file is Julia code. Nothing Julia writes here is a credential.
secret = []

# Read once at the start of each Julia session.
side_effect = false

# No machine_lines: a startup.jl is the user's REPL setup, which is what they
# want on every machine.

[commands]
format = 1
label = "Run Julia"
description = "Run a script or expression with Julia, choosing project, threads and startup behaviour. Compiler, output-generation and debug options are left out."
quality = "ai-draft"
base = "fig:julia"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

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

[[commands.field]]
id = "script"
label = "Script"
type = "path"
description = "Julia file to run; leave empty for the REPL."
path = { kind = "file", role = "input" }
position = 0
sources = ["fig"]

[[commands.field]]
id = "eval"
label = "Evaluate expression"
type = "string"
option = ["--eval", "-e"]
description = "Evaluate the given expression."
sources = ["fig"]

[[commands.field]]
id = "print"
label = "Evaluate and print"
type = "string"
option = ["--print", "-E"]
description = "Evaluate the expression and display the result."
sources = ["fig"]

[[commands.field]]
id = "project"
label = "Project directory"
type = "string"
option = ["--project"]
description = "Set the home project/environment, e.g. @. for the current one."
suggestions = [{ value = "@.", label = "Current directory" }]
sources = ["fig"]

[[commands.field]]
id = "threads"
label = "Threads"
type = "string"
option = ["--threads", "-t"]
description = "Number of threads, or auto."
suggestions = [{ value = "auto", label = "Auto" }]
sources = ["fig"]

[[commands.field]]
id = "procs"
label = "Worker processes"
type = "string"
option = ["--procs", "-p"]
description = "Number of additional local worker processes, or auto."
suggestions = [{ value = "auto", label = "Auto" }]
sources = ["fig"]

[[commands.field]]
id = "load"
label = "Preload file"
type = "path"
option = ["--load", "-L"]
description = "Load the given file immediately on all processors."
path = { kind = "file", role = "input" }
sources = ["fig"]

[[commands.field]]
id = "interactive"
label = "Interactive"
type = "boolean"
option = ["-i"]
description = "Interactive mode: the REPL runs after the script."
sources = ["fig"]

[[commands.field]]
id = "quiet"
label = "Quiet startup"
type = "boolean"
option = ["--quiet", "-q"]
description = "No banner, suppress REPL warnings."
sources = ["fig"]

[[commands.field]]
id = "startup_file"
label = "Load startup.jl"
type = "enum"
option = ["--startup-file"]
description = "Load ~/.julia/config/startup.jl."
choices = [{ value = "yes", label = "Yes" }, { value = "no", label = "No" }]
sources = ["fig"]

[[commands.task]]
id = "script"
label = "Run a script"
fields = ["script", "project", "threads", "quiet"]
required = ["script"]

[[commands.task]]
id = "eval"
label = "Evaluate an expression"
fields = ["print", "project", "threads", "quiet"]
required = ["print"]

[[commands.task]]
id = "repl"
label = "Start the REPL"
fields = ["project", "threads", "startup_file"]
required = []

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["script", "eval", "print", "project", "threads", "quiet"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["load", "procs", "interactive", "startup_file"]