Home / Docs / Command line

una fix

Release v0.4.0

Apply the mechanical repairs of una check, then format, and report what remains.

text
una fix [OPTIONS] [PATH]

Examples

sh
una fix .

Apply the repairs that need no decision, format, and report what remains.

Arguments

Argument What it does Default
[PATH] The package directory, or a single file .

Options

Option What it does Default
--json Print machine output as JSON on stdout, and nothing else on stdout
--tier <TIER> The tier of the final check: 0 skips the solver, 1 also proves every obligation. Values: 0: Tier 0: every check except proof obligations; 1: Tier 1: tier 0 and every proof obligation. 1
--color <WHEN> When to use colors in human output. Values: never: Never use colors; auto: Use colors when the output is a terminal; always: Always use colors. auto
--dry-run Report what would be applied, and write no file
--solver-wallclock <SECONDS> Stop a solver query after this many seconds; the obligation is then unknown 60
--solver-memory <MIB> The memory limit of each solver query in MiB, from 256 to 1048576 4096

Specification

The normative rules, from spec/13 §5:

Command Meaning
una fix [path] (v0.2, ADR 0084) Apply the mechanical repairs that una check reports, then format; --dry-run writes nothing; --tier 0 skips the solver in the final check

Help text

As una fix --help prints it at v0.4.0:

text
Apply the mechanical repairs of `una check`, then format, and report what remains

Usage: una fix [OPTIONS] [PATH]

Arguments:
  [PATH]
          The package directory, or a single file

          [default: .]

Options:
      --json
          Print machine output as JSON on stdout, and nothing else on stdout

      --tier <TIER>
          The tier of the final check: 0 skips the solver, 1 also proves every obligation

          Possible values:
          - 0: Tier 0: every check except proof obligations
          - 1: Tier 1: tier 0 and every proof obligation

          [default: 1]

      --color <WHEN>
          When to use colors in human output

          Possible values:
          - never:  Never use colors
          - auto:   Use colors when the output is a terminal
          - always: Always use colors

          [default: auto]

      --dry-run
          Report what would be applied, and write no file

      --solver-wallclock <SECONDS>
          Stop a solver query after this many seconds; the obligation is then unknown

          [default: 60]

      --solver-memory <MIB>
          The memory limit of each solver query in MiB, from 256 to 1048576 (ADR 0124)

          [default: 4096]

  -h, --help
          Print help (see a summary with '-h')
View the Markdown