id = "gource"
name = "Gource"
description = "OpenGL-based 3D visualisation of source control history."
homepage = "https://gource.io"
executables = ["gource"]

[commands]
format = 1
label = "Visualise repository history"
description = "Play back a repository log as an animated tree. Colour, font and caption options are left out."
quality = "ai-draft"
base = "fig:gource"
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/gource.ts"
license = "MIT"

[[commands.field]]
id = "path"
label = "Repository or log"
description = "A version control directory, a log file or - for STDIN. Leave empty for the current directory."
type = "path"
position = 0
path = { kind = "any", role = "input" }
sources = ["fig"]

[[commands.field]]
id = "viewport"
label = "Viewport size"
type = "string"
option = ["--viewport"]
suggestions = [{ value = "1920x1080", label = "1080p" }, { value = "1280x720", label = "720p" }, { value = "2560x1440", label = "1440p" }, { value = "3840x2160", label = "4K" }]
sources = ["fig"]

[[commands.field]]
id = "fullscreen"
label = "Fullscreen"
type = "boolean"
option = ["-f"]
sources = ["fig"]

[[commands.field]]
id = "title"
label = "Title"
type = "string"
option = ["--title"]
sources = ["fig"]

[[commands.field]]
id = "seconds_per_day"
label = "Seconds per day"
description = "Speed of simulation."
type = "string"
option = ["--seconds-per-day", "-s"]
sources = ["fig"]

[[commands.field]]
id = "start_date"
label = "Start date"
description = "YYYY-MM-DD, optionally with time."
type = "string"
option = ["--start-date"]
sources = ["fig"]

[[commands.field]]
id = "stop_date"
label = "Stop date"
type = "string"
option = ["--stop-date"]
sources = ["fig"]

[[commands.field]]
id = "stop_at_end"
label = "Stop at end of log"
type = "boolean"
option = ["--stop-at-end"]
sources = ["fig"]

[[commands.field]]
id = "key"
label = "Show file extension key"
type = "boolean"
option = ["--key"]
sources = ["fig"]

[[commands.field]]
id = "highlight_users"
label = "Highlight all users"
type = "boolean"
option = ["--highlight-users"]
sources = ["fig"]

[[commands.field]]
id = "hide"
label = "Hide elements"
description = "Comma-separated: bloom,date,dirnames,files,filenames,mouse,progress,root,tree,users,usernames."
type = "string"
option = ["--hide"]
sources = ["fig"]

[[commands.field]]
id = "camera_mode"
label = "Camera mode"
type = "string"
option = ["--camera-mode"]
suggestions = [{ value = "overview", label = "Overview" }, { value = "track", label = "Track" }]
sources = ["fig"]

[[commands.field]]
id = "output"
label = "Output PPM stream"
description = "Write a PPM image stream to a file (- for STDOUT)."
type = "path"
option = ["--output-ppm-stream", "-o"]
path = { kind = "file", role = "output" }
effect = "overwrite"
sources = ["fig"]

[[commands.field]]
id = "framerate"
label = "Output framerate"
type = "string"
option = ["--output-framerate", "-r"]
suggestions = [{ value = "25", label = "25" }, { value = "30", label = "30" }, { value = "60", label = "60" }]
sources = ["fig"]

[[commands.task]]
id = "play"
label = "Play current repository"
fields = ["viewport", "seconds_per_day", "title"]

[[commands.task]]
id = "record"
label = "Render to PPM stream"
fields = ["path", "output", "framerate", "viewport"]
required = ["output"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["path", "viewport", "fullscreen", "title", "seconds_per_day"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["start_date", "stop_date", "stop_at_end", "key", "highlight_users", "hide", "camera_mode", "output", "framerate"]