Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

The settings file

--settings FILE reads settings from a JSON file. prove, check, interact, eliminate, seq print and the workspace commands that run take it. The file holds the same settings the flags set, in the form a front end keeps (the library's Settings).

What the file holds

The file is a JSON object with any of these keys:

keyholds
clockthe time limits, and when a pool of threads joins the search
limitsthe resources a call may use, such as memory and the sequent's size
searchthe search's options
viewhow a derivation is shown
stylesthe options of every output format, as --style-file holds them
batchhow a batch shares the machine, and its entries' mode
ordinaryhow ordinary logic is decided
interactivehow a session takes steps of its own
inputhow the input is read
cuthow cut elimination proceeds and when it stops
lambdahow a lambda-term is printed

Each key holds the fields the flags set. A flag's --help names its field in parentheses: --copies sets search.copies, --timeout sets clock.time_limit_ms, and --memory-limit sets limits.memory_bytes. null lifts a bound, as none does on the command line: {"limits": {"memory_bytes": null}}. A key or field deduxit does not know is an error.

The file is read whole, up to 16 MiB, and never from standard input, which carries the sequent.

A workspace has bounds of its own under limits.workspace: nodes (1 024 by default), records, the runs it keeps (4 096), log, the edits undo keeps (256), and bytes, the bytes of its values (64 MiB). Past the edits kept, the oldest is forgotten; past any other bound, the change is refused.

How the file and the flags combine

  • A field the file leaves out keeps the command's default.
  • A flag given on the command line overrides the file. A flag that is not given leaves the file's value as it is.
  • A flag that only switches something on or off one way (--no-check, the mode flags) cannot undo the file's value: change the file instead.
  • batch.mode is the mode of a batch's entries that name none, as the mode flags set it. A mode flag given on the command line overrides it.
  • ordinary applies only under --logic, which names the logic. The file's ordinary.logic is not read: the settings a front end keeps always hold one, which would make every input ordinary logic. The file's ordinary.translation is the translation unless --translation names one.

Example

$ echo '{"search": {"copies": 0, "engine": "focus"}}' > settings.json
$ deduxit prove --settings settings.json "|- ?(~a * ~a), a * a * a * a"
unknown (MELL, classical, focus engine): the copy bound of 0 was reached after 300.39µs; raise it with --copies N, or lift it with --copies none to deepen it while the time limit lasts
$ deduxit prove --settings settings.json --copies 3 "|- ?(~a * ~a), a * a * a * a"
unprovable (MELL, classical, focus engine): the search was exhaustive