id       = "sccache"
name     = "sccache"
homepage = "https://github.com/mozilla/sccache"
description = "A ccache-like tool for caching compiler artifacts in local or remote storage."
executables   = ["sccache"]

[dotfiles]

# https://github.com/mozilla/sccache/blob/main/docs/DistributedQuickstart.md
# — the official client configuration locations are ~/.config/sccache/config on
# Linux, ~/Library/Application Support/Mozilla.sccache/config on macOS, and
# %APPDATA%/Mozilla/sccache/config/config on Windows.
paths = [
  "~/.config/sccache/config",
  "~/Library/Application Support/Mozilla.sccache/config",
  "%APPDATA%/Mozilla/sccache/config/config",
]
secret = []
side_effect = false

[commands]
format = 1
label = "sccache server and statistics"
description = "Show or reset cache statistics and start or stop the background server. Distributed-compilation and wrapped-compiler use 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/unstable/sccache/sccache.1.en.html"
revision = "0.17.0"
evidence = """
-s, --show-stats  show cache statistics
--show-adv-stats  show advanced cache statistics
--start-server  start background server
--stop-server  stop background server
-z, --zero-stats  zero statistics counters
--stats-format <FMT>  set output format of statistics [default: text] [possible values: text, json]
"""

[[commands.field]]
id = "show_stats"
label = "Show statistics"
type = "boolean"
option = ["--show-stats", "-s"]
sources = ["man"]

[[commands.field]]
id = "show_adv_stats"
label = "Show advanced statistics"
type = "boolean"
option = ["--show-adv-stats"]
sources = ["man"]

[[commands.field]]
id = "stats_format"
label = "Statistics format"
type = "enum"
option = ["--stats-format"]
choices = [{ value = "text", label = "Text" }, { value = "json", label = "JSON" }]
observed_default = "text"
sources = ["man"]

[[commands.field]]
id = "zero_stats"
label = "Zero statistics counters"
type = "boolean"
option = ["--zero-stats", "-z"]
effect = "overwrite"
sources = ["man"]

[[commands.field]]
id = "start_server"
label = "Start background server"
type = "boolean"
option = ["--start-server"]
sources = ["man"]

[[commands.field]]
id = "stop_server"
label = "Stop background server"
type = "boolean"
option = ["--stop-server"]
sources = ["man"]

[[commands.task]]
id = "stats"
label = "Show statistics"
set = { show_stats = [true] }
lock = ["show_stats"]
fields = ["show_stats", "stats_format"]
required = ["show_stats"]

[[commands.task]]
id = "start"
label = "Start server"
set = { start_server = [true] }
lock = ["start_server"]
fields = ["start_server"]
required = ["start_server"]

[[commands.task]]
id = "stop"
label = "Stop server"
set = { stop_server = [true] }
lock = ["stop_server"]
fields = ["stop_server"]
required = ["stop_server"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["show_stats", "stats_format", "start_server", "stop_server"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["show_adv_stats", "zero_stats"]