IF Commons GitHub

diff

verbread

Show how two files differ, as a unified diff; the exit says whether they do.

Program anyfs-reader. Origin anyfs.

Governance: the action

What the verb is and may do, as governance says it. Each annotation is expressed by the surfaces or says why it is not.

PropertyValue
kindreport
effectread
idempotenttrue
audienceboth
tierreader
dryRunfalse
checkfalse
reachChannelslocal, ssh, mcp, rest
reachReadOnlytrue
reachNeedsTtyfalse
reachRunsAscaller
reachConfirmationnone

Operands

OperandMeaning
AThe first file.
BThe second file.

Options

OptionMeaningProperties
--explainSay how the store would carry the operation out (native, emulated or refused), and do nothing else.type=flag, required=false, standard=false, humanOnly=false, negatable=false, default=false
--strictStop where the store carries an operation out by a means that can lose or change what you meant.type=flag, required=false, standard=false, humanOnly=false, negatable=false, default=false
--jsonWrite one JSON document and nothing else for a person.type=flag, required=false, standard=true, humanOnly=false, negatable=false, default=false
--sarifWrite the findings as SARIF 2.1.0 and nothing else.type=flag, required=false, standard=true, humanOnly=false, negatable=false, default=false
--quietShow only how it ended.type=flag, short=q, required=false, standard=true, humanOnly=false, negatable=false, default=false
--verboseShow every step as it happens.type=flag, short=v, required=false, standard=true, humanOnly=false, negatable=false, default=false
--colorUse colour where the terminal shows it (--no-color turns it off).type=flag, required=false, standard=true, humanOnly=false, negatable=true, default=true
--non-interactiveNever ask a question: where one is needed, fail and say so.type=flag, required=false, standard=true, humanOnly=false, negatable=false, default=false
--onRun it on these targets instead of here: ids joined by commas, `class:<class>` or `all`.type=value, required=false, standard=true, humanOnly=false, valueName=VALUE

Examples

anyfs diff fleet:/a.json ./a.json  # How the file in the store differs from the local one.

Physical: what it is drawn as

anyfs diff

cli-command. Show how two files differ, as a unified diff; the exit says whether they do.

PropertyValue
usageanyfs diff
wordsdiff
tierreader

anyfs_diff

mcp-tool. Show how two files differ, as a unified diff; the exit says whether they do. (report, effect read, safe to repeat.)

PropertyValue
titleanyfs diff
toolNameanyfs_diff
readOnlyHinttrue
destructiveHintfalse
idempotentHinttrue
inputsexplain, strict, A, B
requiredA, B
tierreader

GET /v1/diff

rest-route. Show how two files differ, as a unified diff; the exit says whether they do.

PropertyValue
methodGET
path/v1/diff
operationIdanyfs_diff
effectread
tierreader
idempotenttrue

Titles, headings, exports, tables, columns and requirements. Esc closes.