Converts bin file to diffable text and starts `code --diff`
npm install 0xdiffZero dependency CLI tool to diff binary files.
npm i -g 0xdiff
0xdiff 1.0.1
Converts bin file to diffable text and starts Usage: 0xdiff [options]
Options
-b --bytes-per-row [1, 2, 4, (8), 16, 32, 64].
-s --max-size MB max file size for compare(1).
-k --keep Do not discard temp files on exit.
-d --debug Displays value for each hex row.
-e --endianness Only used with -d (little)
-h --help Display this help text.
Git Diff
The cli tool does not feature git diffs natively at this point.
You can utilize the command to achieve this for now.
`bash
git cat-file -p : > .tmp \
&& 0xdiff .tmp \
&& rm .tmp
`Append it as a shell function in your .bashrc:
bash
gitxdiff() {
sha="${@: -2:1}"
file="${@: -1}"
opts="${@:1:$#-2}"
git cat-file -p $sha:$file > $file.tmp \
&& 0xdiff $opts $file.tmp $file \
&& rm $file.tmp
}
`$3
Git diff between checked in file and local changes:
####
Options
$3
Use this option to change how to diff your binary data.####
####
$3
OBS❗
This application was developed with _small_ binary files in mind, which is why
the hacky solution of using the text diff tool works.
Converting binary files to utf-8 text files like this effectively makes them 300%
larger in size.
Doing on large files consumes a lot of processing and memory resources,
specially if there are also many changes which is often the case with binary files.The
--max-size is an override to the 1MB precautionary max size.You can increase the amount of time that vscode will compute the diff with the
following vscode setting:
`jsonc
{
// Timeout in milliseconds after which diff computation is cancelled. Use 0 for no timeout.
"diffEditor.maxComputationTime": 5000
}
`$3
If you want to debug the value of each row.
Note that the of the chosen debug format can not be greater than the bits
represented on each row, as set with the --bytes-per-row option, see table.| format | -b |
| --------- | ---: |
| BigInt64 | 8 |
| BigUInt64 | 8 |
| Double | 8 |
| Float | 4 |
| Int16 | 2 |
| Int32 | 4 |
| UInt16 | 2 |
| UInt32 | 4 |
#### --debug Float
#### --debug Int16
$3
This option is only used with the --debug option.
If you are working with binary files you probably know what to do with this option.$3
Stop 0xdiff` from removing the temporary files when exiting.