id = "tmutil"
name = "tmutil"
description = "Time Machine utility for macOS."
executables = ["tmutil"]
platforms = ["macos"]

[commands]
format = 1
label = "Time Machine"
description = "Start backups, list backups and manage exclusions and local snapshots. Destination setup and restore are left out."
quality = "ai-draft"
base = "fig:tmutil"
parser = { end_of_options = "--", interleave = "permute", long_equals = false, short_attached = true, short_bundles = false }

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

[[commands.subcommand]]
path = ["startbackup"]
label = "Start a backup"

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

[[commands.subcommand.field]]
id = "auto"
label = "Scheduled-like mode"
type = "boolean"
option = ["--auto", "-a"]
sources = ["fig"]

[[commands.subcommand.field]]
id = "block"
label = "Wait until finished"
type = "boolean"
option = ["--block", "-b"]
sources = ["fig"]

[[commands.subcommand.field]]
id = "rotation"
label = "Allow destination rotation"
type = "boolean"
option = ["--rotation", "-r"]
sources = ["fig"]

[[commands.subcommand.field]]
id = "destination"
label = "Destination ID"
type = "string"
option = ["--destination", "-d"]
sources = ["fig"]

[[commands.subcommand.task]]
id = "backup"
label = "Back up now"
fields = ["block", "destination"]
required = []

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["block", "auto", "rotation", "destination"]

[[commands.subcommand]]
path = ["listbackups"]
label = "List backups"

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

[[commands.subcommand.field]]
id = "destination"
label = "Destination volume"
type = "string"
option = ["-d"]
sources = ["fig"]

[[commands.subcommand.field]]
id = "mount"
label = "Mount backups"
type = "boolean"
option = ["-m"]
sources = ["fig"]

[[commands.subcommand.field]]
id = "timestamps"
label = "Timestamps only"
type = "boolean"
option = ["-t"]
sources = ["fig"]

[[commands.subcommand.task]]
id = "list"
label = "List backups"
fields = ["destination", "timestamps"]
required = []

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["destination", "mount", "timestamps"]

[[commands.subcommand]]
path = ["addexclusion"]
label = "Exclude from backups"

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

[[commands.subcommand.field]]
id = "items"
label = "Items"
type = "path"
position = 0
multiple = true
path = { kind = "any", role = "input", must_exist = true }
sources = ["fig"]

[[commands.subcommand.field]]
id = "fixed_path"
label = "Fixed-path exclusion"
type = "boolean"
option = ["-p"]
description = "Requires root."
sources = ["fig"]

[[commands.subcommand.field]]
id = "volume"
label = "Volume exclusion"
type = "boolean"
option = ["-v"]
sources = ["fig"]

[[commands.subcommand.task]]
id = "exclude"
label = "Exclude items"
fields = ["items", "fixed_path"]
required = ["items"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["items", "fixed_path", "volume"]

[[commands.subcommand]]
path = ["isexcluded"]
label = "Check exclusion"

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

[[commands.subcommand.field]]
id = "items"
label = "Items"
type = "path"
position = 0
multiple = true
path = { kind = "any", role = "input", must_exist = true }
sources = ["fig"]

[[commands.subcommand.task]]
id = "check"
label = "Check items"
fields = ["items"]
required = ["items"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["items"]

[[commands.subcommand]]
path = ["listlocalsnapshots"]
label = "List local snapshots"

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

[[commands.subcommand.field]]
id = "mount"
label = "Mount point"
type = "path"
position = 0
path = { kind = "directory", role = "input", must_exist = true }
sources = ["fig"]

[[commands.subcommand.task]]
id = "list"
label = "List snapshots"
fields = ["mount"]
required = ["mount"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["mount"]

[[commands.subcommand]]
path = ["deletelocalsnapshots"]
label = "Delete local snapshots"

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

[[commands.subcommand.field]]
id = "target"
label = "Mount point or snapshot date"
type = "string"
position = 0
effect = "delete"
description = "Deletes local snapshots."
sources = ["fig"]

[[commands.subcommand.task]]
id = "delete"
label = "Delete snapshots"
fields = ["target"]
required = ["target"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["target"]